Idempotence℠ CA API Documentation (1.2)

Download OpenAPI specification:Download

Authenticate using API credentials to make use of the API.

Use this endpoint to authenticate using API credentials and obtain a short-lived token.

Request Body schema: application/json
required
apiKey
string

The API key used to attain a short-lived token.

apiSecret
string

The API secret used to authenticate the API key.

Responses

Request samples

Content type
application/json
{
  • "apiKey": "string",
  • "apiSecret": "string"
}

Response samples

Content type
application/json
{
  • "token": "string"
}

Sign a new certificate for a given connection.

Use this endpoint to sign a new x.509 certificate for a specific connection.

Authorizations:
bearerAuth
Request Body schema: application/json

New certificate details

certificateName
string

The desired name of the new certificate.

parentConnectionID
integer

The unique identifier of the connection for which the certificate needs to be signed.

commonName
string

The common name (CN) to be included in the certificate.

dnsNames
Array of strings

An optional list of DNS names (subject alternative names) to be included in the certificate.

Responses

Request samples

Content type
application/json
{
  • "certificateName": "string",
  • "parentConnectionID": 0,
  • "commonName": "string",
  • "dnsNames": [
    ]
}

Response samples

Content type
application/json
{
  • "certificateId": 0,
  • "certificateName": "string",
  • "caConnectionId": 0,
  • "certificateAuthorityId": 0,
  • "expiration": "2019-08-24"
}

Get a list of certificates for a given connection.

Use this endpoint to retrieve a list of certificates for a specific connection.

Authorizations:
bearerAuth
path Parameters
id
required
string

The unique identifier for the connection.

Responses

Response samples

Content type
application/json
{
  • "certificates": [
    ]
}

Get a certificate given the unique certificate identifier.

Use this endpoint to retrieve a certificate for a specific unique certificate identifier.

Authorizations:
bearerAuth
path Parameters
id
required
string

The unique identifier for the certificate.

Responses

Response samples

Content type
application/json
{
  • "certificate": {
    },
  • "intermediateCA": "string",
  • "rootCA": "string"
}