Importing a third-party CA certificate and identity certificates simultaneously

Last Updated : Nov 16, 2021 |
Prolog information
Use this procedure to simultaneously import a third-party CA certificate into Certificate Manager trust stores and the associated identity certificates signed by the third-party CA.
Before you begin
  • Obtain the PEM file of the third-party CA.
  • Obtain identity certificate PEM files signed by the third-party CA. Ensure that the name of the PEM files uses the <serviceID>.pem format.
    • To see the contents of a pem file, use the command:
      openssl x509 -in certificate.pem -text
    • To see the contents of a csr file, use the command:
      openssl req -in mycsr.csr -noout -text
  • Determine whether you want to:
    • Use the system-generated default set of trust stores for externally facing interfaces. If you choose this default option, no further action is required.
    • Manually specify the trust stores for external and internal interfaces, the third-party CA certificate is added to. For more information, see Specifying trust stores for adding a third-party CA certificate section in Maintenance and Troubleshooting Avaya Analytics™ guide.
      Tip:
      If you specify identity certificates before generating CSRs, you should also specify trust stores for the third-party CA certificate.
  • The signed identity certificates must have ExtendedKeyUsages of serverAuth and clientAuth. You can check the ExtendedKeyUsages values on the signed identity certificate by running the following command and verifying its output:
    $ openssl x509 -noout -text -in <signed_cert>.pem
    X509v3 Extended Key Usage:
    TLS Web Server Authentication, TLS Web Client Authentication
  1. Log in to Cluster Control Manager.
  2. Transfer the third-party CA PEM file to the /home/<customer account>/<third-party-CA_PEM_filename> directory using a file transfer utility, such as WinSCP.
  3. Transfer the identity certificate PEM files to the /home/<customer_account>/id-cert-files directory using a file transfer utility, such as WinSCP.
  4. Navigate to the /home/<customer_account> directory.
  5. If you are using the default set of trust stores for externally facing interfaces, do the following to import the third-party CA certificate and identity certificate PEM files:
    ADDITIONAL INFORMATION:
    ccm release cert-manager third-party-certs --add-certs --ca-cert-file \
    <third-party-CA_PEM_filename> --id-cert-dir /home/<customer_account>/id-cert-files