Access Keys:
Skip to content (Access Key - 0)

Dorian


Request a Host Certificate


To ensure security, the container hosting the services must run with a host credential. A host credential consists of an X.509 certificate and private key. Dorian provides a means for users with a grid user account to request a host credential for their services. To request a host credential:

  1. Configure your target Grid.
  2. Launch the GAARDS UI.
  3. Login to the Grid with your user account.
  4. From the MyAccount menu, select Request a Host Certificate. This will launch the Request a Host Certificate window.
  5. From the Service drop-down menu, select the elect the Dorian you wish to request a host certificate from.
  6. In the Host text box, enter the name of the host for which you are requesting host credentials.
  7. Next you must specify the directory on the file system to which the host credentials should be written. Click the Browse button.
  8. Click the Request Certificate button.

Immediately after clicking the Request Certificate button, the GAARDS UI will submit the host certificate request to Dorian. Upon receiving the request, Dorian will either immediately approve the request or submit the request to an administrator for approval. In the case of the former, the host credentials (certificate and private key) will be written to the directory specified. The file containing the certificate will be named THE_HOSTNAME_YOU_ENTERED-cert.pem. The file containing the private key will be named THE_HOSTNAME_YOU_ENTERED-key.pem.

If the host certificate request requires approval of an administrator, the file containing the private key will be named THE_HOSTNAME_YOU_ENTERED-key.pem. The host certificate will not be written since it is not issued until the request is approved. The GAARDS Admin UI provides a means to check the status of your host certificates request(s). To check the status of a host certificate request:

  1. Launch the GAARDS UI.
  2. If you have not done so, login to the Grid with your user account.
  3. From the MyAccount menu, select My Host Certificates. This will launch the My Host Certificates window.
  4. From the Service drop-down menu, select the Grid for which you wish to view the host certificates associated with your account.
  5. Click the Search button.

The host certificates that you requested will appear in the table below the Search button. Locate the certificate that you wish to check the status of. If the status is Pending then an administrator has not yet reviewed your request. If the status is Rejected than an administrator has rejected your request and a host certificate WILL NOT be issued. If the status if Active then an administrator has approved you request and a host certificate was issued.

You may download the host certificate by selecting the host certificate in the table and by clicking the View Certificate button. This will launch a window containing the details of your host certificate. You may save the certificate to the file system by clicking the Save Certificate button. We recommend saving the host certificate in the directory you specified when you requested in a file named, THE_HOSTNAME_YOU_ENTERED-cert.pem. Once saved you should have the private key file in the same directory in a file named, THE_HOSTNAME_YOU_ENTERED-key.pem. The private key and certificate make up a host credential.

Last edited by
Sarah Honacki (492 days ago) , ...
Adaptavist Theme Builder Powered by Atlassian Confluence