Add certificate authority
Trust a certificate authority on the connector: the certificate authority that signs the device certificates, as a PEM. Adding the same certificate authority again changes nothing. A certificate that is not a certificate authority, or that has expired, answers 422. A certificate authority that cannot be added answers 409.
curl -X POST "https://api.corma.io/v1/connectors/{id}/certificate-authorities" \
-H "x-corma-api-key: $CORMA_OPEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"pem": "string"
}'Authorization
x-corma-api-keystringheaderrequiredColon-separated API key ID and secret:
API_KEY_ID:API_KEY_SECRET
Parameters
idstringpathrequiredThe identifier of the connector, as
GET /connectorsreturned it, or the id of its connection. Thekind.methodform names the only connection of that integration; with several, it answers 409. Only a device management connector holds certificate authorities: any other connector answers 404.x-corma-idempotency-keystringheaderOptional client-generated key. Reusing the same key with an identical request replays the original response instead of enqueueing a duplicate task.
Body
pemstringrequiredThe certificate authority that signs the device certificates, in PEM format, with exactly one certificate. A rejected certificate answers 422 with a
data.code:invalid_pem,not_a_certificate_authority,expiredorissuer_dn_too_long.
Response
OK
fingerprintSha256stringrequiredThe SHA-256 fingerprint of the certificate authority, in lowercase hexadecimal. It identifies the certificate authority.
issuerDnstringrequiredThe distinguished name of the certificate authority. The device certificates it signs carry this name as their issuer.
notAfterstring<date-time>requiredThe timestamp after which the certificate authority is no longer trusted. ISO 8601 format.
createdAtstring<date-time>requiredThe timestamp of when this resource was created. ISO 8601 format.
{
"fingerprintSha256": "string",
"issuerDn": "string",
"notAfter": "2026-01-15T09:30:00Z",
"createdAt": "2026-01-15T09:30:00Z"
}