Creating an API connection in MDR Web Console
April 11, 2024
ID 258278
A refresh token is a unique sequence of letters, digits, and symbols. Once created, a refresh token allows you to create an access token.
To create a refresh token:
- In the MDR Web Console window, navigate to the Settings menu item.
- Click the API tab.
The All tokens list appears.
- In the upper part of the window, click the Add button.
The Generate token block appears.
- Specify the following settings:
- Connection name
The name of a token.
The name of a token can contain Latin letters, digits, and special characters. The name of a token is specified as
author_name
in REST API responses and displayed as the comment author on the Communication tab of an incident.If you activated Kaspersky Managed Detection and Response with the MDR Optimum or MDR Basic license, this is the only available field while creating a refresh token.
- User role
The user role to specify permissions that will be granted for performing actions via the HTTP API.
The following user roles are available:
- Tenant
If necessary, select the value (or values) in the Tenant drop-down list.
The tenants already existing in Console and the Root without tenants value are suggested.
The user can view only the assets and incidents related to the specified tenants. If you have assets and incidents not assigned to any tenants, the user can view them if you select the Root without tenants value.
You can select the Root without tenants value, in addition to specifying tenant names.
- Connection name
- In the lower part of the block, click the Generate button.
The Token info block replaces the Generate token block.
- Click the Close button in the lower part of the Token info block.
The refresh token that you have created appears in the All tokens list. Now, you can use this refresh token to create an access token.