G-g-core
CA certificates

Add trusted CA certificate

Changed on

Add a trusted CA certificate to verify an origin.

Enter all strings of the certificate in one string parameter. Each string should be separated by the "\n" symbol.

post/cdn/sslCertificates

Request

  • Base URL
    https://api.gcore.com
  • URL
    https://api.gcore.com/cdn/sslCertificates
  • Auth
    HTTP apikey

Request body

namestring required

CA certificate name.

It must be unique.

sslCertificatestring required

Public part of the CA certificate.

It must be in the PEM format.

Example request

{
  "name": "Example CA cert",
  "sslCertificate": "-----BEGIN CERTIFICATE-----\nMIIBbTCCARKgAwIBAgIULDeBmErpf2HbicPq8M/WK6fUZxEwCgYIKoZIzj0EAwIw\nKjETMBEGA1UECgwKRXhhbXBsZSBDQTETMBEGA1UEAwwKRXhhbXBsZSBDQTAeFw0y\nNjAxMDEwMDAwMDBaFw0zNjAxMDEwMDAwMDBaMCoxEzARBgNVBAoMCkV4YW1wbGUg\nQ0ExEzARBgNVBAMMCkV4YW1wbGUgQ0EwWTATBgcqhkjOPQIBBggqhkjOPQMBBwNC\nAATdtaj2FA1AUBTNxVPfCeuuJWY6D1SQTtCNT3vbakavfJu+QISYQcc0Tbtudl5s\nv6mQPTiVlKOzi5NSWYn9F8YwoxYwFDASBgNVHRMBAf8ECDAGAQH/AgEAMAoGCCqG\nSM49BAMCA0kAMEYCIQD4GWDCyoYDx48b49W/R6ox5K2Dx37otAqQCSeB96moHAIh\nAKAUFyIRFL4HQ1Y3jEELs8TvC2554gcPQKitr0S0wM1g\n-----END CERTIFICATE-----\n"
}

Response

Successful.

idinteger

CA certificate ID.

namestring

CA certificate name.

deletedboolean

Defines whether the certificate has been deleted.

Possible values:

  • true - Certificate has been deleted.
  • false - Certificate has not been deleted.
cert_issuerstring nullable

Name of the certification center that issued the CA certificate.

cert_subject_cnstring nullable

Domain name that the CA certificate secures.

cert_subject_altstring nullable

Alternative domain names that the CA certificate secures.

validity_not_beforestring date-time

Date when the CA certificate become valid (ISO 8601/RFC 3339 format, UTC.)

validity_not_afterstring date-time

Date when the CA certificate become untrusted (ISO 8601/RFC 3339 format, UTC.)

sslCertificateChainstring

Parameter is deprecated.

hasRelatedResourcesboolean

Defines whether the CA certificate is used by a CDN resource.

Possible values:

  • true - Certificate is used by a CDN resource.
  • false - Certificate is not used by a CDN resource.

Example response

{
  "id": 1,
  "name": "Example CA certificate",
  "cert_issuer": "Example CA",
  "cert_subject_cn": "Example CA",
  "validity_not_before": "2026-01-01T00:00:00Z",
  "validity_not_after": "2036-01-01T00:00:00Z"
}

Changes

  • a07634491debRevision changes
    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • info

      response property deleted deprecated