Zum Inhalt springen
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 die selbstlernende KI von Darktrace in Ihrem Netzwerk entdeckt hat, und sie als Dispel-Geräte zu übernehmen, angereichert um die Verhaltens-Erkennungen 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 bei einer wiederkehrenden Synchronisierung aktuell.

Darktrace ist eine Cloud-Asset-Discovery-Integration. Dispel authentifiziert sich im ActiveAI Security Portal und liest über die Cloud-API von Darktrace aus; es liest dabei ausschließlich daraus. Sie weisen Dispel Ihre Darktrace-Master-URL zu; Dispel leitet daraus Ihren Instanznamen ab und erreicht die API über den Darktrace-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 durchgearbeitet werden müsste.

Was Dispel importiert

  • Geräte, die Darktrace entdeckt hat, anhand von IP- und MAC-Adresse mit Ihren vorhandenen Dispel-Geräten abgeglichen und als neue Geräte importiert, wenn es keine Übereinstimmung gibt.

  • Darktrace Model Alerts (seine Verhaltens-Erkennungen) als Findings auf den passenden Geräten, wobei die Schwere aus der Kategorie des Modells abgeleitet wird.

  • Eine umfangreiche Geräteansicht: ein Badge „Von Darktrace angereichert“, ein Deeplink zum Gerät im Darktrace Threat Visualizer und ein Darktrace-Bereich, der den Status von Autonomous Response (Antigena), Geräteintelligenz, Konnektivität und einen Verhaltensrisiko-Score anzeigt.

Wo Sie es finden. Melden Sie sich als Organisationsadministrator an und öffnen Sie Einstellungen → Integrationen. Darktrace erscheint im Bereich Asset Discovery / Network Visibility Bereich. Klicken Sie Verbinden auf der Darktrace-Karte, um zu beginnen.

Vor dem Start

Sie benötigen Folgendes von Darktrace:

  • Eine Client-Anwendung, die im ActiveAI Security Portal unter Client-Anwendungen verwalten. Beim Erstellen erhalten Sie eine Client-ID und ein Client-Geheimnis.

  • Die Darktrace-Master-URL Ihrer Instanz — zum Beispiel https://usw1-00000-01.cloud.darktrace.com.

Das Client-Geheimnis wird nur einmal angezeigt. Darktrace zeigt das Geheimnis nur an, wenn die Client-Anwendung erstellt wird. Kopieren Sie es dann; wenn Sie es verlieren, erstellen Sie eine neue Client-Anwendung.

Darktrace verbinden

  1. Gehen Sie zu Einstellungen → Integrationen und klicken Sie auf Verbinden auf der Darktrace-Karte.

  2. Optional eine Anzeigename um diese Integration von anderen zu unterscheiden (Sie können mehr als eine Instanz verbinden).

  3. Füllen Sie die Verbindungsfelder aus:

Feld
Geben Sie
Hinweise

Darktrace-Master-URL

Konfiguration

Ihre Darktrace-Master-URL, 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-Geheimnis

Anmeldedaten

Das Client-Geheimnis, das beim Erstellen der Client-Anwendung einmal angezeigt wird. Es wird verschlüsselt gespeichert und nie wieder angezeigt.

  1. Klicken Sie auf Verbindung testen um zu bestätigen, dass Dispel sich authentifizieren kann. Beheben Sie alle gemeldeten Fehler vor dem Speichern.

  2. Klicken Sie auf Speichern. Dispel speichert die Integration und führt sofort die erste Synchronisierung aus.

So funktioniert die Verbindung. Dispel tauscht Ihre Client-ID und Ihr Client-Geheimnis gegen ein kurzlebiges Token beim ActiveAI-Autorisierungsserver aus und ruft die Darktrace-API über den api.darktrace.com Cloud-Proxy auf, wobei die Instanz aus Ihrer Master-URL abgeleitet wird. Tokens werden automatisch erneuert.

Ihre Anmeldedaten werden verschlüsselt. Das Client-Geheimnis wird im Ruhezustand verschlüsselt und nach dem Speichern nie wieder angezeigt. Wenn Sie später bearbeiten, lassen Sie die Anmeldedatenfelder leer, um die gespeicherten Werte beizubehalten.

Die Instanz einem Wicket zuordnen

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

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

  1. Wählen Sie eine Einrichtung.

  2. Wählen Sie eine 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 die Geräte von Darktrace in das zugeordnete Wicket — Sie sehen, wie der Fortschritt von Warten über Abrufen und Synchronisieren bis hin zu Abgeschlossen wechselt — und meldet dann, wie viele Geräte importiert wurden. Importierte Geräte erscheinen im zugeordneten Wicket neben allen Geräten, die Sie manuell hinzugefügt haben, mit ihrer Darktrace-Anreicherung und den Model Alerts.

Ihr Inventar aktuell halten

  • Dispel synchronisiert automatisch in regelmäßigen Abständen neu, 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, bearbeiten Sie die Integration und verwenden Sie Speichern & synchronisieren. Lassen Sie die Anmeldedatenfelder leer, um das aktuelle Client-Geheimnis beizubehalten.

Die Findings der Model Alerts werden bei jeder Synchronisierung aktualisiert, und Alerts, die Darktrace nicht mehr meldet, fallen automatisch weg.

Verbindungsstatus

Jede Integration zeigt einen Status an, damit Sie immer wissen, wo sie steht:

Status
Bedeutung

Nicht initialisiert

Gespeichert, aber die erste Synchronisierung wurde noch nicht ausgeführt.

Wird initialisiert

Führt die erste Synchronisierung aus.

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

Importiert Geräte für Ihre gespeicherte Zuordnung.

Fehlgeschlagen

Die letzte Operation ist fehlgeschlagen — siehe die Fehlerhinweise.

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

Fehlerbehebung

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

Fehler
Was er normalerweise bedeutet und wie man ihn behebt

Authentifizierung fehlgeschlagen

Die Client-ID oder das Client-Geheimnis wurde abgelehnt. Bestätigen Sie, dass die Client-Anwendung im ActiveAI Security Portal aktiv ist und dass das Geheimnis aktuell ist — es wird nur einmal angezeigt, also erstellen Sie die Anwendung neu, wenn es verloren ging.

Endpunkt nicht erreichbar

Dispel konnte Darktrace nicht erreichen. Prüfen Sie, ob die Darktrace-Master-URL korrekt ist.

Zeitüberschreitung bei der Verbindung

Darktrace brauchte zu lange, um zu antworten — meist ein vorübergehendes Netzwerkproblem; versuchen Sie es erneut.

Konfigurationsfehler

Die Master-URL sieht falsch aus. Sie 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

Welche Anmeldedaten verwende ich — ActiveAI oder die alten API-Tokens?

Verwenden Sie die Clientanwendungs-Anmeldedaten des ActiveAI Security Portal (eine Client-ID und ein Client-Geheimnis, 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.

Was ist die „Master-URL“?

Es 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, sodass Sie nur die Master-URL angeben müssen.

Welche Findings übernimmt Darktrace in Dispel?

Darktraces Model Alerts — seine Verhaltens-Erkennungen — werden den passenden Geräten als Findings zugeordnet, wobei die Schwere aus der Modellkategorie abgeleitet wird. Das sind Verhaltens-Erkennungen und keine CVE-basierten Schwachstellen.

Löst Dispel Autonomous Response (Antigena) aus oder ändert es?

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 oder setzt sie zurück.

Kann ich mehr als eine Darktrace-Instanz verbinden?

Ja. Darktrace unterstützt mehrere Integrationen, sodass Sie mehrere Instanzen nebeneinander verbinden können. Geben Sie jeder einen eindeutigen Anzeigename um sie auseinanderzuhalten.

Zuletzt aktualisiert

War das hilfreich?