Alle Seiten
Bereitgestellt von GitBook
1 von 1

Loading...

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.

Sie benötigen folgende Angaben von Darktrace:

  • Eine im ActiveAI Security Portal unter Client Applications verwaltenerstellte 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.

  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
  1. Klicken Sie auf Verbindung testen , um zu bestätigen, dass Dispel sich authentifizieren kann. Beheben Sie alle gemeldeten Fehler, bevor Sie speichern.

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

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.

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

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

Status
Bedeutung

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

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

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.

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.

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.

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.

Vorbereitung

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.

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.

Darktrace verbinden

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.

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.

Die Instanz einem Wicket zuordnen

Inventar aktuell halten

Verbindungsstatus

Fehlerbehebung

Häufig gestellte Fragen

Welche Anmeldedaten soll ich verwenden – ActiveAI oder die älteren API-Tokens?

Verwenden Sie die Anmeldedaten einer Client-Anwendung aus dem ActiveAI Security Portal (eine Client ID und ein Client Secret, die unter Manage Client Applicationserstellt 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.

Was ist die „Master-URL“?

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.comweiter. Sie müssen daher nur die Master-URL angeben.

Welche Ergebnisse bringt Darktrace in Dispel ein?

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.

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

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.

Kann ich mehr als eine Darktrace-Instanz verbinden?

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.

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.