TrueSight Orchestration Login and Logout calls
Logs the user in and out of the
server.
This topic includes the following sections:
For an overview of logging into the API server, getting an authentication token, and logging out, see Logging-into-the-API-server.
For more information about request and response headers, see HTTP request and response headers.
Login
Request
HTTP method: POST
URL: https://<hostname>:<port>/<baocdp|baoap>/rest/login
This is the URL for the
component you are accessing. It includes the host name, corresponding port, and
component (CDP or AP).
Request body properties
Property | Description |
|---|---|
username | User name |
password | Password |
Example request JSON
Host: <hostname>:<port>/baocdp
Request Headers
Content-type: application/json
{
"username" : "<yourUsername>",
"password" : "<yourPassword>"
}
Response
If successful, this method logs you into the API server and returns an authentication token.
Response body properties
Property | Description |
|---|---|
login | Login request status |
Example response JSON
Status Code: 200 OK
Strict-Transport-Security: max-age=31536000; includeSubDomains
Cache-Control: no-store
X-Content-Type-Options: nosniff
Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://*
Pragma: no-cache
X-XSS-Protection: 1; mode=block
Set-Cookie: JSESSIONID=FXV7890B4116; Path=/baocdp; Secure;
HttpOnly
Set-Cookie: Authentication-Token=/DwG7trv/o0Ep/tyb/wyx678/cftsOxrp/kwx=;
Domain=clm-pun-foo.com; Path=/baocdp; Secure; HttpOnly
Authentication-Token: <Masked String>
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Wed, 30 Jun 2021 05:40:17 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Server: platform-web-server
Response Body:
{
"login":"true"
}
From the response header, save the text string returned in the Authentication-Token line. That text string is your authentication token, which you need to include in future requests.
For example, in the previous response, the following line is the authentication token:
Login status codes and messages
For more details about HTTP response codes, see HTTP response codes.
HTTP code | Message | Description |
|---|---|---|
200 | OK | Request succeeded |
400 |
| Bad request An error occurred while logging in. |
401 |
| Unauthorized |
405 |
| Method not allowed |
Logout
Request
HTTP method: POST
URL: https://<hostname>:<port>/<baocdp|baoap>/rest/logout
This is the URL for the
component you are accessing. It includes the host name, corresponding port, and
component (CDP or AP).
Request body properties
Property | Description |
|---|---|
Host | The API server URL |
Authentication-Token | The text string that is your authentication token |
Example request JSON
Host: <hostname>:<port>/baocdp
Authentication-Token: /DwG7gAAAAAAAAAASSIUSHVVSysr/3fHRkbS9sJdUeGqHdbliWdOloDrSntnkZKnZZmXveOpKFWtZCLX/oSJv1UgJDp38Cc2fe8FhZe1xl2+LlmoYJEo4ouBnZaCA8M8kNY+04icmspDSYJnsDoa3bCFK/
xvyR3xrux3zZxEPrxnI1/5dxKy0MJqrO4RYq6QIl+Pz+JwTwZuvD9mv1xli0HL3ffqYmLBMpLJv9aegihLUsKWAV4xRCBvZbzlQQh3UFFDtVDMjkx0TFYbQg8aa30zk7ZB8nCQdQfm5pyNJdkVHo5ApObo610AHHz79P0TLsWN0pjQMQwrJNtC
Response
If successful, this method logs you out of the API server.
Response body properties
Property | Description |
|---|---|
logout | Logout request status |
Example response JSON
Status Code: 200 OK
X-Frame-Options: DENY
Strict-Transport-Security: max-age=31536000;includeSubDomains
Cache-Control: no-store
X-Content-Type-Options: nosniff
Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://*
Pragma: no-cache
X-XSS-Protection: 1; mode=block
Set-Cookie: JSESSIONID=BXTAD20814X; Path=/baocdp; Secure; HttpOnly
Set-Cookie: Authentication-Token=/DrWrSys/3l7NG3b/xyrl/0xSZh345CX/MTOprx/kwCMK=;Max-Age=0; Expires=Thu, 01-Jan-1970 00:00:10 GMT; Domain=foo.bmc.com; Path=/baocdp
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Wed, 30 Jun 2021 05:43:34 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Server: platform-web-server
Response Body:
{
"logout": "true"
}
Logout status codes and messages
For more details about HTTP response codes, see HTTP response codes.
HTTP code | Message | Description |
|---|---|---|
200 | OK | Request succeeded |
400 |
| Bad request An error occurred while logging out. |
401 |
| Unauthorized |
405 |
| Method not allowed |
Related topics