This operation authenticates a user in the platform and returns an access token that is used to authorize other API requests. Normally, the Single Sign On (SSO) users log into the Reltio platform with the Corporate IdP.

1. Open POSTMAN and open a new tab to enter the API endpoint and body of the API that you want to call, if required. In the Authorization tab, select Type as OAuth 2.0 and select Get New Access Token.
   
2. Enter the following details in Get New Access Token and select Request Token:
   • Grant Type- Select Authorization Code
   • Callback URL- https://{environment}.reltio.com/oauth/callback
   • Auth URL- https://auth.reltio.com/oauth/sso?tenant_id='sso_tenant'
   • Access Token URL- https://auth.reltio.com/oauth/token
   • Client ID- Reltio Client ID
   • Client Secret- Reltio Client Secret
   • Client Authentication- Select Send client credentials in body

   Note: You can leave Scope blank but State must contain a value.

   

   Note: You must create a Support Ticket to request for creation of a Reltio Client to receive the Client ID and Client Secret.
3. A new window with configured Idp's login opens. Log in with your Idp credentials.
   
4. After a successful sign in, POSTMAN displays the access token in Manage Access Tokens, as shown below. Scroll to the end and select Use Token.
   
   Note: The length of the access_token / refresh_token must be within 400 characters.
5. POSTMAN sets the access token in the Authorization Header. Select Sen to send the API request.