Authentication

Listener authenticates users based on LDAP configuration. To use a REST endpoint, you must be part of a valid Listener LDAP domain and log into Listener to obtain a token.

Definition

POST https://listener-app-services.teradata.com/v1/users/login HTTP/1.1
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD"
}

Example Request

curl \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{"username": "USERNAME", "password": "PASSWORD"}' \
  -i \
  https://listener-app-services.teradata.com/v1/users/login

Example Response

HTTP/1.1 200 OK
Content-Type: application/json
{
  "display_name": "name",
  "email": "email",
  "id": "username",
  "member_of": "member of list",
  "site_admin":true,
  "token":"unique token"
}

Response Codes

CodeDescription
200User successfully logged in and obtained a token.
401User credentials cannot be validated.
500LDAP is not configured or reachable.

results matching ""

    No results matching ""