Skip to main content

Import certificates and keys for integrations

Some integrations require you to upload keys or certificates that are used to authenticate and verify parties when establishing the connection. You can use the Import certificates and keys tool for this purpose.

To use the tool, go to Tools → Administer → Import certificates and keys.

import_certificates_and_keys.png

The tool allows you to manage keys and certificates:

  • View details about keys and certificates that are already imported.

  • Rename keys and certificates.

  • Delete keys and certificates.

  • Upload new keys and certificates in various formats.

Viewing, renaming and deleting keys and certificates

The upper part of the screen lists the existing keys and certificates with details:

  • Type – Entry type: a key or a certificate.

  • Alias – The name of the key or the certificate.

  • Expiry – The expiration date defined for the key or certificate.

  • Subject DN – Distinguished name, the information about the key or certificate from the owner's point of view.

  • Issuer DN – The information about the key or certificate from the issuer's point of view.

To delete a key or a certificate, click the trash can icon in the corresponding row.

To rename a key or certificate, click the pencil icon in the corresponding row and enter a new name.

After you made any changes, click Save and close. No changes are saved before you click this button, so in case you accidentally made a mistake, you can close the window with the Cancel button.

Importing keys and certificates

The lower part of the screen contains everything you need to import new keys and certificates. The supported formats are:

  • Java KeyStores in the PKCS12 format (.p12 or .pfx file extensions).

  • Certificates in the X.509 format (.cer, .cert or .p7b file extensions).

  • Private keys in the PEM or DER format (.key, .der, .pem, .pkcs8 or .pk8 file extensions)

    • Note that you need to import the certificates in the certificate chain of the private key at the same time using the supported formats for certificates.

To import certificates or keys:

  1. Click Choose file and select the file to upload from your computer.

  2. Click Upload.

  3. If the private key or keystore is protected by a passphrase, type it in the Passphrase field.

  4. If you import individual keys or certificates, type in an Alias to use.

  5. Click Import files.

  6. Click Save and close. No changes are saved before you click this button, so in case you accidentally made a mistake, you can close the window with the Cancel button.