Using the SSL Certificates REST API

Using the SSL Certificates REST API is straight forward.

For the permissions required to access the SSL Certificates REST API, see Role Permissions for Intelligent Advisor REST APIs.

POST request

To POST a certificate, specify a name and the public certificate. There are input validations in place to avoid duplicates of name or certificate data. In practice this means that no two certificates can be uploaded with the same SHA-256 fingerprint hash.

{
    "name": "example",
    "certificate": "-----BEGIN CERTIFICATE-----\nMIIDHTCCAgWgAwIBAgIEKndOLDANBgkqhkiG9w0BAQsFADA/MRswGQYDVQQKExJPcmFjbGUgQ29y\ncG9yYXRpb24xIDAeBgNVBAMTF25jdWxsLWF1My5hdS5vcmFjbGUuY29tMB4XDTE3MDIwNjA0MzI1\nMFoXDTE3MDUwNzA0MzI1MFowPzEbMBkGA1UEChMST3JhY2xlIENvcnBvcmF0aW9uMSAwHgYDVQQD\nExduY3VsbC1hdTMuYXUub3JhY2xlLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB\nAI3ej9WvMlIpvHeXkl3xJFmVEvksAeLoMh3jnf2Ybp+w8WEgH5tQuptJ6fNvZrn8u/D2J3xAu7L9\nKJLmHKOqrhaUI4S2zBUl2/ykQCozPTHSQS3Xpzqc3aD7RWIyTrX4of5AuFJaPowbXhpserVpQHNl\nYdYkA9eAJ8ALb4MK6i6uxtz3hh2wIHMr1w2b7qTGibYX2gFBY4PXjtFEGhxLWEHLR6+npMm0yYra\nKRsAV9m+a31d01kWUbG1DzZhuKSMuplsfz09nza1GJI43FBi4CiAE5afBVAWBFCRWK1pxBJfaMPn\nWi7iG9nrpQDi0NTQixugx1U1Ncr8IbYLkX86yKECAwEAAaMhMB8wHQYDVR0OBBYEFEqTn4C2Kz9+\nYIry99v0P5n/8nU1MA0GCSqGSIb3DQEBCwUAA4IBAQBJLRgrMImAbHr4JJVnr66C/OECnBtN2yCm\nu3taktRDsKoaOWtmD7MpSAHBT2U3YQb4iGh/l7lIF/wnrFQ0nMzXn5aSudq3TrascSowE7EGbZsW\n9j9DshI+Xr5JojAmXuzLWY64vu3pLHASObuUPXzMZE+H8rRGumBWwdYpI2V5UB6S8+Cg7c32kj3d\nhZ5cLP0kKqe/AxSU7hhVwxfbuhLDCXzJTKvamk1vkpzW0FpagJZayGvxtA2atJ5YA9Z2U3Iu6frS\nJUeP4oEOUYa5KlzU9GcxE677UNEgpJ+oy37LkSUQBUXNv+oDRtMGeW/Zcv8lwqKePLB1rhxIX733\nNHb7\n-----END CERTIFICATE-----\n"
}

POST response

The response adds additional read-only fields, extracted from the certificate data.

{
    "name": "example",
    "certificate": "-----BEGIN CERTIFICATE-----\nMIIDHTCCAgWgAwIBAgIEKndOLDANBgkqhkiG9w0BAQsFADA/MRswGQYDVQQKExJPcmFjbGUgQ29y\ncG9yYXRpb24xIDAeBgNVBAMTF25jdWxsLWF1My5hdS5vcmFjbGUuY29tMB4XDTE3MDIwNjA0MzI1\nMFoXDTE3MDUwNzA0MzI1MFowPzEbMBkGA1UEChMST3JhY2xlIENvcnBvcmF0aW9uMSAwHgYDVQQD\nExduY3VsbC1hdTMuYXUub3JhY2xlLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB\nAI3ej9WvMlIpvHeXkl3xJFmVEvksAeLoMh3jnf2Ybp+w8WEgH5tQuptJ6fNvZrn8u/D2J3xAu7L9\nKJLmHKOqrhaUI4S2zBUl2/ykQCozPTHSQS3Xpzqc3aD7RWIyTrX4of5AuFJaPowbXhpserVpQHNl\nYdYkA9eAJ8ALb4MK6i6uxtz3hh2wIHMr1w2b7qTGibYX2gFBY4PXjtFEGhxLWEHLR6+npMm0yYra\nKRsAV9m+a31d01kWUbG1DzZhuKSMuplsfz09nza1GJI43FBi4CiAE5afBVAWBFCRWK1pxBJfaMPn\nWi7iG9nrpQDi0NTQixugx1U1Ncr8IbYLkX86yKECAwEAAaMhMB8wHQYDVR0OBBYEFEqTn4C2Kz9+\nYIry99v0P5n/8nU1MA0GCSqGSIb3DQEBCwUAA4IBAQBJLRgrMImAbHr4JJVnr66C/OECnBtN2yCm\nu3taktRDsKoaOWtmD7MpSAHBT2U3YQb4iGh/l7lIF/wnrFQ0nMzXn5aSudq3TrascSowE7EGbZsW\n9j9DshI+Xr5JojAmXuzLWY64vu3pLHASObuUPXzMZE+H8rRGumBWwdYpI2V5UB6S8+Cg7c32kj3d\nhZ5cLP0kKqe/AxSU7hhVwxfbuhLDCXzJTKvamk1vkpzW0FpagJZayGvxtA2atJ5YA9Z2U3Iu6frS\nJUeP4oEOUYa5KlzU9GcxE677UNEgpJ+oy37LkSUQBUXNv+oDRtMGeW/Zcv8lwqKePLB1rhxIX733\nNHb7\n-----END CERTIFICATE-----\n",
    "fingerprintSHA256": "4A:13:E7:AD:2E:37:A4:0D:EE:F8:8D:1B:2A:A4:E3:5E:83:3A:A2:8A:E7:C3:57:36:CE:CB:75:A7:31:B4:1D:40",
    "fingerprintSHA1": "14:67:40:78:6F:EF:C5:6D:30:94:0A:68:C9:08:E5:38:04:E5:C3:A8",
    "validFrom": "2025-08-05T13:00:00Z",
    "validTo": "2025-11-06T14:00:00Z",
    "issuer": "CN=ncull-au3.au.oracle.com,O=Oracle Corporation",
    "subject": "CN=ncull-au3.au.oracle.com,O=Oracle Corporation"
}