Only authenticated users can create handles. Every handle MUST have at least one administrator. Every handle has a handle name and a group of handle values. Every handle value has an index, type, data, TTL (time to live), timestamp, permission set and references.
To create a handle:
Type a new handle in the 'Handle' text box. Press 'Return'. This will check the authentication information. If you have not authenticated yet, an authentication box will pop up. To change the authentication information between handle creations, select 'Setup' from the main Handle Amin Tool menu, then click 'Authentication'.
The 'Add Handle Data' box contains shortcut buttons for quick addition of certain handle types with defaults already set. The 'Add Custom' box is used to add handle values with custom types. Every handle value must have an index to identify it in the handle value group.
Be sure to check the appropriate permissions for the administrator handle. Click the 'More' button to view or modify the type, TTL, timestamp, permissioms, and references related to this handle value.
Select the type (HS_ADMIN, HS_SITE, HS_ALIAS, HS_VLIST, HS_SECKEY, HS_PUBKEY, HS_SERV, EMAIL, URL) in the 'Type' box or input a new one.
The 'Value Data' button inputs the data corresponding to the type.
HS_SITE type data is used to add the site information for prefix handles to indicate where handles with that prefix are resolved. The data value must have an index value which can be any unique number within the handle record data. The data version, protocol and serial number are values that have to do with the current Handle.net software version. Check whether the site is primary and if multiple sites are primary. Choose whether the handle will be hashed by the entire handle, just the prefix, or a local name. Add the IP addresses of the servers that exist in the site. Add attribute value pairs.
HS_ALIAS type data is used to add a handle alias as a handle value.
HS_VLIST type data is used to define administrator groups with a list of other handle values.
HS_SECKEY type data is used to add a secret key as a handle value. Generally, you should check the 'public read permission' off.
HS_PUBKEY type data is used to add a public key as a handle value. Generate key pairs (private key, public key) using the 'Generate Key Pair' button. Load a public key from the file system using the 'Load Key' button then add the public key to the key field. Click the 'Clear' button to clear the key field. Click the 'Ok' button to confirm.
HS_SERV type data is a handle value which has the site information.
This box displays the handle data values being added.
Press the 'Create' button after the addition of all the handle values is complete. This will respond with an indication of success or failure. The absence of an administrator and a handle name is considered a failure.