To use your own SSL certificate instead of the default one, follow the steps below.
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:
Collect the SSL certificate and key files you received from your certificate authority:
.cer or .cert).cer or .cert).pem)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 filedecrypted.ssl.key: the output file for the decrypted keyThe command prompts you for the password and saves the decrypted key.
Encrypted private keys are not supported.
Sign in to the Cluster Management Console.
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.
Accept the security exception in your browser when it warns about the self-signed certificate.
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.
Sign in to the Cluster Management Console.
On the Home page, select the Cluster node that needs the new certificate.
On the Node Details page, select Edit SSL certificate.
Paste or upload the key files you received from your certificate authority.
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-----
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.