Summary
Get all certificates
Description
Get all certificates from the certificate store
Route
GET /gateway_manager/v1/certificates
Roles
certificate:read
Parameters
DetailsExampleSchema
Name |
Type |
Required |
Description |
This method has no parameters |
Copied to Clipboard
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}
Return
DetailsExampleSchema
Name |
Type |
Description |
response |
object |
A list of all of the certificates that exist in the certificate store |
Copied to Clipboard
{
"state": "Success",
"results": [
{
"_id": "66ff56c9fcbec46997145abd",
"certificate": "-----BEGIN CERTIFICATE--...",
"contract_id": "my-certificate-1",
"host": "localhost",
"issuer": "localhost",
"self_signed": false,
"type": "Root",
"validity": {
"notBefore": "2024-10-03T20:52:55.0Z",
"notAfter": "2025-10-03T20:52:55.0Z"
},
"gateways": [
"gateway_1",
"gateway_1",
"gateway_1",
"gateway_1"
]
},
{
"_id": "66ff56c9fcbec46997145abd",
"certificate": "-----BEGIN CERTIFICATE--...",
"contract_id": "my-certificate-1",
"host": "localhost",
"issuer": "localhost",
"self_signed": true,
"type": "Root",
"validity": {
"notBefore": "2024-10-03T20:52:55.0Z",
"notAfter": "2025-10-03T20:52:55.0Z"
},
"gateways": [
"gateway_1",
"gateway_1",
"gateway_1",
"gateway_1",
"gateway_1"
]
},
{
"_id": "66ff56c9fcbec46997145abd",
"certificate": "-----BEGIN CERTIFICATE--...",
"contract_id": "my-certificate-1",
"host": "localhost",
"issuer": "localhost",
"self_signed": false,
"type": "Root",
"validity": {
"notBefore": "2024-10-03T20:52:55.0Z",
"notAfter": "2025-10-03T20:52:55.0Z"
},
"gateways": [
"gateway_1",
"gateway_1"
]
},
{
"_id": "66ff56c9fcbec46997145abd",
"certificate": "-----BEGIN CERTIFICATE--...",
"contract_id": "my-certificate-1",
"host": "localhost",
"issuer": "localhost",
"self_signed": false,
"type": "Root",
"validity": {
"notBefore": "2024-10-03T20:52:55.0Z",
"notAfter": "2025-10-03T20:52:55.0Z"
},
"gateways": [
"gateway_1",
"gateway_1",
"gateway_1"
]
}
]
}
Copied to Clipboard
{
"title": "response",
"type": "object",
"properties": {
"state": {
"type": "string",
"default": "Success",
"examples": [
"Success"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"_id": {
"type": "string",
"description": "The Id of the certificate within the database",
"examples": [
"66ff56c9fcbec46997145abd"
]
},
"certificate": {
"type": "string",
"description": "The raw certificate data",
"examples": [
"-----BEGIN CERTIFICATE--..."
]
},
"contract_id": {
"type": "string",
"description": "The name of the certificate",
"examples": [
"my-certificate-1"
]
},
"host": {
"type": "string",
"examples": [
"localhost"
]
},
"issuer": {
"type": "string",
"examples": [
"localhost"
]
},
"self_signed": {
"type": "boolean"
},
"type": {
"type": "string",
"examples": [
"Root"
]
},
"validity": {
"type": "object",
"properties": {
"notBefore": {
"type": "string",
"examples": [
"2024-10-03T20:52:55.000Z"
],
"format": "date-time"
},
"notAfter": {
"type": "string",
"examples": [
"2025-10-03T20:52:55.000Z"
],
"format": "date-time"
}
}
},
"gateways": {
"type": "array",
"description": "An array of the gateways that are associated with the certificate",
"items": {
"type": "string",
"examples": [
"gateway_1"
]
}
}
}
}
}
}
}