Skip to content
URL:
https://<root>/machines/<machine>/sslcertificates/<certificate>
Methods:
GET
Operations:
Generate CSR, Export, Delete, Import Signed Certificate
Version Introduced:
12.0

Description

This resource outputs details about a specific certificate that is registered with a server machine.

Request parameters

ParameterDetails

f

(Required)

The output format for this operation. The default value is html.

Values: html | json | pjson

Response properties

PropertyDetails

aliasName

The aliasName of a certificate is manually input during the import process.

validFromEpoch

A Unix timestamp of when certificate was created.

keyAlgorithm

The algorithm used to generate the key associated with the certificate.

serialNumber

A serialNumber is automatically assigned to certificates, and is output as a part of this property.

keySize

The total keySize of the certificate as an integer.

subject

The subject name associated with the certificate, based upon its location of creation.

subjectAlternativeName

The subjectAlternativeName associated with the certificate, chosen at its time of creation.

sha1Fingerprint

Contains the sha1 fingerprint generated for this certificate.

validFrom

The date the certificate was created, written as a string.

version

If there have been multiple updated versions of a certificate, this value will increase.

md5Fingerprint

Contains the md5 fingerprint generated for this certificate.

issuer

The issuer of the certificate. This can be a Certificate Authority or, if self-signed, the host machine's address.

signatureAlgorithm

The algorithm used to sign this certificate upon its creation.

keyUsage

Outputs a list of acceptable uses for a key, determined at the time of certificate creation.

validUntilEpoch

A Unix timestamp of the certificate's expiration date.

sha256Fingerprint

Contains the sha256 fingerprint generated for this certificate.

validUntil

The date the certificate expires, written as a string.

Example usage

The following is a sample GET request for the sslCertificates resource:

Use dark colors for code blocksCopy
1
https://videoserver.example.com/video/admin/machines/machine.example.com/sslCertificates/selfSignedCertificate?f=pjson

JSON Response syntax

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
    "aliasName": "aliasName",
    "validFromEpoch": "<epoch time string>",
    "keyAlgorithm": "<key algorithm type>",
    "serialNumber": "<serial number of certificate>",
    "keySize": "<total key size>",
    "subject": "CN=ORGANIZATION.EXAMPLE.COM, O=certificateName",
    "subjectAlternativeNames": ["DNSName: VIDEOSERVER.EXAMPLE.COM"],
    "sha1Fingerprint": "<sha1 fingerprint>",
    "validFrom": "<WEEKDAY | MONTH | DATE | TIME | TIMEZONE | YEAR>",
    "version": "<version number>",
    "md5Fingerprint": "<md5 fingerprint>",
    "issuer": "CN=ORGANIZATION.EXAMPLE.COM, O=certificateName",
    "signatureAlgorithm": "<algorithm type of signature>",
    "keyUsage": [],
    "validUntilEpoch": "<epoch date/time>",
    "sha256Fingerprint": "<sha256 fingerprint>",
    "validUntil": "<WEEKDAY | MONTH | DATE | TIME | TIMEZONE | YEAR>"
}

JSON Response example

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
    "aliasName": "selfsignedcertificate",
    "validFromEpoch": 1768917852000,
    "keyAlgorithm": "RSA",
    "serialNumber": "cb925bb0cf7ad486",
    "keySize": 2048,
    "subject": "CN=ORGANIZATION.EXAMPLE.COM, O=SelfSignedCertificate",
    "subjectAlternativeNames": ["DNSName: VIDEOSERVER.EXAMPLE.COM"],
    "sha1Fingerprint": "c8ecdc517dc8db69785530f92a102da94f5ceb4a",
    "validFrom": "Tue Jan 20 09:04:12 EST 2026",
    "version": 3,
    "md5Fingerprint": "18fddb1856aa1f0e34f96e985bfcf3c7",
    "issuer": "CN=ORGANIZATION.EXAMPLE.COM, O=SelfSignedCertificate",
    "signatureAlgorithm": "SHA256withRSA",
    "keyUsage": [],
    "validUntilEpoch": 2805717852000,
    "sha256Fingerprint": "740485873b2d50febf1a33c31a387aa65734add2bb2f45a2f36e29b8b8cb03f4",
    "validUntil": "Thu Nov 28 09:04:12 EST 2058"
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.