Kaspersky Managed Detection and Response

Creating an API connection in MDR Web Console

February 12, 2024

ID 258278

Expand all | Collapse all

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:

  1. In the MDR Web Console window, navigate to the Settings menu item.
  2. Click the API tab.

    The All tokens list appears.

  3. In the upper part of the window, click the Add button.

    The Generate token block appears.

  4. 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:

      • MDR Administrator
      • Senior Security Officer
      • Security Officer
    • 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.

  5. In the lower part of the block, click the Generate button.

    The Token info block replaces the Generate token block.

  6. 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.

Did you find this article helpful?
What can we do better?
Thank you for your feedback! You're helping us improve.
Thank you for your feedback! You're helping us improve.