Dope Security SWG-Logs erfassen

Parserversion: 1.0

Unterstützt in:

In diesem Dokument wird beschrieben, wie Sie Dope Security SWG-Logs mit Amazon S3 in Google Security Operations aufnehmen.

Dope Security dope.swg ist ein endpunktbasiertes Secure Web Gateway, das Echtzeit-Webfilterung, Malware-Schutz und Cloud-Anwendungssteuerung bietet. Jeder dope.endpoint sendet alle 15 Minuten Webtransaktionslogs an dope.cloud. Diese werden dann automatisch im komprimierten GZIP-JSONL-Format für die SIEM-Integration in Ihren AWS S3-Bucket exportiert.

Hinweis

Prüfen Sie, ob folgende Voraussetzungen erfüllt sind:

  • Eine Google SecOps-Instanz
  • Privilegierter Zugriff auf Dope Security dope.console
  • Privilegierter Zugriff auf AWS (S3, IAM)
  • Ihr Dope Security-Mandant muss sich in derselben AWS-Region wie Ihr S3-Bucket befinden. Sie können die Region auf der Seite Einstellungen > SIEM prüfen.

Dope Security-SIEM-Integration konfigurieren

So konfigurieren Sie die SIEM-Integration von Dope Security:

  1. Melden Sie sich unter https://console.dope.security in der dope.console an.
  2. Rufen Sie die Einstellungen > SIEM > SIEM-Integrationseinstellungen auf.
  3. Wählen Sie in der Liste SIEM-Typ die Option AWS S3 aus.
  4. Notieren Sie sich die AWS-Region, die rechts auf der Seite angezeigt wird (z. B. US-EAST-2).

  5. Lassen Sie diese Seite geöffnet, da Sie nach der Einrichtung von AWS S3 hierher zurückkehren, um die Konfiguration abzuschließen.

AWS S3-Bucket und IAM für Google SecOps konfigurieren

  1. Erstellen Sie einen Amazon S3-Bucket. Weitere Informationen finden Sie unter Bucket erstellen.
  2. Achten Sie beim Erstellen des Buckets darauf, dass die Region mit der Region übereinstimmt, die auf der Seite „Dope Security SIEM Integration“ angezeigt wird (z. B. US East (Ohio) us-east-2).
  3. Speichern Sie den Namen des Buckets zur späteren Verwendung (z. B. chronicle-dope-swg-logs).

  4. Erstellen Sie einen Nutzer. Weitere Informationen finden Sie unter IAM-Nutzer erstellen.

  5. Wählen Sie den von Ihnen erstellten Nutzer aus.

  6. Wählen Sie den Tab Sicherheitsanmeldedaten aus.

  7. Klicken Sie im Bereich Access Keys (Zugriffsschlüssel) auf Create Access Key (Zugriffsschlüssel erstellen).

  8. Wählen Sie Drittanbieterdienst als Anwendungsfall aus.

  9. Klicken Sie auf Weiter.

  10. Optional: Fügen Sie ein Beschreibungs-Tag hinzu.

  11. Klicken Sie auf Zugriffsschlüssel erstellen.

  12. Klicken Sie auf CSV-Datei herunterladen, um den Zugriffsschlüssel und den geheimen Zugriffsschlüssel zur späteren Verwendung zu speichern.

  13. Klicken Sie auf Fertig.

  14. Wählen Sie den Tab Berechtigungen aus.

  15. Klicken Sie im Bereich Berechtigungsrichtlinien auf Berechtigungen hinzufügen.

  16. Wählen Sie Berechtigungen hinzufügen aus.

  17. Wählen Sie Richtlinien direkt anhängen aus.

  18. Suchen Sie nach der Richtlinie AmazonS3FullAccess.

  19. Wählen Sie die Richtlinie aus.

  20. Klicken Sie auf Weiter.

  21. Klicken Sie auf Berechtigungen hinzufügen.

Dope Security Amazon S3-Verbindung konfigurieren

  1. Kehren Sie zur dope.console auf der Seite Einstellungen > SIEM > SIEM-Integrationseinstellungen zurück.
  2. Geben Sie im Feld S3-Bucket-Name den Namen Ihres S3-Buckets ein (z. B. chronicle-dope-swg-logs).
  3. Im rechten Bereich sehen Sie den Abschnitt Bucket-Richtlinie mit einer vorab generierten JSON-Richtlinie.
  4. Klicken Sie neben dem JSON-Code der Richtlinie auf Kopieren, um ihn in die Zwischenablage zu kopieren.
  5. Rufen Sie in einem neuen Browsertab die AWS S3-Konsole auf.
  6. Wählen Sie Ihren S3-Bucket aus (z. B. chronicle-dope-swg-logs).
  7. Wechseln Sie zum Tab Berechtigungen.
  8. Scrollen Sie nach unten zum Abschnitt Bucket-Richtlinie.
  9. Klicken Sie auf Bearbeiten.
  10. Fügen Sie die JSON-Richtlinie, die Sie aus der dope.console kopiert haben, in das Textfeld Richtlinie ein.
  11. Klicken Sie auf Änderungen speichern.
  12. Kehren Sie zum Browsertab dope.console zurück.
  13. Klicken Sie unten auf der Seite „SIEM Integration Settings“ (SIEM-Integrationseinstellungen) auf Sync (Synchronisieren).
  14. Warten Sie, bis die Synchronisierung abgeschlossen ist.
  15. Prüfen Sie, ob neben dem Feld S3-Bucket-Name ein grünes Häkchen angezeigt wird.
  16. Prüfen Sie, ob der Zeitstempel Letzte Synchronisierung oben rechts auf der Seite angezeigt wird.

Feed in Google SecOps konfigurieren, um Dope Security SWG-Logs aufzunehmen

  1. Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
  2. Klicken Sie auf Neuen Feed hinzufügen.
  3. Klicken Sie auf der nächsten Seite auf Einzelnen Feed konfigurieren.
  4. Geben Sie einen eindeutigen Feednamen ein (z. B. Dope Security SWG Logs).
  5. Wählen Sie als Quelltyp Amazon S3 V2 aus.
  6. Wählen Sie DOPE_SWG als Logtyp aus.
  7. Klicken Sie auf Weiter und dann auf Senden.
  8. Geben Sie Werte für die folgenden Felder an:

    • S3-URI: s3://chronicle-dope-swg-logs/ (durch Ihren Bucket-Namen ersetzen)
    • Option zum Löschen der Quelle: Wählen Sie die gewünschte Löschoption aus.
    • Maximales Dateialter: Dateien einschließen, die in den letzten Tagen geändert wurden (Standardwert: 180 Tage)
    • Zugriffsschlüssel-ID: Nutzerzugriffsschlüssel mit Zugriff auf den S3-Bucket (aus Schritt 12 der AWS-Konfiguration)
    • Geheimer Zugriffsschlüssel: Geheimer Schlüssel des Nutzers mit Zugriff auf den S3-Bucket (aus Schritt 12 der AWS-Konfiguration)
    • Asset-Namespace: Der Asset-Namespace
    • Labels für Datenaufnahme: Das Label, das auf die Ereignisse aus diesem Feed angewendet werden soll.
  9. Klicken Sie auf Weiter und dann auf Senden.

Referenz zum Logdatenformat

Dope Security exportiert Logs im JSONL-Format (JSON Lines) mit GZIP-Komprimierung. Jeder Logeintrag enthält die folgenden Schlüsselfelder:

Feld Beschreibung
Timestamp ISO 8601-Zeitstempel, der angibt, wann die Webtransaktion angefordert wurde
Dauer Verbindungsdauer in Millisekunden
Übereinstimmendes Ziel Domain, mit der die Kategorie „Dope“ abgeglichen wurde
Ziel-IP-Adresse Ziel-IP-Adresse für die angeforderte URL
Mandanten-ID Eindeutige Mandanten-ID des Kunden für dope.cloud
Agenten-ID Eindeutige Agenten-ID für den dope.endpoint
Nutzer Angemeldeter Nutzer auf dem dope.endpoint
OIDC-Nutzer E-Mail-Adresse des authentifizierten Nutzers (wenn die OIDC-Authentifizierung aktiviert ist)
Kategorien Übereinstimmende Dope-Kategorienummern (0–88) für die angeforderte URL
Einstufung Richtlinienentscheidung: Zulassen (0), Blockieren (1), Warnung (2) oder Umgehen (3)
Gesendete Daten Menge der in der Verbindung gesendeten Daten (Byte)
Daten empfangen Menge der in der Verbindung empfangenen Daten (Byte)
Richtlinientyp Art der angewendeten Richtlinie: Web, Cloud Application Control (CAC), benutzerdefinierte Kategorie, Bypass oder Malware
Blockdetails Für Blockierungsentscheidungen: Dope-Kategorie, benutzerdefinierte Kategorie, Cloud-Anwendung oder Malware-Typ
Dateiname Name einer heruntergeladenen Datei
Datei-Hash Datei-Hash für heruntergeladene Dateien
Prozessname Name des Prozesses, der die URL-Anfrage stellt
URL Vollständige angeforderte URL
Richtlinienname Name der angewendeten Richtlinie
Protokoll Verwendetes Protokoll (z. B. HTTP/2, HTTP/1.1)
Hostname Hostname des Geräts
HTTP-Anfragemethode HTTP-Anfragemethode (z. B. GET, POST, PUT)
Prozessaufrufbaum Hierarchische Beziehungen aus Prozesserstellungsvorgängen mit Befehlsargumenten

Die vollständigen Zuordnungen von Kategorien und Ergebnissen finden Sie in der Dokumentation Dope Security Category & Verdict Mappings.

UDM-Zuordnungstabelle

Logfeld UDM-Zuordnung Logik
policy.categories, request.processTree additional.fields Zusammengeführt als Liste aus „policy.categories“ und „request.processTree“ im JSON-Format
timestamp metadata.event_timestamp Wird sowohl in JSON als auch in CSV als ISO8601-Zeitstempel geparst
metadata.event_type Wird auf NETWORK_HTTP gesetzt, wenn has_principal, has_target, has_http in JSON; andernfalls NETWORK_CONNECTION, wenn has_principal und has_target; andernfalls USER_UNCATEGORIZED, wenn has_user; andernfalls STATUS_UPDATE, wenn has_principal; andernfalls GENERIC_EVENT; wird in CSV auf NETWORK_HTTP gesetzt
schemaVersion metadata.product_version Wert, der direkt aus „schemaVersion“ in JSON kopiert wurde
request.httpVersion network.http.user_agent Wert, der direkt aus request.httpVersion in JSON kopiert wurde
bandwidth.dataReceivedInBytes, bytes_received network.received_bytes Konvertiert in uinteger aus bandwidth.dataReceivedInBytes in JSON oder bytes_received in CSV, wenn nicht leer und nicht 0
bandwidth.dataSentInBytes, bytes_sent network.sent_bytes Aus bandwidth.dataSentInBytes in JSON oder bytes_sent in CSV in uinteger konvertiert, wenn nicht leer und nicht 0
request.duration network.session_duration.seconds Aus request.duration in JSON in Ganzzahl konvertiert
endpoint.agentID, endpoint_id principal.asset.asset_id Präfix „DS:“ aus endpoint.agentID in JSON oder endpoint_id in CSV
endpoint.tenantID principal.asset.attribute.cloud.project.id Wert, der direkt aus endpoint.tenantID in JSON kopiert wurde
endpoint.deviceName principal.asset.hostname Wert, der direkt aus endpoint.deviceName in JSON kopiert wurde
endpoint.deviceName, endpoint_hostname principal.hostname Wert aus endpoint.deviceName in JSON oder endpoint_hostname in CSV
request.processName principal.process.command_line Wert, der direkt aus request.processName in JSON kopiert wurde
process_name principal.process.file.names Wert direkt aus „process_name“ in CSV kopiert
sso_user, user principal.user.account_type In der CSV-Datei auf DOMAIN_ACCOUNT_TYPE festlegen, wenn sso_user nicht leer ist, andernfalls auf LOCAL_ACCOUNT_TYPE
endpoint.oidcUser principal.user.email_addresses Zusammengeführt, wenn endpoint.oidcUser mit dem regulären Ausdruck für E-Mails in JSON übereinstimmt
endpoint.oidcUser principal.user.user_display_name Wert wird direkt kopiert, wenn endpoint.oidcUser nicht mit dem regulären Ausdruck für E-Mails in JSON übereinstimmt
endpoint.user, sso_user, user principal.user.userid Wert aus endpoint.user in JSON; aus sso_user, wenn nicht leer, sonst user in CSV
security_result security_result Zusammengeführt aus security_result in JSON
policy.verdict, verdict security_result.action Wird auf BLOCKIEREN gesetzt, wenn „policy.verdict“ in JSON oder „verdict“ in CSV 1 ist, auf ZULASSEN, wenn der Wert 0 ist, und auf CHALLENGE, wenn der Wert 2 ist.
Kategorien security_result.action_details Wert, der direkt aus den Kategorien in der CSV-Datei kopiert wurde
policy.policyName security_result.rule_name Wert, der direkt aus „policy.policyName“ in JSON kopiert wurde
policy.policyType security_result.rule_type Wert, der direkt aus „policy.policyType“ in JSON kopiert wurde
file_name target.file.names Wert direkt aus file_name in CSV kopiert
file_hash target.file.sha256 Wert direkt aus „file_hash“ in CSV kopiert
destination.matchedDestination, domain target.hostname Wert aus destination.matchedDestination, wenn keine IP-Adresse in JSON; aus Domain in CSV
destination.matchedDestination, destination.destinationIP, ip target.ip Wert aus destination.matchedDestination oder destination.destinationIP, wenn IP in JSON; aus ip in CSV
destination.url, url target.url Wert aus destination.url in JSON; aus url in CSV
metadata.product_name In JSON auf „DOPE_SWG“ und in CSV auf „SWG“ festlegen
metadata.vendor_name In JSON auf „DOPE_SWG“ und in CSV auf „Dope Security“ festlegen

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten