CA Certificates
CA certificates
List all CA certificates
Retrieve a list of all available Certificate Authority (CA) certificates, including the certificate ID, creation date, and other details. You can use query parameters to filter the results by size or tags, for example /ca-certificates?size=50&tags=enterprise.
Query Parameters
Number of resources to be returned.
Default:100
>= 1<= 1000
Offset from which to return the next set of resources. Use the value of the ‘offset’ field from the response of a list operation as input here to paginate through all the resources
A list of tags to filter the list of resources on. Multiple tags can be concatenated using ‘,’ to mean AND or using ‘/’ to mean OR.
Example:tag1,tag2
Path Parameters
The ID of your runtime group. This variable is available in the Konnect manager
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Response
200 application/json
Response
A successful response listing CA Certificates
CA-Certificate
A CA certificate object represents a trusted CA. These objects are used by Kong to verify the validity of a client or server certificate. CA Certificates can be both tagged and filtered by tags.
PEM-encoded public certificate of the CA.
Example:-----BEGIN CERTIFICATE-----...
SHA256 hex digest of the public certificate.
Example:c641e28d77e93544f2fa87b2cf3f3d51...
Unix epoch when the resource was created.
Example:1422386534
Unix epoch when the resouce was updated.
Example:1422386534
Example:04fbeacf-a9f1-4a5d-ae4a-b0407445db3f
An optional set of strings associated with the Certificate for grouping and filtering.
Example:[user-level, low-priority]
Authentication
Path Parameters
Query Parameters
Create a new CA certificate
Create a new Certificate Authority (CA) certificate. The request body must include the cert property, the certificate data in PEM format; it can also include cert_digest, a digest of the certificate in hex format for verifying the certificates integrity, and tags, an optional list of tags to categorize the certificate.
Path Parameters
The ID of your runtime group. This variable is available in the Konnect manager
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Body
application/json
Body
This request body represents a new Certificate Authority (CA) certificate and includes the properties required to create a new certificate.
PEM-encoded public certificate of the CA.
Example:-----BEGIN CERTIFICATE-----...
SHA256 hex digest of the public certificate.
Example:c641e28d77e93544f2fa87b2cf3f3d51...
An optional set of strings associated with the Certificate for grouping and filtering.
Response
application/json
Response
The created certificate object.
CA-Certificate
A CA certificate object represents a trusted CA. These objects are used by Kong to verify the validity of a client or server certificate. CA Certificates can be both tagged and filtered by tags.
PEM-encoded public certificate of the CA.
Example:-----BEGIN CERTIFICATE-----...
SHA256 hex digest of the public certificate.
Example:c641e28d77e93544f2fa87b2cf3f3d51...
Unix epoch when the resource was created.
Example:1422386534
Unix epoch when the resouce was updated.
Example:1422386534
Example:04fbeacf-a9f1-4a5d-ae4a-b0407445db3f
An optional set of strings associated with the Certificate for grouping and filtering.
Example:[user-level, low-priority]
Authentication
Path Parameters
Body
Delete a CA Certificate
Delete the specified Certificate Authority (CA) certificate using the provided ca_certificate_id.
Path Parameters
ID of the related certificate
Example:7fca84d6-7d37-4a74-a7b0-93e576089a41
The ID of your runtime group. This variable is available in the Konnect manager
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Response
204
Response
Successfully deleted CA Certificate or the resource didn’t exist
Authentication
Path Parameters
Get a CA certificate
Retrieve details about the specified Certificate Authority (CA) certificate using the provided path parameter ca_certificate_id.
Query Parameters
Offset from which to return the next set of resources. Use the value of the ‘offset’ field from the response of a list operation as input here to paginate through all the resources
Number of resources to be returned.
Default:100
>= 1<= 1000
A list of tags to filter the list of resources on. Multiple tags can be concatenated using ‘,’ to mean AND or using ‘/’ to mean OR.
Example:tag1,tag2
Path Parameters
The unique identifier of the certificate to retrieve.
The ID of your runtime group. This variable is available in the Konnect manager
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Response
application/json
Response
The specified CA certificate exists in the system, and the response includes details about the certificate.
CA-Certificate
A CA certificate object represents a trusted CA. These objects are used by Kong to verify the validity of a client or server certificate. CA Certificates can be both tagged and filtered by tags.
PEM-encoded public certificate of the CA.
Example:-----BEGIN CERTIFICATE-----...
SHA256 hex digest of the public certificate.
Example:c641e28d77e93544f2fa87b2cf3f3d51...
Unix epoch when the resource was created.
Example:1422386534
Unix epoch when the resouce was updated.
Example:1422386534
Example:04fbeacf-a9f1-4a5d-ae4a-b0407445db3f
An optional set of strings associated with the Certificate for grouping and filtering.
Example:[user-level, low-priority]