- Overview
- Reference Guide
- Setup & Architecture
- Release Notes
- Workflow
- API Reference
- Integration Guide
- Discovery Agent Setup Guide
Templates
The Templates endpoints manage the template configuration (validity) that CertSecure Manager applies to the certificate templates of a CA.
For the corresponding user interface, refer to the Inventory > Template Management section.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /template/configure | Get template configuration. |
| POST | /template/configure | Create template configuration. |
| PATCH | /template/configure | Update template configuration. |
| DELETE | /template/configure | Delete template configuration. |
GET /template/configure
Returns the template configuration (validity settings) of a CA.
Request Parameters
| Name | Located In | Type | Required | Description |
|---|---|---|---|---|
ca |
Query | string | Yes | Name of the certificate authority (CA) as configured in CertSecure Manager. |
Example Request
curl -X GET "https://<certsecure-backend-url>/template/configure?ca=<ca>" \
-H "Authorization: Bearer <token>"
Responses
| Status Code | Description |
|---|---|
| 200 | The configuration is returned. |
POST /template/configure
Creates the configuration for a certificate template of a CA, including its validity.
Request Parameters
| Name | Located In | Type | Required | Description |
|---|---|---|---|---|
ca |
Query | string | Yes | Name of the certificate authority (CA) as configured in CertSecure Manager. |
Request Body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
Template |
string | Yes | Name of the certificate template. |
validity |
integer | Yes | Validity period of certificates issued from the template. |
Example Request
curl -X POST "https://<certsecure-backend-url>/template/configure?ca=<ca>" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"Template": "string", "validity": 1}'
Responses
| Status Code | Description |
|---|---|
| 200 | The resource was created. |
PATCH /template/configure
Updates the validity configured for a certificate template of a CA.
Request Parameters
| Name | Located In | Type | Required | Description |
|---|---|---|---|---|
ca |
Query | string | Yes | Name of the certificate authority (CA) as configured in CertSecure Manager. |
Request Body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
Template |
string | Yes | Name of the certificate template. |
validity |
integer | Yes | Validity period of certificates issued from the template. |
Example Request
curl -X PATCH "https://<certsecure-backend-url>/template/configure?ca=<ca>" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"Template": "string", "validity": 1}'
Responses
| Status Code | Description |
|---|---|
| 200 | The resource was updated. |
DELETE /template/configure
Deletes the configuration of a certificate template of a CA.
Request Parameters
| Name | Located In | Type | Required | Description |
|---|---|---|---|---|
ca |
Query | string | Yes | Name of the certificate authority (CA) as configured in CertSecure Manager. |
Request Body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
Template |
string | Yes | Name of the certificate template. |
Example Request
curl -X DELETE "https://<certsecure-backend-url>/template/configure?ca=<ca>" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"Template": "string"}'
Responses
| Status Code | Description |
|---|---|
| 200 | The resource was deleted. |