GET Certificates ID

The GET /Certificates/{id} method is used to return details for the certificate with the specified ID. This method returns HTTP 200 OK on a success with certificate details in the message body.

Tip:  The following permissions (see Security Roles and Claims) are required to use this feature:
/certificates/collections/read/
OR
/certificates/collections/read/#/ (where # is a reference to a specific certificate collection ID)

Permissions for certificates can be set at either the global or certificate collectionClosed The certificate search function allows you to query the Keyfactor Command database for certificates from any available source based on any criteria of the certificates and save the results as a collection that will be availble in other places in the Management Portal (e.g. expiration alerts and certain reports). level. See Certificate Collection Permissions for more information about global vs collection permissions. See also the CollectionId input parameterClosed A parameter or argument is a value that is passed into a function in an application., below.

Table 243: GET Certificates {id} Input Parameters

Name In Description
id Path Required. An integer indicating the Keyfactor Command reference ID of the certificate.

Use the GET /Certificates method (see GET Certificates) to retrieve a list of multiple certificates to determine the desired certificate's ID.
includeLocations Query A Boolean that sets whether to include the Locations data in the response (true) or not (false). If false is selected, the LocationsCount and Locations fields will still appear in the response, but they will contain no data. The default is false.
includeMetadata Query A Boolean that sets whether to include the Metadata data in the response (true) or not (false). If false is selected, the Metadata field will still appear in the response, but it will contain no data. The default is false.
CollectionId Query

An integer specifying an optional certificate collection identifier to validate that the user executing the request has sufficient permissions to do so. If a certificate collection ID is not supplied, the user must have global permissions to complete the action. Supplying a certificate collection ID allows for a check of the user's certificate collection-level permissions to determine whether the user has sufficient permissions at a collection level to complete the action. See Certificate Collection Permissions for more information.

Table 244: GET Certificates {id} Response Data

Name Description
Id An integer indicating the Keyfactor Command reference ID of the certificate.
Thumbprint A string indicating the thumbprint of the certificate.
SerialNumber A string indicating the serial number of the certificate.
IssuedDN A string indicating the distinguished name of the certificate.
IssuedCN A string indicating the common name of the certificate.
ImportDate The date, in UTC, on which the certificate was imported into Keyfactor Command.
NotBefore The date, in UTC, on which the certificate was issued by the certificate authority.
NotAfter The date, in UTC, on which the certificate expires.
IssuerDN A string indicating the distinguished name of the issuer.
PrincipalId An integer indicating the Keyfactor Command reference ID of the principal (UPN) that requested the certificate. Typically, this field is only populated for end user certificates requested through Keyfactor Command (e.g. Mac auto-enrollment certificates). See also PrinicpalName.
TemplateId An integer indicating the Keyfactor Command reference ID of the template associated with the certificate.
CertState An integer specifying the state of the certificate. ClosedShow certificate state details.
KeySizeInBits An integer specifying the key size in bits.
KeyType An integer specifying the key type of the certificate. ClosedShow key type details.
RequesterId An integer indicating the Keyfactor Command reference ID of the identity that requested the certificate. See also RequesterName.
IssuedOU A string indicating the organizational unit of the certificate.
IssuedEmail A string indicating the email address of the certificate.
KeyUsage

An integer indicating the total key usage of the certificate. Key usage is stored in Active Directory as a single value made of a combination of values. ClosedShow value details.

For example, a value of 160 would represent a key usage of digital signature with key encipherment. A value of 224 would add nonrepudiation to those.
SigningAlgorithm A string indicating the algorithm used to sign the certificate.
CertStateString A string containing the certificate state. The possible values are:
  • Unknown (0)
  • Active (1)
  • Revoked (2)
  • Denied (3)
  • Failed (4)
  • Pending (5)
  • Certificate Authority (6)
  • Parent Certificate Authority (7)
  • External Validation (8)
KeyTypeString A string containing the key type description (e.g. RSA) as per the types and descriptions shown for KeyType.
RevocationEffDate The date, in UTC, on which the certificate was revoked, if applicable.
RevocationReason An integer indicating the reason the certificate was revoked. ClosedShow revocation reason details.
RevocationComment An internally used Keyfactor Command field.
CertificateAuthorityId An integer indicating the Keyfactor Command reference ID of the certificate authority that issued the certificate.
CertificateAuthorityName A string indicating the certificate authority that issued the certificate.
TemplateName A string indicating the display name of the template that was used when issuing the certificate.
ArchivedKey A Boolean that indicates whether the certificate has a key archived in the issuing CA (true) or not (false).
HasPrivateKey A Boolean that indicates whether the certificate has a private key stored in Keyfactor Command (true) or not (false)
PrincipalName A string containing the name of the principal (UPN) that requested the certificate. Typically, this field is only populated for end user certificates requested through Keyfactor Command (e.g. Mac auto-enrollment certificates).
CertRequestId An integer containing the Keyfactor Command reference ID of the certificate request.
RequesterName A string containing the name of the identity that requested the certificate.
ContentBytes A string containing the certificate as bytes.
ExtendedKeyUsages

An array of objects containing the extended key usages associated with the certificate. ClosedShow Extended Key details.
SubjectAltNameElements An array of objects containing the subject alternative name elements of the certificate. ClosedShow SAN details.
CRLDistributionPoints An array of objects containing the distribution points for the certificate revocation lists the certificate could be in. ClosedShow CRL distribution point details.
LocationsCount An array of objects containing a count of how many certificates are in each location type. This returns a list of type and count combination. For example:
Copy
"LocationsCount": [
   {
      "Type": "IIS",
      "Count": 2
   },
   {
      "Type": "F5-SL-REST",
      "Count": 1
   }
]
SSLLocations

An array of objects containing the locations where the certificate is found using SSL discovery. ClosedShow SSL location details.
Locations An array of objects containing the locations where the certificate is found using certificate store inventorying. ClosedShow certificate store location details.
Metadata An object containing the metadata fields populated for the certificate.
CertificateKeyId An integer indicating the Keyfactor Command reference ID for the private key, if one exists, and public key of the certificate.
CARowIndex

An integer containing the CA's reference ID for certificate.

Note:  The CARowIndex has been replaced by CARecordId, but will remain for backward compatibility. It will only contain a non-zero value for certificates issued by Microsoft CAs. For Microsoft CA certificates, the CARowIndex will be equal to the CARecordId value parsed to an integer.
CARecordId A string containing the CA's reference ID for certificate.
DetailedKeyUsage

An object containing details of the key usage configured for the certificate. ClosedShow detailed key usage details.
KeyRecoverable A Boolean that indicates whether the certificate key is recoverable (true) or not (false).
Curve

A string indicating the OID of the elliptic curve algorithm configured for the certificate, for ECC templates. Well-known OIDs include:

  • 1.2.840.10045.3.1.7 = P-256/prime256v1/secp256r1

  • 1.3.132.0.34 = P-384/secp384r1

  • 1.3.132.0.35 = P-521/secp521r1
CertStoreTypeShortNames An array of comma-separated strings indicating the certificate stores types associated with each certificate.
Tip:  See the Keyfactor API Reference and Utility which provides a utility through which the Keyfactor APIClosed A set of functions to allow creation of applications. Keyfactor offers the Keyfactor API, which allows third-party software to integrate with the advanced certificate enrollment and management features of Keyfactor Command. endpoints can be called and results returned. It is intended to be used primarily for validation, testing and workflowClosed A workflow is a series of steps necessary to complete a process. In the context of Keyfactor Command, it refers to the workflow builder, which allows you automate event-driven tasks when a certificate is requested or revoked. development. It also serves secondarily as documentation for the API. The link to the Keyfactor API Reference and Utility is in the dropdown from the help icon () at the top of the Management Portal page next to the Log Out button.