getInfo API

UEM uses this API to detect the commands that the PKI connector has implemented and to verify the authentication credentials for the PKI connector that are specified in the UEM management console. If the PKI connector does not implement this command, UEM assumes that the PKI connector supports the getUserKeyPair2 API only.

The HTTP request line is: GET customerSpecifiedPrefix/pki?operation=getInfo

customerSpecifiedPrefix obtains the path where the PKI connector is hosted. The UEM administrator specifies this path in a URL field in the management console (see Connect BlackBerry UEM to a BlackBerry Dynamics PKI connector in the UEM Administration content).

The API call returns the following JSON response value in the HTTP body:

Element

Type

Required

Details

operations

Array of strings

Yes

This element lists the protocol APIs that are implemented by the PKI connector.

Sample request and response:

In this sample, the administrator has specified the following URL for the PKI connector in the management console: https://ra.lifeonthedot.com

Request

GET /pki?operation=getInfo HTTP/1.0
Host: ra.lifeonthedot.com
Content-Type: application/json
Content-Length: 0

Response 

HTTP/1.0 200 OK
Host: ra.lifeonthedot.com
Content-Type: application/json
Content-Length: XYZ

{
    “operations” : [“getInfo”, “getUserKeyPair2”]
}