Darktrace Authentication Guide

How to authenticate Darktrace for use with Tines

Rosie Halpin avatar
Written by Rosie Halpin
Updated over a week ago

Connect Tines to Darktrace to create powerful automations with the below authentication guide.

First, get the relevant credentials needed in Darktrace

To authenticate Darktrace for use with Tines, you will need the following:

  • Public token

  • Private token

  • Darktrace domain

Public and private tokens can be generated on a per-user basis or via Global tokens. For further details, visit Darktrace's Authentication Info Page.

Then, create a Darktrace credential in Tines

Darktrace connect flow (recommended):

  1. Login to your Tines tenant

  2. Navigate to the team that will be using the API and click "Credentials"

  3. Click "+ New Credential" and select "Darktrace" and follow the prompts to connect.

Manual credential creation

This method is not recommended as the Darktrace connect flow creates this credential with much less complexity. However, if you need to create this credential set manually, see the following steps below:

  1. Click "+ New Credential" and select "Text"

  2. Input the values for the Darktrace credential

    1. Name: Required

    2. Description: Optional

    3. Value: Your private token

    4. Metadata: Enable metadata and add the below metadata:

      {
      "domain": "your Darktrace domain",
      "public_token": "your Darktrace public token"
      }

      This will allow you to reference the credential's metadata via the INFO key. This is also used in our templates.

  3. Optional

    1. Domains: Ensure this credential can only be used when making HTTP requests to specific domains. As Darktrace uses signature based authentication, the secret is used to create a signature and cannot have a restricted domain. Do not enter a value for this field.

    2. Access: What other teams can also use the credential.

Read about our connect flows here.

For more on creating credentials in Tines, click here.

Did this answer your question?