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:
- From the Console, select Client Credentials.
- 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.- In the Client ID field, enter the unique identifier for the client.
- In the Description field, enter the client description.
- 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.
- 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>"
andpassword:"<client_secret>"
.
By default, both the methods are selected.
- Basic - Sends credentials to the Auth0 server as a header. For example,
- In the Access Token Validity field, enter the number of seconds for which the access token is considered valid, in seconds.
- 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.
- In the Contact name field, enter the name of the contact person responsible for the application client.
- In the Contact email field, enter the email address of the contact person responsible for the application client.
- In the Roles section, select the roles associated with this client and the tenants to associate with each role.
- Select the + Add Role button to add a new rol in the table.
- 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.
- 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.