Using a certificate issued by a trusted certificate authority

Prerequisites

• The certificate file (in the .pem format)
• The file with the private key for the certificate (usually in the .key format)
• [If the key is password-protected] The private key password

To configure the SSL certificate settings

1. Copy the certificate and private key files to the machine on which the management server runs.

2. On this machine, open the following configuration file with a text editor:

   • In Windows: %ProgramData%\Acronis\ApiGateway\api_gateway.json
   • In Linux: /var/lib/Acronis/ApiGateway/api_gateway.json

3. Locate the following section:

   "tls": {
       "cert_file": "cert.pem",
       "key_file": "key.pem",
       "passphrase": "",

4. Between the quotation marks in the "cert_file" line, specify the full path to the certificate file.

   For example:

   • Windows (note the forward slashes):

     "cert_file": "C:/certificate/local-domain.ams.pem"

   • Linux:

     "cert_file": "/home/user/local-domain.ams.pem"

5. Between the quotation marks in the "key_file" line, specify the full path to the private key file.

   For example:

   • Windows (note the forward slashes):

     "key_file": "C:/certificate/private.key"

   • Linux:

     "key_file": "/home/user/private.key"

6. [If the file is password-protected] Between the quotation marks in the "passphrase" line, specify the password.

   For example:

   "passphrase": "my_password"

   If the "passphrase": "", line is missing in your api_gateway.json configuration file, add it manually.

   For example:
   

   "tls": {
       "cert_file": "C:/certificate/local-domain.ams.pem",
       "key_file": "C:/certificate/private.key",
       "passphrase": "my_password",
   }

7. Save the api_gateway.json file.

   Ensure that you do not accidentally delete any commas, brackets, or quotation marks in the configuration file.

8. Restart Acronis Service Manager Service as described below.

To restart Acronis Service Manager Service