Create Root Certificate Authorities
Creates a root certificate authority using the provided certificate pem and private key pem. It will be marked as inactive initially.
This is used during Step 1 of the Certificate Authority rotation procedure. See Rotating CAs and Leaf Certificates for more details.
Request
URI
POST
https://{api_host}/api/v0/certificate_authorities
COPY
Request Body
OK
{
"cert_pem": "string",
"private_key_pem": "string"
}
string
cert_pem
Optional
cert_pem
string
private_key_pem
Optional
private_key_pem
Responses
200
OK
Returns RegeneratedCertificateAuthoritiesRotationStatus of type(s) application/json
{
"guid": "string",
"issuer": "string",
"created_on": "string",
"expires_on": "string",
"active": false,
"cert_pem": "string",
"certificates": {
"regenerated": [
{
"location": "string",
"product_guid": "string",
"property_reference": "string",
"variable_path": "string",
"reason": "string"
}
],
"excluded": [
{
"location": "string",
"product_guid": "string",
"property_reference": "string",
"variable_path": "string",
"reason": "string"
}
],
"regenerate_failed": [
{
"location": "string",
"product_guid": "string",
"property_reference": "string",
"variable_path": "string",
"reason": "string"
}
]
}
}
string
guid
Optional
guid
string
issuer
Optional
issuer
string
created_on
Optional
created_on
string
expires_on
Optional
expires_on
boolean
active
Optional
active
string
cert_pem
Optional
cert_pem
object
certificates
Optional
certificates
422
Unprocessable Entity
Returns SafetyViolations of type(s) application/json
"SafetyViolations Object"
string
error
Optional
error
array of safety_violations
safety_violations
Optional
safety_violations
Code Samples
COPY
curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/api/v0/certificate_authorities