Skip to main content

Manage certificates

Keep the SSL/TLS certificates of your workspace in one place, see when each one expires, and renew it before it does. Services in the workspace use the certificates you import here: when you create a service that needs a certificate, you pick one from this list in the service's create form.

Prerequisites​

  • The certificate and its private key, both in PEM format.
  • A certificate that has reached its start date, has not expired, and has not been revoked.

View certificates​

  1. Select Data platform → Workspace management, then select your workspace.
  2. Select the Certificate tab.

Certificate tab of a workspace with the Import button and a list of certificates

ColumnDescription
NameThe certificate name. Select it to open the certificate details.
DomainThe domain the certificate applies to.
Used by serviceThe service that uses the certificate.
Updated atWhen the certificate was last updated.

The more icon (⋮) at the end of each row opens Import to renew and Delete. Import to renew is available only when a service uses the certificate.

Import a certificate​

  1. Select Data platform → Workspace management, then select your workspace.
  2. Select the Certificate tab.
  3. Select Import, or Let's get started if the workspace has no certificate yet.
  4. In the Import certificate panel, enter a Name.
  5. Paste the certificate into Certificate content.
  6. Paste the private key into Certificate private key.
  7. Select Import.

Import certificate panel with the Name, Certificate content, and Certificate private key fields

FieldDescription
NameRequired. Letters, numbers, and hyphens only. Must not match the name of an existing certificate.
Certificate contentRequired. The certificate body in PEM format.
Certificate private keyRequired. The certificate's private key in PEM format.

Before it imports the certificate, the portal checks that:

  • Both fields are in valid PEM format.
  • The certificate has reached its start date, has not expired, and has not been revoked.
  • The private key matches the certificate.

Renew a certificate​

Renew a certificate to replace it with a new one. You can renew a certificate only while a service uses it, and the portal applies the new certificate to that service right away.

  1. Select Data platform → Workspace management, then select your workspace.
  2. Select the Certificate tab.
  3. In the certificate's row, select the more icon (⋮), then select Import to renew.
  4. In the Import certificate to renew panel, paste the new certificate into Certificate content.
  5. Paste its private key into Certificate private key.
  6. Select Import & renew.

Import certificate to renew panel with the Name locked and the certificate and private key fields

Name shows the current certificate and cannot be changed. The portal renews the certificate only when:

  • Both fields are in valid PEM format.
  • The new certificate has reached its start date, has not expired, and has not been revoked.
  • The private key matches the certificate.
  • The certificate has not been renewed before.

View certificate details​

  1. Select Data platform → Workspace management, then select your workspace.
  2. Select the Certificate tab.
  3. Select the certificate's Name.

A panel with the certificate's details opens.

Details panel of a certificate with its domain, validity dates, key, serial number, and signature algorithm

FieldDescription
NameThe name you gave the certificate when you imported it.
DomainThe domain or wildcard domain the certificate protects, for example example.com or *.example.com. Check it to make sure the certificate fits the service.
Public key infoThe public key type, for example RSAPublicKey. The key length is not shown.
Valid fromWhen the certificate becomes valid, with the time zone, for example (UTC+07:00).
Valid toWhen the certificate expires. After this time, services that use it can get HTTPS connection errors.
Expires inDays left until Valid to, calculated from the current time. Use it to plan the renewal.
Used by serviceThe services that use the certificate, for example Query Engine. Shown only when at least one service uses the certificate.
Serial numberThe unique serial number, usually issued by the certificate authority (CA). Use it to look up or verify the certificate.
Signature algorithmThe algorithm the certificate is signed with, for example sha256WithRSAEncryption. It affects security and processing speed.
Updated atWhen the certificate was last updated in the portal, usually when it was imported or renewed.

Delete a certificate​

You cannot delete a certificate while a service uses it.

  1. Select Data platform → Workspace management, then select your workspace.
  2. Select the Certificate tab.
  3. In the certificate's row, select the more icon (⋮), then select Delete.
  4. In the Delete Certificate dialog, enter delete, then select Confirm.

Delete Certificate dialog with delete entered in the confirmation field and the Confirm button

If the confirmation field is empty or holds another word, the portal shows an error.

danger

Deleting a certificate cannot be undone.

Next steps​