Accelerate the Value of Data

Add new client

Learn how to add credentials for a new client.

You must be a customer administrator or be assigned the customer client management permissions to add new clients.
Note: We recommend you to create one client per use case so that the application or service using the credential can be easily identified and managed.
To create a new client:
  1. From the Console, select Client Credentials.
  2. In the Client Credentials page, select +CREATE NEW. You will see the Create new client page.
    Tip: The CREATE NEW button is available in the center of the page, only when there are no existing application clients.
    1. In the Client ID field, enter the unique identifier for the client.
    2. In the Description field, enter the client description.
    3. In the Client secret field, we recommend you leave it empty to get a secure randomly generated secret. This secret is known only to the application, system, or script authenticating with the Reltio API and the Reltio Authorization Server.
    4. In the Authentication methods field, select from the following options:
      • Basic - Sends credentials to the Auth0 server as a header. For example, Authorization: Basic <base64_encoded_credentials, where the encoded credentials are the client id and client secret.
      • Post - Sends credentials as part of the body in your request. For example, username:"<client_id>" and password:"<client_secret>".

      By default, both the methods are selected.

    5. In the Access Token Validity field, enter the number of seconds for which the access token is considered valid, in seconds.
    6. In the Authorization Grant type field, select the method to grant authorization to a user, which can be Client Credentials or Authorization Code. For more information, see topics Obtaining access tokens with client credentials grant type and Obtain an Access Token for SSO users.
    7. In the Contact name field, enter the name of the contact person responsible for the application client.
    8. In the Contact email field, enter the email address of the contact person responsible for the application client.
  3. In the Roles section, select the roles associated with this client and the tenants to associate with each role.
    1. Select the + Add Role button to add a new rol in the table.
    2. Hover your mouse over the line in the middle of the two columns and select the + button to open a list of tenants. Select the tenant or tenants to associate to the selected role.
  4. Select Save to create a new application client.
    Important: A secure, randomly generated client secret displays with a legend explaining that the client secret will be showed only once and cannot be restored if lost.

    Copy and save the client secret in a safe location and close the dialog box.