The RSA SecurID Access Device Details API enables Help Desk administrators to look up user devices using a User ID.
Note: The API can retrieve all user devices for a single user per request.
Clients calling this API must authenticate themselves by including a JSON Web Token in a request. For instructions on using this token, see Authentication for the Cloud Administration REST APIs .
Software Developer Kit
You can download the API Software Developer Kit (SDK) from https://community.rsa.com/docs/DOC-94122.
Use the following information to retrieve information about a particular user's device.
|Method||Request URL||Response Content Type||Response Body||Response Codes|
|application/json||User device details with property||200, 400, 403, 404, 500|
Example Request Data
The following example displays a request.
Authorization: Bearer <JWT token>
The Device Details request does not contain any parameters.
The resource identifier <userId> is a unique user identifier that is sent in the response to the Device Details API.
The following example response shows the status of a single user's device.
"osType": "FIDO Token",
Property Response Descriptions
The following table shows property response descriptions and data types.
|id||Identifies the device.||String|
|userId||Identifies the user associated with this device.||String|
|osType||Operating system information related to the device, browser, or FIDO token.||String|
registeredDate (for FIDO token)
Timestamp when the device was registered.See https://www.w3.org/TR/NOTE-datetime for information on formatting timestamps in ISO 8601 format.
Timestamp when the FIDO token was registered. For FIDO tokens, the following fields are created:
|lastUsedDate||Timestamp when the device was last used. See https://www.w3.org/TR/NOTE-datetime for information on formatting timestamps in ISO 8601 format.||String|
The following table shows response codes and descriptions for the Device Details API.
|200||User and device are successfully found.|
|400||User ID is not provided as parameter.|
|403||Not authorized to perform the request.|
|404||User and/or device is not found.|
|500||Internal error occurred when processing the request.|