> 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

## Überblick

Die Darktrace-Integration ermöglicht es Dispel, die Geräte abzurufen, die Darktraces selbstlernende KI in Ihrem Netzwerk entdeckt hat, und sie als Dispel-Geräte zu übernehmen, angereichert mit den Verhaltensdetektionen von Darktrace. Sie verbinden sich einmal mit Ihrer Darktrace-Instanz, ordnen sie einer Dispel-Einrichtung und einem Wicket zu, und Dispel importiert die passenden Geräte und hält sie mit einer wiederkehrenden Synchronisierung aktuell.

Darktrace ist eine Cloud-Integration zur Asset-Erkennung. Dispel authentifiziert sich beim ActiveAI Security Portal und liest über Darktraces Cloud-API aus Darktrace aus, und zwar ausschließlich im Lesezugriff. Sie weisen Dispel auf Ihre Darktrace-Master-URL hin; Dispel leitet daraus Ihren Instanznamen ab und erreicht die API über Darktraces Cloud-Proxy.

Da ein Darktrace-Master eine einzelne Umgebung repräsentiert, behandelt Dispel ihn als einen Standort, den Sie einem einzelnen Wicket zuordnen — es gibt keine standortbezogene Liste, die abgearbeitet werden müsste.

#### Was Dispel importiert

* Von Darktrace entdeckte Geräte, die anhand von IP- und MAC-Adresse Ihren bestehenden Dispel-Geräten zugeordnet und dort, wo es keine Übereinstimmung gibt, als neue Geräte importiert werden.
* Darktrace Model Alerts (seine Verhaltensdetektionen) als Findings auf den passenden Geräten, wobei der Schweregrad aus der Kategorie des Modells abgeleitet wird.
* Eine umfassende Geräteansicht: ein „Von Darktrace angereichert“-Badge, ein Deep-Link zum Gerät im Darktrace Threat Visualizer und ein Darktrace-Bereich, der den Status von Autonomous Response (Antigena), Geräteintelligenz, Konnektivität und einen Verhaltens-Risikowert anzeigt.

{% hint style="info" %}
**Wo Sie es finden.** Melden Sie sich als Organisationsadministrator an und öffnen Sie **Einstellungen → Integrationen**. Darktrace erscheint in der **Bereich Asset Discovery / Network Visibility** . Klicken Sie **Verbinden** auf der Darktrace-Karte, um zu beginnen.
{% endhint %}

## Bevor Sie beginnen

Sie benötigen Folgendes von Darktrace:

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

{% hint style="warning" %}
**Verwenden Sie die Anmeldedaten der ActiveAI-Client-Anwendung — keine Legacy-Tokens.** Die Cloud von Darktrace erfordert die Anmeldedaten der Client-Anwendung (OAuth2) aus dem ActiveAI Security Portal. Das ältere API-Token-/Secret-Paar des Threat Visualizers wird nicht authentifiziert.
{% endhint %}

{% hint style="info" %}
**Das Client-Secret wird nur einmal angezeigt.** Darktrace zeigt das Secret nur an, wenn die Client-Anwendung erstellt wird. Kopieren Sie es dann; falls Sie es verlieren, erstellen Sie eine neue Client-Anwendung.
{% endhint %}

## Darktrace verbinden

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

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

4. Klicken Sie auf **Verbindung testen** um zu bestätigen, dass Dispel sich authentifizieren kann. Beheben Sie jeden 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 gegen ein kurzlebiges Token am ActiveAI-Autorisierungsserver aus und ruft die Darktrace-API über den `api.darktrace.com` Cloud-Proxy auf, wobei die aus Ihrer Master-URL abgeleitete Instanz verwendet wird. Tokens werden automatisch erneuert.
{% endhint %}

{% hint style="info" %}
**Ihre Anmeldedaten sind verschlüsselt.** Das Client-Secret wird im Ruhezustand verschlüsselt und nach dem Speichern nie wieder angezeigt. Wenn Sie später bearbeiten, lassen Sie die Anmeldefelder leer, um die gespeicherten Werte beizubehalten.
{% endhint %}

## Die Instanz dem Wicket zuordnen

Sobald die erste Synchronisierung abgeschlossen ist, öffnen Sie die Integration, um den **Bereich Standortzuordnung** Abschnitt. Darktrace erscheint als ein einzelner Standort, der Ihre Instanz repräsentiert.

> Ordnen Sie jeden Anbieter-Standort einer Dispel-Einrichtung und einem Wicket zu. Geräte aus zugeordneten Standorten werden in Dispel synchronisiert.

1. Wählen Sie ein **Facility**.
2. Wählen Sie ein **Wicket**. Wenn die Einrichtung nur ein Wicket hat, wählt Dispel es für Sie aus.
3. Klicken Sie auf **Zuordnungen speichern & importieren**.

Dispel importiert Darktrace-Geräte in das zugeordnete Wicket — Sie sehen, wie der Fortschritt von „wartet“ zu „abruft“ zu „synchronisiert“ zu „abgeschlossen“ wechselt — und meldet dann, wie viele Geräte importiert wurden. Importierte Geräte erscheinen im zugeordneten Wicket zusammen mit allen Geräten, die Sie manuell hinzugefügt haben, mit ihrer Darktrace-Anreicherung und den Model Alerts.

## Ihr Inventar aktuell halten

* Dispel führt automatisch regelmäßige erneute Synchronisierungen durch, sodass neu entdeckte Geräte, geänderte Details und neue Model Alerts ohne Ihr Zutun übernommen werden.
* Um das neueste Inventar sofort abzurufen, öffnen Sie die Integration und wählen Sie **Aktualisieren**.
* Um Verbindungsdetails zu ändern oder Anmeldedaten zu rotieren, bearbeite die Integration und verwende **Speichern & synchronisieren**. Lassen Sie die Anmeldefelder leer, um das aktuelle Client-Secret beizubehalten.

Model-Alert-Findings werden bei jeder Synchronisierung aktualisiert, und Warnungen, die Darktrace nicht mehr meldet, fallen automatisch weg.

## Verbindungsstatus

Jede Integration zeigt einen Status, damit Sie immer wissen, wie es 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 ist 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**      | Zuordnungsänderungen sind gespeichert, aber noch nicht angewendet.                       |
| **Wird angewendet**             | Geräte für Ihre gespeicherte Zuordnung werden importiert.                                |
| **Fehlgeschlagen**              | Der letzte Vorgang ist fehlgeschlagen — siehe die Fehlerhinweise.                        |

Ein separates **Status-Badge** (Verbunden, Beeinträchtigt, Nicht erreichbar) gibt an, ob Dispel die Darktrace-API derzeit erreichen kann.

## Fehlerbehebung

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

| Fehler                                    | Was es normalerweise bedeutet und wie Sie es beheben                                                                                                                                                                                                                 |
| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Authentifizierung fehlgeschlagen**      | Die Client-ID oder das Client-Secret wurden abgelehnt. Bestätigen Sie, dass die Client-Anwendung im ActiveAI Security Portal aktiv ist und dass das Secret aktuell ist — es wird nur einmal angezeigt, also erstellen Sie die Anwendung neu, falls es verloren ging. |
| **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 — normalerweise ein vorübergehendes Netzwerkproblem; versuchen Sie es erneut.                                                                                                                                      |
| **Konfigurationsfehler**                  | Die Master-URL scheint falsch zu sein. Sie muss Ihre Darktrace-Cloud-Master-URL sein (zum Beispiel `https://your-instance.cloud.darktrace.com`); Dispel leitet daraus den Instanznamen ab.                                                                           |

## Häufig gestellte Fragen

<details>

<summary>Welche Anmeldedaten verwende ich — ActiveAI oder die Legacy-API-Tokens?</summary>

Verwenden Sie die Anmeldedaten der Client-Anwendung im ActiveAI Security Portal (eine Client-ID und ein Client-Secret, erstellt unter **Client-Anwendungen verwalten**). Die Cloud von Darktrace erfordert den OAuth2-Client-Credentials-Flow; das ältere Threat-Visualizer-API-Token-/Secret-Paar wird nicht authentifiziert.

</details>

<details>

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

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

</details>

<details>

<summary>Welche Findings übernimmt Darktrace in Dispel?</summary>

Darktraces Model Alerts — seine Verhaltensdetektionen — werden als Findings an die passenden Geräte angehängt, wobei der Schweregrad aus der Modellkategorie abgeleitet wird. Dabei handelt es sich um Verhaltensdetektionen und nicht um CVE-basierte Schwachstellen.

</details>

<details>

<summary>Triggert oder verändert Dispel Autonomous Response (Antigena)?</summary>

Nein. Die Integration ist nur lesend. Dispel zeigt den Antigena-Status als Teil der Geräteanreicherung an, löst jedoch niemals Autonomous-Response-Aktionen in Darktrace aus, ändert sie nicht und setzt sie nicht zurück.

</details>

<details>

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

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

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