SURFsara Handles
Introduction
PHP library to create, edit and delete handles through the handle HTTP
JSON REST API running at SURFsara. More information about the API can be
found at http://www.handle.net/tech_manual/HN_Tech_Manual_8.pdf
(chapter 14)., (*1)
Installation
Install the SURFsara Handles library using Composer., (*2)
$ composer require GravityDesignNL/SURFsara-handles
Usage
In order to use this class to connect to SURFsara you need to have a
private-key file and a certificate file. Check with SURFsara to get the
document to guide you through that process., (*3)
Once you generated the security files you can start using the SURFsara
Handles class to create or delete handles., (*4)
$client = new SURFsaraHandles();
Options
The SURFsara Handles class needs some settings (required and optional)
to make it work properly., (*5)
Key (required) (string)
The absolute path to the private-key file., (*6)
$client->setKey('<path>'));
Certificate (required) (string)
The absolute path to the certificate file., (*7)
$client->setCert('<path>'));
Organisation code (required) (string)
The code SURFsara has given to your organisation., (*8)
$client->setSurfsaraPrefixOrg('<code>'));
Organisation code (required) (string)
The code for the SURFsara environment you will communicate with., (*9)
$client->setSurfsaraPrefixOrg('<env>'));
API Url (required) (string)
The url for the SURFsara API you will communicate with., (*10)
$client->setSurfsaraPrefixEnv('<api>'));
Permissions (required (string))
The permissions needed to create or delete a handle., (*11)
$client->setPermissions('<permissions>'));
Overwrite (optional (string))
Set if you want overwrite an existing handle. Can be either 'true' or 'false'.
Defaults to 'true'., (*12)
$client->setOverwrite('true'));
Verify (optional (boolean))
Set if ... Can be either TRUE or FALSE.
Defaults to FALSE., (*13)
$client->setVerify(FALSE));
Set headers if you need them. Headers are added in an array., (*14)
$client->setHeaders(['Authorization' => 'Handle clientCert="true"']);
Handle Name
Set the handle name. For example a uuid., (*15)
$client->setHandleName('<name>');
Handle Url
Set the base handle url the PID redirects to. For example http://www.example.org/., (*16)
$client->setHandleUrl('<url>');
Handles
When you added all the settings then you can create or update a (new) handle:, (*17)
$client->setHandle();
Or you can delete it:, (*18)
$client->deleteHandle();
Happy handling!!!, (*19)
Wallogit.com
