RSA SecurID Access Device Details API

Document created by RSA Information Design and Development on Oct 19, 2018
Version 1Show Document
  • View in full screen mode

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.

Authentication

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.

Request Requirements

Use the following information to retrieve information about a particular user's device.

                        
MethodRequest URLResponse Content TypeResponse BodyResponse Codes
GET /AdminInterface/restapi/v1/users/
<userId>/devices
application/jsonUser device details with property200, 400, 403, 404, 500

Example Request Data

The following example displays a request.

GET /AdminInterface/restapi/v1/users/<userId>/devices

Accept: application/json

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.

Example Response

The following example response shows the status of a single user's device.

{

"id": "3a48a1a5-444c-4c95-b3f0-b5aa8273a019",

"name": "john.doe%40rsa.com's%20FIDO%20token",

"userid": "e71d6d46-0113-495a-9445-b3f71b6e3f36",

"osType": "FIDO Token",

"capabilities": null,

"registeredDate": "2018-09-06T15:34:44.000Z",

"lastUsedDate": "2018-09-06T15:34:44.000Z"

}

Property Response Descriptions

The following table shows property response descriptions and data types.

                                           
PropertyDescriptionData Type
idIdentifies the device.String
nameDevice name.String
userIdIdentifies the user associated with this device.String
osTypeOperating system information related to the device, browser, or FIDO token.String

registeredDate

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:
_at
registration_time

String
lastUsedDateTimestamp when the device was last used. See https://www.w3.org/TR/NOTE-datetime for information on formatting timestamps in ISO 8601 format.String

Response Codes

The following table shows response codes and descriptions for the Device Details API.

                               
CodeDescription
200User and device are successfully found.
400User ID is not provided as parameter.
403Not authorized to perform the request.
404User and/or device is not found.
500Internal error occurred when processing the request.

 

 

You are here
Table of Contents > Cloud Administration REST APIs > RSA SecurID Access Device Details API

Attachments

    Outcomes