Chat now with support
Chat with Support

Identity Manager 9.1.2 - REST API Reference Guide

Login

To use the One Identity Manager REST API, you first have to authenticate against the application server.

Table 5: Authenticate request

HTTP method

URI

Body

Post

<BaseURL>/auth/apphost

Property authString containing an authentication string. For more information, see Initial data for authentication modules.

Body schema:

{"authString": String}

Response schema:

{

"claims": {

"id": String,

"useruid": String,

"module": String

},

"passwordBased": Boolean,

"moduleDisplay": String,

"sessionId": String,

"userName": String,

"responseStatus": {}

}

Example:

https://<Hostname>/AppServer/auth/apphost

Body:

{"authString":"Module=DialogUser;User=<user name>;Password="}

Response:

{

"claims": {

"id": "<user name>",

"useruid": "QBM-A60F9E5189134AFFB6711DFCBC3F260E",

"module": "DialogUser"

},

"passwordBased": true,

"moduleDisplay": "System user",

"sessionId": "nV8R3iw4KfmEiZydA3uy",

"userName": "<user name>",

"responseStatus": {}

}

Logout

If you want to end your session against the One Identity Manager REST API you can use the logout request.

Table 6: Logout request

HTTP method

URI

Body

Post

<BaseURL>/auth/logout

 

Response schema:

{"responseStatus": {}}

Example:

https://<Hostname>/AppServer/auth/logout

Response:

{"responseStatus": {}}

Date formats

If date values have to be specified in requests for changing or adding objects using the REST API, these have to be specified in the ISO 8601 format in UTC.

Example:

2016-03-19T13:09:08.123Z, which is March 19, 2016, 1:09:08.123 PM UTC

Object identifiers

The requests and responses use identifiers for identifying the objects from One Identity Manager. Every time an object is created, the system internally generates a globally unique identifier (GUID). These GUIDs can be used to fetch single objects directly using the API.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating