SpringNet Keyring Tool

From The spring:// Network Documentation
Jump to: navigation, search

Previous | Up | Next

The Keyring tool provides a way of managing the certificates held on the Node. From here you can view stored certificates, import certificates, sign certificates or remove them from the keyring.

Main Page[edit]

Springnet keyring tool 1.png

To access the Main Page you click SpringNet > Keyring. This page displays the list of node certificates stored on your node, with quick overview of contact details and the key ID.

View Certificate[edit]

Springnet keyring tool 2.png

Clicking a Certificate Name from the Main Page will bring up the Certificate View. Here you can see the full details of the certificate -- Name, Contact Email, the Key IDs of the nodes who have signed the certificate (if you have those certificates stored, it will also display the name of the node who signed) and the Public Key of the certificate.

Springnet keyring tool sign 1.png

If you have signed the certificate the option to Make Pull Request will be available. A pull request asks the node, whose certificate you have signed, to pull the updated certificate from your node's keyring. By clicking on it, the request is made and the node will either automatically pull the certificate from you or notify the organisation that a pull request has been made.

Remove Certificate[edit]

Clicking Remove Certificate in the Certificate View will remove the certificate from your Keyring.

Sign Certificate[edit]

Springnet keyring tool 3.png

If you have not signed the certificate being viewed, clicking on Sign Certificate will take you to the Private Key virtual safe. If you are an Administrator you can enter the Passphrase to unlock your Private Key and perform a signing operation. Once complete, your node's signature should be on the certificate.

Note: It is from here you will be able to make a certificate Pull Request with the relevant node in a near-future version of the software

Import Certificate[edit]

Springnet keyring tool 4.png

Clicking on Import from the Main Page will take you to the import page. From here you can import a certificate by pasting in the Public Key and clicking Import. Once successfully imported the certificate is added to you Keyring. If you already have the certificate in the keyring and you are importing an updated certificate, it will update it on your keyring.

If you wish to get a node's certificate for import, enter the URI for the node (e.g. cci.esusx.uk) and click on Request - if the certificate is retrieved from the node it will be automatically placed in the text area, ready for import.

Handling Pull Requests[edit]

If you receive a pull request, and you have set the plugin set to notify you (Settings > SpringNet > Certificate), then you will be shown a notification on the SpringNet overview page. If you have the plugin to automatically accept the pull request then it will not notify you but just pull the update certificate.

Springnet keyring tool 5.png

This is notification is informing you that the specified node (in this case zunautica.esusx.uk) is asking you to make a pull of an updated version of your certificate. Click on the Certificate Pull Request will take you the the pull request decision page.

Springnet keyring tool 6.png

This page (also accessible through Keyring > Pull Requests) shows all the pull requests and an option to Accept or Ignore. Clicking on Accept will pull the certificate from the source of the request and update your certificate. Ignore will just ignore the request.

Previous | Up | Next