Login API

Owned by sneha.tripathi
Mar 08, 2022
1 min read

Luma Knowledge Login API is used to generate Access Tokens to authenticate and authorize an application to connect to Luma Knowledge. Using the token, third-party systems or applications can connect to Luma Knowledge to perform various actions such as Artifact search, Artifact import, Artifact sync, User sync, etc. The API uses tenant login credentials (username, password, and tenant name) as input parameters and generates an Authorization token as a response. You can pass the token as a Header to other Luma Knowledge Web services to connect to your tenant.

The Authorization Token is valid only for 15 mins. The Login API should be used to create a new token before using any other Luma Knowledge API.

You may use the following details to set up the Web service.

  1. URI: /api/auth/login

  2. HTTP Method for the operation: POST

  3. Pass the following as Header to the API:

    1. Content-Type: application/json

    2. ClientType:Ajax

    3. Accept: application/json

    4. X-Requested-With:XMLHttpRequest

  4. Pass the login credentials in Outbound Payload or Request to the Web Service. The request is passed in the following JSON format.

    { "username":"<username>", "password":"<password>", "subdomain":"<tenantname>" }

  5. For successful logins, the web service returns the Authorization token as the response in the following format.

    { "token":"eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJzcmluaXZhcyIsImNvbnRhY3RUeXBlIjoiVEVOQU5UIiwidGVuYW50RXh0ZXJuYWxJZCI6IjhmMGFlZGRlLWQyNzctNGQxYy1hYTUzLTk1ZjYzZTViNzRlNyIsInN1YlRlbmFudElkIjoxLCJjb250YWN0SWQiOjUsInNjb3BlcyI6WyJBVVRIX0FETUlOSVNUUkFUT1IiXSwibG9jYWxlIjoiZW5fVVMiLCJpc3MiOiJodHRwOi8va21zLmx1bWEuc2VydmljZWFpZGUuY29tIiwiaWF0IjoxNjQ2NzI2NzE5LCJleHAiOjE2NDY3Mjc2MTl9.ziH9d5rwSGMd9XgjblPnH-1aVSUE8V-YYS93XUKzRt-oxKp5rT4JGlGeyCcF6_I88tSCBSLAcQgHAKlGbQ9ofQ","refreshToken":"eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJzcmluaXZhcyIsImNvbnRhY3RUeXBlIjoiVEVOQU5UIiwidGVuYW50RXh0ZXJuYWxJZCI6IjhmMGFlZGRlLWQyNzctNGQxYy1hYTUzLTk1ZjYzZTViNzRlNyIsInN1YlRlbmFudElkIjoxLCJjb250YWN0SWQiOjUsInNjb3BlcyI6WyJST0xFX1JFRlJFU0hfVE9LRU4iXSwibG9jYWxlIjoiZW5fVVMiLCJpc3MiOiJodHRwOi8va21zLmx1bWEuc2VydmljZWFpZGUuY29tIiwianRpIjoiYWRmZDhlZmYtZmEwMS00NjdmLTkzOWMtMjU4ZGI2MWViNzIxIiwiaWF0IjoxNjQ2NzI2NzE5LCJleHAiOjE2NDY3MzAzMTl9******************" }