Store cluster SSL certificate

The ServiceProviderAPI (Service Provider API) Api-Token scope is required to get the default realm password policy configuration using the Dynatrace API.

Endpoint

/api/v1.0/onpremise/sslCertificate/store

Parameter

Parameter Type Description In Required
entityType string

entity type, possible values = "SERVER, COLLECTOR"

path required
entityId integer

Node ID, which can be extracted from the URL in 'Node details' view.

path required
body sslCertDto body optional

Body format

The sslCertDto object

SSL certificate configuration.

Element Type Description Required
privateKeyEncoded string

Private key PKCS #8 standard, PEM base64-encoded format

required
publicKeyCertificateEncoded string

Certificate X.509 standard, PEM base64-encoded format, server certificate

required
certificateChainEncoded string

Certificate(s) X.509 standard, PEM base64-encoded format, intermediate and root certificates

optional

Response

Response codes

Code Description
200

Successful or in progress

400

Incorrect entity type

500

Internal error

522

Certificate chain is invalid

523

Private key does not match public key certificate

525

Public key certificate is invalid

526

Private key is invalid

527

Error while storing SSL certificate

528

Certificate has been stored but has not been refreshed

529

Internal error

Response body

The CertificateStoreStatus object

Element Type Description
certificateStoreStatus string
detailedError string

Example

In this example, you store the SSL certificate on 32 node of the myManaged.cluster.com cluster. In return you receive information that the SSL certificate was successfully updated. Make sure that your request is in JSON format. This means that the privateKeyEncoded, publicKeyCertificateEncoded and certificateChainEncoded objects are in a single line.

Curl

curl -X POST "https://myManaged.cluster.com/api/v1.0/onpremise/sslCertificate/store/SERVER/32" -H  "accept: application/json" -H  "Content-Type: application/json" -d "{\"privateKeyEncoded\":\"-----BEGIN RSA PRIVATE KEY-----\MIIEow...aHzMvp\-----END RSA PRIVATE KEY-----\",\"publicKeyCertificateEncoded\":\"-----BEGIN CERTIFICATE-----\MIIDKT...XbTK+M\-----END CERTIFICATE-----\",\"certificateChainEncoded\":\"-----BEGIN CERTIFICATE-----\MIIDKT...XbTK+M\-----END CERTIFICATE-----\-----BEGIN CERTIFICATE-----\MIIDKT...bXTK+M\-----END CERTIFICATE-----\"}"

Request URL

https://myManaged.cluster.com/api/v1.0/onpremise/sslCertificate/store/SERVER/32

Response body

Successfully updated. Response doesn't have a body.

Response code

200