> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-de/integrieren-and-administrieren/integrations/asset-discovery/darktrace.md).

# Darktrace

Verbinden Sie Darktrace über die ActiveAI Security Portal API, um erkannte Geräte in Dispel zu übernehmen — angereichert mit Verhaltens-Model-Alerts und einem Deep Link zum Threat Visualizer — zugeordnet zu einem Wick

## Übersicht

Mit der Darktrace-Integration kann Dispel die Geräte abrufen, die Darktraces selbstlernende KI in Ihrem Netzwerk entdeckt hat, und sie als Dispel-Geräte übernehmen, ergänzt um Darktraces Verhaltenserkennungen. Sie verbinden sich einmalig mit Ihrer Darktrace-Instanz, ordnen sie einer Dispel-Einrichtung und einem Wicket zu, und Dispel importiert die passenden Geräte und hält sie durch regelmäßige Synchronisierung aktuell.

Darktrace ist eine Cloud-Integration zur Erkennung von Assets. Dispel authentifiziert sich beim ActiveAI Security Portal und ruft Daten über Darktraces Cloud-API ab; es werden ausschließlich Daten gelesen. Sie geben Dispel die Master-URL Ihrer Darktrace-Instanz an. Dispel leitet daraus den Namen Ihrer Instanz ab und greift über Darktraces Cloud-Proxy auf die API zu.

Da ein Darktrace-Master eine einzelne Umgebung repräsentiert, behandelt Dispel ihn als einen Standort, den Sie einem einzelnen Wicket zuordnen. Es gibt keine Liste einzelner Standorte, die Sie durchgehen müssen.

#### Was Dispel importiert

* Von Darktrace entdeckte Geräte, die anhand von IP- und MAC-Adresse Ihren vorhandenen Dispel-Geräten zugeordnet und als neue Geräte importiert werden, wenn es keine Übereinstimmung gibt.
* Darktrace Model Alerts (Verhaltenserkennungen von Darktrace) als Befunde auf den passenden Geräten; der Schweregrad wird aus der Kategorie des Modells abgeleitet.
* Eine umfassende Geräteansicht: ein Badge „Mit Darktrace angereichert“, ein direkter Link zum Gerät im Darktrace Threat Visualizer und ein Darktrace-Bereich mit dem Status von Autonomous Response (Antigena), Geräteinformationen, Konnektivität und einem Verhaltensrisikowert.

{% hint style="info" %}
**Wo Sie die Integration finden.** Melden Sie sich als Organisationsadministrator an und öffnen Sie **Einstellungen → Integrationen**. Darktrace finden Sie im Bereich **Asset-Erkennung / Netzwerktransparenz** . Klicken Sie auf **Verbinden** auf der Darktrace-Karte, um zu beginnen.
{% endhint %}

## Vorbereitung

Sie benötigen folgende Angaben von Darktrace:

* Eine im ActiveAI Security Portal unter **Client Applications verwalten**erstellte Client-Anwendung. Beim Erstellen erhalten Sie eine **Client-ID** und ein **Client-Secret**.
* Die **Darktrace-Master-URL** Ihrer Instanz, zum Beispiel `https://usw1-00000-01.cloud.darktrace.com`.

{% hint style="warning" %}
**Verwenden Sie die Zugangsdaten der ActiveAI-Client-Anwendung, keine älteren Tokens.** Darktraces Cloud erfordert die Zugangsdaten der Client-Anwendung (OAuth2) aus dem ActiveAI Security Portal. Das ältere API-Token-/Secret-Paar für den Threat Visualizer kann nicht zur Authentifizierung verwendet werden.
{% endhint %}

{% hint style="info" %}
**Das Client-Secret wird nur einmal angezeigt.** Darktrace zeigt das Secret nur beim Erstellen der Client-Anwendung an. Kopieren Sie es dann. Wenn Sie es verlieren, erstellen Sie eine neue Client-Anwendung.
{% endhint %}

## Darktrace verbinden

1. Gehen Sie zu **Einstellungen → Integrationen** und klicken Sie auf **Verbinden** auf der Darktrace-Karte.
2. Optional können Sie einen **Anzeigenamen** festlegen, um diese Integration von anderen zu unterscheiden (Sie können mehrere Instanzen verbinden).
3. Füllen Sie die Verbindungsfelder aus:

| Feld                     | Typ           | Hinweise                                                                                                                                          |
| ------------------------ | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Darktrace-Master-URL** | Konfiguration | Die Master-URL Ihrer Darktrace-Instanz, z. B. `https://your-instance.cloud.darktrace.com`. Dispel leitet daraus den Instanznamen ab.              |
| **Client-ID**            | Anmeldedaten  | Die Client-ID einer im ActiveAI Security Portal erstellten Client-Anwendung.                                                                      |
| **Client-Secret**        | Anmeldedaten  | Das Client-Secret, das beim Erstellen der Client-Anwendung einmalig angezeigt wird. Es wird verschlüsselt gespeichert und nicht erneut angezeigt. |

4. Klicken Sie auf **Verbindung testen** , um zu bestätigen, dass Dispel sich authentifizieren kann. Beheben Sie alle gemeldeten Fehler, bevor Sie speichern.
5. Klicken Sie auf **Speichern**. Dispel speichert die Integration und führt sofort die erste Synchronisierung aus.

{% hint style="info" %}
**So funktioniert die Verbindung.** Dispel tauscht Ihre Client-ID und Ihr Client-Secret beim ActiveAI-Autorisierungsserver gegen ein kurzlebiges Token ein und ruft die Darktrace-API über `api.darktrace.com` Cloud-Proxy, wobei die Instanz aus Ihrer Master-URL abgeleitet wird. Tokens werden automatisch aktualisiert.
{% endhint %}

{% hint style="info" %}
**Ihre Anmeldedaten sind verschlüsselt.** Das Client Secret wird im Ruhezustand verschlüsselt und nach dem Speichern nie wieder angezeigt. Lassen Sie beim späteren Bearbeiten die Anmeldedatenfelder leer, um die gespeicherten Werte beizubehalten.
{% endhint %}

## Die Instanz einem Wicket zuordnen

Sobald die erste Synchronisierung abgeschlossen ist, öffnen Sie die Integration, um den Abschnitt **Site-Zuordnung** zu finden. Darktrace wird als einzelne Site angezeigt, die Ihre Instanz repräsentiert.

> Ordnen Sie jeden Anbieterstandort einer Dispel-Einrichtung und einem Wicket zu. Geräte von zugeordneten Standorten werden mit Dispel synchronisiert.

1. Wählen Sie eine **Einrichtung**.
2. Wählen Sie ein **Wicket**. Wenn die Einrichtung nur ein Wicket hat, wählt Dispel es automatisch aus.
3. Klicken Sie auf **Zuordnungen speichern und importieren**.

Dispel importiert die Geräte von Darktrace in das zugeordnete Wicket. Der Fortschritt wechselt dabei von „Warten“ über „Abrufen“ und „Synchronisieren“ bis zu „Abgeschlossen“. Anschließend wird angezeigt, wie viele Geräte importiert wurden. Importierte Geräte erscheinen im zugeordneten Wicket neben allen manuell hinzugefügten Geräten – einschließlich der zugehörigen Darktrace-Anreicherungen und Model Alerts.

## Inventar aktuell halten

* Dispel führt regelmäßig automatisch eine erneute Synchronisierung durch. So werden neu entdeckte Geräte, geänderte Details und neue Model Alerts ohne Ihr Zutun übernommen.
* Um das Inventar sofort zu aktualisieren, öffnen Sie die Integration und wählen Sie **Aktualisieren**.
* Um Verbindungsdetails zu ändern oder Anmeldedaten zu erneuern, bearbeiten Sie die Integration und verwenden Sie **Speichern & synchronisieren**. Lassen Sie die Anmeldedatenfelder leer, um das aktuelle Client Secret beizubehalten.

Die Ergebnisse der Model Alerts werden bei jeder Synchronisierung aktualisiert. Alerts, die Darktrace nicht mehr meldet, werden automatisch entfernt.

## Verbindungsstatus

Jede Integration zeigt einen Status an, damit Sie jederzeit wissen, wie es um sie steht:

| Status                          | Bedeutung                                                                                |
| ------------------------------- | ---------------------------------------------------------------------------------------- |
| **Nicht initialisiert**         | Gespeichert, aber die erste Synchronisierung wurde noch nicht ausgeführt.                |
| **Wird initialisiert**          | Die erste Synchronisierung wird ausgeführt.                                              |
| **Bereit**                      | Verbunden und synchronisiert; die Zuordnung wurde angewendet.                            |
| **Aktualisierung erforderlich** | Neue Anbieterdaten sind verfügbar. Führen Sie eine Aktualisierung aus, um sie abzurufen. |
| **Wird aktualisiert**           | Eine Synchronisierung läuft.                                                             |
| **Ausstehende Änderungen**      | Änderungen an der Zuordnung wurden gespeichert, aber noch nicht angewendet.              |
| **Wird angewendet**             | Geräte werden anhand der gespeicherten Zuordnung importiert.                             |
| **Fehlgeschlagen**              | Der letzte Vorgang ist fehlgeschlagen – Hinweise zur Fehlerbehebung finden Sie hier.     |

Ein separates **Statussymbol** (Verbunden, Eingeschränkt, Nicht erreichbar) zeigt an, ob Dispel derzeit auf die Darktrace-API zugreifen kann.

## Fehlerbehebung

Wenn eine Synchronisierung oder ein Verbindungstest fehlschlägt, ordnet Dispel den Fehler ein und schlägt eine Lösung vor:

| Fehler                                    | Was dies normalerweise bedeutet und wie Sie das Problem beheben                                                                                                                                                                                                        |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Authentifizierung fehlgeschlagen**      | Die Client ID oder das Client Secret wurde abgelehnt. Vergewissern Sie sich, dass die Client-Anwendung im ActiveAI Security Portal aktiv ist und das Secret aktuell ist. Es wird nur einmal angezeigt. Wenn es verloren gegangen ist, erstellen Sie die Anwendung neu. |
| **Endpunkt nicht erreichbar**             | Dispel konnte Darktrace nicht erreichen. Überprüfen Sie, ob die Darktrace Master-URL korrekt ist.                                                                                                                                                                      |
| **Zeitüberschreitung bei der Verbindung** | Darktrace hat zu lange für eine Antwort gebraucht – meist handelt es sich um ein vorübergehendes Netzwerkproblem. Versuchen Sie es erneut.                                                                                                                             |
| **Konfigurationsfehler**                  | Die Master-URL scheint falsch zu sein. Es muss Ihre Darktrace-Cloud-Master-URL sein (zum Beispiel `https://your-instance.cloud.darktrace.com`). Dispel leitet den Instanznamen daraus ab.                                                                              |

## Häufig gestellte Fragen

<details>

<summary>Welche Anmeldedaten soll ich verwenden – ActiveAI oder die älteren API-Tokens?</summary>

Verwenden Sie die Anmeldedaten einer Client-Anwendung aus dem ActiveAI Security Portal (eine Client ID und ein Client Secret, die unter **Manage Client Applications**erstellt wurden). Für die Darktrace-Cloud ist der OAuth2-Client-Credentials-Flow erforderlich. Das ältere Paar aus Threat-Visualizer-API-Token und -Secret funktioniert nicht zur Authentifizierung.

</details>

<details>

<summary>Was ist die „Master-URL“?</summary>

Das ist die URL Ihrer Darktrace-Masterinstanz, zum Beispiel `https://usw1-00000-01.cloud.darktrace.com`. Dispel leitet Ihren Instanznamen daraus ab und leitet API-Anfragen über `api.darktrace.com`weiter. Sie müssen daher nur die Master-URL angeben.

</details>

<details>

<summary>Welche Ergebnisse bringt Darktrace in Dispel ein?</summary>

Die Model Alerts von Darktrace – also die verhaltensbasierten Erkennungen – werden den passenden Geräten als Ergebnisse zugeordnet. Der Schweregrad richtet sich nach der Modellkategorie. Dabei handelt es sich um verhaltensbasierte Erkennungen und nicht um CVE-basierte Schwachstellen.

</details>

<details>

<summary>Löst Dispel Autonomous Response (Antigena) aus oder ändert es diese?</summary>

Nein. Die Integration ist schreibgeschützt. Dispel zeigt den Antigena-Status als Teil der Geräteanreicherung an, löst Autonomous-Response-Aktionen in Darktrace jedoch niemals aus, ändert oder löscht sie.

</details>

<details>

<summary>Kann ich mehr als eine Darktrace-Instanz verbinden?</summary>

Ja. Darktrace unterstützt mehrere Integrationen, sodass Sie mehrere Instanzen parallel verbinden können. Geben Sie jeder einen eindeutigen **Anzeigenamen** , damit Sie sie unterscheiden können.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dispel.com/documentation/documentation-de/integrieren-and-administrieren/integrations/asset-discovery/darktrace.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
