# Darktrace

## Connection Requirements

{% stepper %}
{% step %}

### URL

URL of the Darktrace (default: darktrace.example.com).
{% endstep %}

{% step %}

### Public and Private API Key

Public and private API Key associated with a user account that has the required permissions to fetch assets.

How to find the API tokens:

* Log in to Darktrace.
* From the left menu, select Admin -> System Config.
* From the Settings dialog in the left, select API Token. The public token is displayed on the right. To view the private token, click Remove.

Creating an account with API access permissions:

* Log in to the Darktrace Web app by using an Admin account.
* From the left menu, select Admin -> Permissions Admin.
* Click Account Create to create an account for API integration.
* Activate the newly created account by clicking the Flags icon on the right. A green icon confirms that the API access is enabled.
* Click Account Create to create an account for API integration.
  {% endstep %}

{% step %}

### SSL

Use SSL for connection (optional, default: True)
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Required Permissions

The value supplied in Public API Key and Private API Key must be associated with credentials that have API Access permissions.
{% endhint %}

{% hint style="warning" %}
Attention

Please perform a connection test to ensure there is a valid connection to the host.\
When the discovery operation is finalized, you will be able to see the details on the Assets page.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.octoxlabs.com/adapters/adapters/darktrace.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.