Managing certificates for connecting to the Sandbox server

Managing certificates requires the rights of a user with the Administrator (admin) role.

You can manage certificates used to connect to the OSMP servers or Central Node servers responsible for interaction with Sandbox (hereinafter also referred to as Sandbox servers) using commands. You can do the following with certificates:

• Add or replace the server certificate
• Display information about the server certificate
• Remove the server certificate
• Add or replace the client certificate
• Display information about the client certificate
• Remove the client certificate

To add or replace the server certificate, run the following command:

kesl-control [-X] --add-sandbox-server-certificate <file>

<file> is the path to the file containing the server certificate.

To add or change a client certificate:

1. Execute the command:

   kesl-control [-X] --add-sandbox-client-certificate <file>

   where <file> is the path to the cryptocontainer (PFX archive) containing the client certificate and private key.

2. If the cryptocontainer is password-protected, enter the password when prompted.

The client certificate is used for additional protection of the connection to the Sandbox server if client certificate verification is enabled in the Sandbox server settings and if in the settings of the Sandbox Integration task, UseClientCertificate is set to yes.

To display certificate information, run the following command:

• for the server certificate:

  kesl-control [-X] --query-sandbox-server-certificate

• for the client certificate:

  kesl-control [-X] --query-sandbox-client-certificate

Running the command displays the following certificate information:

• certificate serial number
• certificate subject
• certificate issuer
• certificate start date
• certificate expiration date
• SHA1 and SHA256 certificate fingerprints

To delete the server certificate information, run the following command:

kesl-control [-X] --remove-sandbox-server-certificate

To delete the client certificate information, run the following command:

kesl-control [-X] --remove-sandbox-client-certificate

Page top