Document toolboxDocument toolbox

Authentication tokens

Overview

In the Administration → Credentials → Authentication tokens area, you can manage the existing tokens in your domain or generate new ones. You can create tokens to authorize requests to our Devo APIs or to send data using an HTTP endpoint.

OData tokens

Apart from the tokens generated in this area, this area also displays the OData tokens generated in the search window. Learn more about OData feeds in this article.

What permissions do I need?

To access this area to create and manage tokens, you need to have the Manage version of the corresponding token permission (see picture below). With the View version you can only check existing tokens (more info about permissions here).

Having view permissions for one token type is enough to grant you access to this area but you will not be able to see the other token types unless you also have the corresponding permissions for each of them.

Create a new token

Click the Create token button at the top right of this area to generate a new token. Fill the fields in the window that appears:

The token will now appear in the table of this area. To copy the generated token to your clipboard, click its name in the table and copy it from the window that appears.

Manage tokens

All the tokens generated in the domain will appear in the table of this area. Click the ellipsis button that appears at the end of a token in the table to access the following actions:

More info

Click to see the details of the token. Alternatively, you can click its name in the table.

In the Token info window that appears, you can change the name of the token, copy the token and its associated scope to your clipboard, and add tags to it. You can later filter the token list by tags to find your tokens easily.

Disable / Enable

Click to disable/enable the selected token. The color in the Status column of the table shows if the token is enabled (green) or disabled (red).

Alternatively, you can check one or several tokens from the table and click the icon that appears at the top of the table.

 

Delete

Click to delete the token from the domain.

Alternatively, you can check one or several tokens from the table and click the trash icon that appears at the top of the table.

Filter tokens

You can use the options at the top of the table to filter the list of tokens as required according to different parameters:

  • Use the time buttons to display only tokens created during the last hour, day, etc. By default, the selected option is All.

  • Filter tokens by status. The available options are All (default), Disabled and Enabled.

  • Filter tokens by specific characteristics. Open the dropdown menu next to the search box to select the required parameter (Tags, Type, Name, Owner, Scope, Token and Authorized User) and enter the value to filter by in the search box. Note that you must enter complete values, and not part of them.

Important considerations

  • Tokens assigned to a deleted user will be reassigned to the domain owner and remain enabled. We recommend disabling them if these credentials are known or accessible by an undesired person.

  • Tokens assigned to a disabled user will remain enabled and still assigned to that user.