clients

get security server client TLS certificates information

<h3>Administrator views the TLS certificates for the client.</h3>
get/clients/{id}/tls-certificates

Request

  • Base URL: /api/v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v1/clients/{id}/tls-certificates
  • Auth: API key in header Authorization

Path parameters

idstring text required

id of the client

Response

list of tls certificates

issuer_distinguished_namestring text required

certificate issuer distinguished name

issuer_common_namestring text required

certificate issuer common name

subject_distinguished_namestring text required

certificate subject distinguished name

subject_common_namestring text required

certificate subject common name

not_beforestring date-time required

certificate validity not before

not_afterstring date-time required

certificate validity not after

serialstring text required

serial number

versioninteger required

version

signature_algorithmstring sha-256 required

certificate signature algorithm

signaturestring text required

hex encoded certificate signature

public_key_algorithmstring sha-256 required

certificate public key algorithm

rsa_public_key_modulusstring hex required

hex encoded RSA public key modulus (if RSA key)

rsa_public_key_exponentinteger required

RSA public key exponent (if RSA key) as an integer

ec_public_parametersstring text

EC public key curve (if EC key)

ec_public_key_pointstring hex

hex encoded EC public key point (if EC key)

hashstring text required

certificate SHA-256 hash

key_usagesKeyUsage[] required

certificate key usage array

subject_alternative_namesstring text required

certificate subject alternative names

Example response

[
  {
    "issuer_distinguished_name": "issuer123",
    "issuer_common_name": "domain.com",
    "subject_distinguished_name": "subject123",
    "subject_common_name": "domain.com",
    "not_before": "2018-12-15T00:00:00.001Z",
    "not_after": "2018-12-15T00:00:00.001Z",
    "serial": "123456789",
    "version": 3,
    "signature_algorithm": "sha256WithRSAEncryption",
    "signature": "30af2fdc1780...",
    "public_key_algorithm": "sha256WithRSAEncryption",
    "rsa_public_key_modulus": "c44421d601...",
    "rsa_public_key_exponent": 65537,
    "ec_public_parameters": "secp256r1(1.2.840.10045.3.1.7)",
    "ec_public_key_point": "c44421d601...",
    "hash": "1234567890ABCDEF",
    "key_usages": [
      "NON_REPUDIATION"
    ],
    "subject_alternative_names": "DNS:*.example.org"
  }
]

Changes

No recorded changes to this operation across all 50 revisions of this API.