Manage the Certificates

You must update the ActivID AS certificates before they expire to avoid an interruption of service.

Update the CA Certificates in the Application Server SSL Truststore

The application server SSL Truststore must be configured to trust the local or remote ActivID Authentication Server.

When creating an application profile, a default signer server certificate is created and added by default into the SSL Truststore. This signer certificate is then used to sign the SSL server certificate.

It is recommended to replace this certificate with a custom CA-signed SSL certificate.

For a successful SSL handshake between the application server and the HID Approve™ mobile app, this SSL server certificate must meet the following requirements:

  • Issued by a CA whose root certificate is incorporated into the mobile device operating system or issued by a trusted root CA installed by the user on the mobile device.
  • Signed with 2048-bits RSA key or 256-bits ECC key at a minimum.
  • Have a SHA-2 hash algorithm with a SHA-256 fingerprint at minimum.
  • Used with TLS 1.2 connection with either the AES-128 or AES-256 symmetric ciphers, and with a cipher suite supporting PFS through ECDHE key exchange.

The root CA certificate (of the custom CA-signed SSL certificate) or the self-signed SSL certificate of the ActivID Authentication Server should be added explicitly into the local SSL Truststore if:

  • The ActivID Authentication Server is installed remotely.
  • A custom CA-signed SSL server certificate is used.
Note:  
  • If a custom CA-signed SSL certificate is used, only the root CA certificate needs to be added to the truststore.
  • If you use PKI login method to log on the ActivID Management Console, you must also import the user's Certificate Root CA into the SSL truststore of the application server. If this step is skipped, you will not be prompted to select the user's certificate at logon.
  1. Log on to the WebSphere administration console.
  2. In the navigation pane, expand the Security node and click SSL certificate and key management.
  3. Under Related Items, click Key stores and certificates, and then click the NodeDefaultTrustStore link.
  4. Under Additional Properties, click Signer certificates.
  5. Click Add to import the root CA certificate, or use the Retrieve from port option.
  6. Test the SSL connection with the remote ActivID Authentication Server and import the signer certificate.
  1. Import the SSL certificate root CA into the truststore (or the SSL server certificate if self-signed) using the following command:
Copy 
<JAVA_HOME>/bin/keytool -importcert -noprompt -trustcacerts -keystore <SSL_SERVER_TRUSTSTORE_FILE_PATH> -alias CAROOT -file /tmp/CAROOT.cer
Note: This command also creates the truststore if necessary.
  1. At the prompt, enter the truststore password to protect the truststore.

Update the ActivID Authentication Portal SAML Certificates

There is one SAML IDP signing certificate and one SAML IDP encryption certificate per security domain.

These certificates are stored in the ActivID Authentication server software keystore (<ACTIVID_HOME>/ActivID_AS/config/ActivID.keystore) under the idp_cert_signature_<domain> and idp_cert_ encryption_<domain> aliases.

Note: You can view or download the ActivID IDP certificates in the ActivID Management Console.

Renew SAML IDP (Authentication Portal) Keys and Certificates

  1. As ftadmin, run the following command:

    Copy 
    <ACTIVID_HOME>/ActivID_AS/bin/configureIDPData.sh -c createkeyscerts -d <domain name> -v <validity period (years)>

  2. When prompted, enter the keystore password.

  3. Replicate the keystore changes to all the ActivID AS servers in your deployment.

  4. Restart the server.

  5. Export the IDP metadata and reconfigure the service providers.

Replace the Certificates with CA Signed Certificates

For the the idp_cert_signature_<domain> and idp_cert_ encryption_<domain> keystore entry aliases, as ftadmin, use the following commands:

  1. To load the environmental variable:

    Copy 
    . <ACTIVID_HOME>/ActivID_AS/bin/envdef

  1. To generate the Certificate Signing Request:

    Copy 
    keytool –keystore <the keystore> –certreq –alias <alias> –keyalg rsa 
    –file client.csr -storetype JCEKS

  1. To send the CSR to your Certificate Authority and then import CA certificate into the ActivID AS keystore:

    Copy 
    keytool -import -keystore <the keystore> -file ca-certificate.pem  
    -alias theCARoot -storetype JCEKS

  1. To import the signed certificate in the keystore:

    Copy 
    keytool –import –keystore <the keystore> –file <CA signed IDP certificate> –alias <alias> -storetype JCEKS

  1. Replicate the keystore changes to all the ActivID AS servers in your deployment.

  2. Restart the server.

  3. Export the IDP metadata and reconfigure the service providers.