Try it free

Configure SSL certificate for Managed Cluster

  • How-to guide
  • 3-min read

To use your own SSL certificate instead of the default one, follow the steps below.

Step 1 Prepare the certificate files

By default, Dynatrace manages SSL for you, and each Managed Cluster receives a dedicated subdomain of dynatrace-managed.com with a trusted SSL certificate. As of April 17, 2025, Chinese regulations require an Internet Content Provider certification for all publicly accessible services using the dynatrace-managed.com domain. Since Dynatrace holds no Internet Content Provider certificate due to the lack of a legal entity in China, the affected domains have been blocked by local network providers. To maintain monitoring capabilities, follow these recommendations:

  • Use internal DNS or IP addresses for Cluster ActiveGate endpoints.
  • Avoid exposing the Dynatrace UI or endpoints to public Chinese networks.
  1. Collect the SSL certificate and key files you received from your certificate authority:

    • Server certificate (.cer or .cert)
    • Root and intermediate certificates (.cer or .cert)
    • Private key (.pem)
  2. If your private key is encrypted, decrypt it:

    openssl rsa -in encrypted.ssl.key -out decrypted.ssl.key
    • encrypted.ssl.key: your encrypted SSL private key file
    • decrypted.ssl.key: the output file for the decrypted key

    The command prompts you for the password and saves the decrypted key.

    Encrypted private keys

    Encrypted private keys are not supported.

Step 2 Disable automatic certificate management

  1. Sign in to the Cluster Management Console.

  2. Go to Settings > Preferences and turn off Manage domain name and SSL certificates.

    Without automatic certificate management, Dynatrace falls back to a self-signed certificate, which browsers don't trust by default.

  3. Accept the security exception in your browser when it warns about the self-signed certificate.

Step 3 Upload your certificate

Name-mismatch error

Your certificate is tied to a specific hostname. To avoid a name-mismatch error, make sure the common name (domain name) in the certificate matches the address shown in the browser's address bar.

  1. Sign in to the Cluster Management Console.

  2. On the Home page, select the Cluster node that needs the new certificate.

  3. On the Node Details page, select Edit SSL certificate.

  4. Paste or upload the key files you received from your certificate authority.

    • Private key: your private key.
    • Public key certificate: your server certificate.
    • Certificate chain: your root and intermediate certificates.

    All keys and certificates must be in PEM format with full BEGIN and END headers.

    Key format:

    -----BEGIN PRIVATE KEY-----
    (Private Key)
    -----END PRIVATE KEY-----

    Certificate format:

    -----BEGIN CERTIFICATE-----
    (SSL Certificate)
    -----END CERTIFICATE-----
  5. Select Save to upload the certificates.

    Dynatrace applies the certificate in the background, without restarting the node. To confirm, reload the page and check that Issuer, Subject, and Expires show your certificate. If the page shows Server restart is required, restart the node.