Getting Details of the Client Side SSL Certificates

Description

Get the SSL certificate details that are on the client side.

Resource Path /

URL /mdm-admin/certificates/{serialNumber}

HTTP Method GET

Request/Response Format application/json

cURL command

curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/mdm-admin/certificates/{serialNumber}

For more information on how to generate the <EMM_API_TOKEN>, see Generating the OAuth 2.0 Access Token.
By default, <EMM_HOST> is localhost. However, if you are using a public IP, the respective IP address or domain needs to be specified.
By default, <EMM_HTTPS_PORT> has been set to 9443. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.
Provide the serial number of the certificate that you wish to get the details of, as the {serialNumber}.

Example:

curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer f4c0c1b2b4ace7040132682139d51f74" -k -v https://localhost:9443/mdm-admin/certificates/{serialNumber}

Sample output

{
  "serialNumber": "124380353155528759302""tenantId": -1234"commonName": "10.10.10.24""notAfter": 1487051941000"notBefore": 1455515941000"certificateserial": 12438035315552877000"issuer": "CN=10.10.10.24, OU=sa, O=as, L=asd, ST=asd, C=sl""subject": "CN=10.10.10.24, OU=sa, O=as, L=asd, ST=asd, C=sl""certificateVersion": 3
}

Sample JSON output
Definition

Property Value	Description	Data Type
`serial`	It is the unique ID to identify a certificate. In device enrollment this is the common name of the client's certificate.	String
`pem`	Convert the OpenSSL certificate to the .pem format and base 64 encode the file. Upload the `.pem` file and base 64 encode it using a tool, such as the base64encode.in tool.	String
`tenantId`
`commonName`
`notAfter`
`notBefore`
`certificateserial`
`issuer`
`subject`
`certificateVersion`