Auth0-Logs erfassen

Parserversion: 16.0

Unterstützt in:

Dieser Parser extrahiert Auth0-Protokollereignisse aus JSON-formatierten Nachrichten. Er initialisiert UDM-Felder, parst die JSON-Nutzlast, ordnet relevante Felder dem UDM-Schema zu und kategorisiert Ereignisse anhand des Felds type, wobei entsprechende Sicherheitsaktionen und Ereignistypen festgelegt werden.

Hinweis

Folgende Voraussetzungen müssen erfüllt sein:

  • Google SecOps-Instanz
  • Auth0-Konto mit den erforderlichen Berechtigungen.

Feeds einrichten

So konfigurieren Sie einen Feed:

  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 im Feld Feedname einen Namen für den Feed ein, z. B. Auth0-Logs.
  5. Wählen Sie Webhook als Quelltyp aus.
  6. Wählen Sie AUTH_ZERO als Protokolltyp aus.
  7. Klicken Sie auf Weiter.
  8. Optional: Geben Sie Werte für die folgenden Eingabeparameter an:
    • Trennzeichen: Das Trennzeichen, das zum Trennen von Logzeilen verwendet wird, z. B. \n.
    • Asset-Namespace: der Asset-Namespace.
    • Aufnahmelabels: Das Label, das auf die Ereignisse aus diesem Feed angewendet wird.
  9. Klicken Sie auf Weiter.
  10. Prüfen Sie die Feedkonfiguration auf dem Bildschirm Abschließen und klicken Sie dann auf Senden.
  11. Klicken Sie auf Geheimen Schlüssel generieren, um einen geheimen Schlüssel zur Authentifizierung dieses Feeds zu generieren.
  12. Kopieren Sie den geheimen Schlüssel und speichern Sie ihn. Sie können diesen geheimen Schlüssel nicht noch einmal aufrufen. Bei Bedarf können Sie einen neuen geheimen Schlüssel generieren. Dadurch wird der vorherige geheime Schlüssel jedoch ungültig.
  13. Kopieren Sie auf dem Tab Details die Feed-Endpunkt-URL aus dem Feld Endpunktinformationen. Sie müssen diese Endpunkt-URL in Ihrer Clientanwendung angeben.
  14. Klicken Sie auf Fertig.

API-Schlüssel für den Webhook-Feed erstellen

  1. Rufen Sie die Google Cloud Console > Anmeldedaten auf.

    Zu den Anmeldedaten

  2. Klicken Sie auf Anmeldedaten erstellen und wählen Sie anschließend API-Schlüssel aus.

  3. Beschränken Sie den Zugriff des API-Schlüssels auf die Chronicle API.

Endpunkt-URL angeben

  1. Geben Sie in Ihrer Clientanwendung die HTTPS-Endpunkt-URL an, die im Webhook-Feed angegeben ist.
  2. Aktivieren Sie die Authentifizierung, indem Sie den API-Schlüssel und den geheimen Schlüssel als Teil des benutzerdefinierten Headers im folgenden Format angeben:

    X-goog-api-key = API_KEY
    X-Webhook-Access-Key = SECRET
    

    Empfehlung: Geben Sie den API-Schlüssel als Header an, anstatt ihn in der URL anzugeben. Wenn Ihr Webhook-Client keine benutzerdefinierten Header unterstützt, können Sie den API-Schlüssel und den geheimen Schlüssel mit Suchparametern im folgenden Format angeben:

    ENDPOINT_URL?key=API_KEY&secret=SECRET
    

Ersetzen Sie Folgendes:

  • ENDPOINT_URL: die Feed-Endpunkt-URL.
  • API_KEY: der API-Schlüssel für die Authentifizierung bei Google Security Operations.
  • SECRET: der geheime Schlüssel, den Sie zur Authentifizierung des Feeds generiert haben.

Auth0-Webhook für Google SecOps konfigurieren

  1. Rufen Sie das Auth0-Dashboard auf.
  2. Gehen Sie zu Monitoring > Streams.
  3. Klicken Sie auf Logstream erstellen.
  4. Klicken Sie auf den Button Benutzerdefinierter Webhook und geben Sie einen Namen Ihrer Wahl ein. Beispiel: Google SecOps-Webhook.
  5. Konfigurieren Sie Folgendes:
    • Nutzlast-URL: Geben Sie die URL des Google SecOps API-Endpunkt ein.
    • Content-Type: Setzen Sie den Header Content-Type auf application/json. Dadurch wird Google SecOps das Format der gesendeten Daten mitgeteilt.
    • Optional: Autorisierungstoken: Konfigurieren Sie ein Secret für zusätzliche Sicherheit. Damit wird die Authentizität der Webhook-Anfragen überprüft.

Nutzlast anpassen: Sie können die an Google SecOps gesendete Nutzlast anpassen, indem Sie die Ereigniskategorie ändern. So können Sie bestimmte Datenpunkte aus dem Auth0-Ereignis auswählen und nach Bedarf für Google SecOps formatieren. Weitere Informationen zu den verfügbaren Kontextvariablen und Scripting-Optionen finden Sie in der Auth0-Dokumentation. Achten Sie darauf, dass die endgültige Nutzlast dem erwarteten Google SecOps-UDM-Format entspricht.

  1. Klicken Sie auf Speichern, um den Webhook zu erstellen.
  2. Lösen Sie das mit dem Hook verknüpfte Ereignis aus (z. B. neuen Nutzer registrieren, anmelden).
  3. Prüfen Sie, ob die Logs an Google SecOps gesendet werden, indem Sie den Feed in der Google SecOps-Konsole prüfen.

UDM-Zuordnungstabelle

Logfeld UDM-Zuordnung Logik
client_id principal.asset.product_object_id Wird direkt aus dem Feld client_id zugeordnet.
client_name principal.hostname Wird direkt aus dem Feld client_name zugeordnet.
connection security_result.description Wird direkt aus dem Feld connection zugeordnet.
connection_id security_result.rule_id Wird direkt aus dem Feld connection_id zugeordnet.
date metadata.event_timestamp Wird aus dem Feld date im ISO8601-Format geparst.
description metadata.description Wird direkt aus dem Feld description zugeordnet.
details.error security_result.detection_fields Aus dem Feld „details.error“ zugeordnet. Der Schlüssel ist „Error“.
details.error.oauthError security_result.detection_fields Aus dem Feld „details.error.oauthError“ zugeordnet. Der Schlüssel ist „oauthError“.
details.error.type security_result.detection_fields Aus dem Feld „details.error.type“ zugeordnet. Der Schlüssel ist „oauth_error_type“.
details.ipOnAllowlist security_result.detection_fields Aus dem Feld „details.ipOnAllowlist“ zugeordnet. Der Schlüssel ist „ipOnAllowlist“.
details.link target.url Wird direkt aus dem Feld details.link zugeordnet, falls vorhanden, andernfalls aus anderen Feldern abgeleitet (siehe unten).
details.request.auth.strategy security_result.detection_fields Aus dem Feld „details.request.auth.strategy“ zugeordnet. Der Schlüssel ist „strategy“.
details.request.body.app_metadata.blockedReason security_result.detection_fields Aus dem Feld „details.request.body.app_metadata.blockedReason“ zugeordnet. Der Schlüssel ist „blockedReason“.
details.request.body.app_metadata.customer_id target.user.product_object_id Wird direkt aus dem Feld details.request.body.app_metadata.customer_id zugeordnet.
details.request.body.app_metadata.migrated security_result.detection_fields Aus dem Feld „details.request.body.app_metadata.migrated“ zugeordnet. Der Schlüssel ist „migriert“.
details.request.channel security_result.detection_fields Aus dem Feld „details.request.channel“ zugeordnet. Der Schlüssel ist „channel“.
details.request.method network.http.method Wird direkt aus dem Feld details.request.method zugeordnet, nachdem es in Großbuchstaben umgewandelt wurde.
details.request.path target.url Wird direkt aus dem Feld details.request.path zugeordnet, wenn details.link nicht vorhanden ist. Andernfalls wird es aus anderen Feldern abgeleitet (siehe unten).
details.response.body.email target.user.email_addresses Wird direkt aus dem Feld details.response.body.email zugeordnet.
details.response.body.email_verified security_result.detection_fields Aus dem Feld „details.response.body.email_verified“ zugeordnet. Der Schlüssel ist „email_verified“.
details.response.body.nickname target.user.user_display_name Wird direkt aus dem Feld details.response.body.nickname zugeordnet.
details.response.body.user_id target.user.userid Wird direkt aus dem Feld details.response.body.user_id zugeordnet.
details.response.statusCode network.http.response_code Wird nach der Konvertierung in eine Ganzzahl direkt aus dem Feld details.response.statusCode zugeordnet.
details.return_to target.url Wird direkt aus dem Feld details.return_to zugeordnet, wenn details.link und details.request.path nicht vorhanden sind, andernfalls aus anderen Feldern abgeleitet (siehe unten).
details.session_id network.session_id Wird direkt aus dem Feld details.session_id zugeordnet.
details.stats.loginsCount additional.fields Aus dem Feld „details.stats.loginsCount“ zugeordnet. Der Schlüssel ist „loginsCount“.
details.requiresVerification security_result.detection_fields Aus dem Feld „details.requiresVerification“ zugeordnet. Der Schlüssel ist „requiresVerification“.
details.to target.user.email_addresses Wird direkt aus dem Feld details.to zugeordnet.
hostname target.hostname Wird direkt aus dem Feld hostname zugeordnet.
ip principal.ip Wird direkt aus dem Feld ip zugeordnet.
js_data.audience target.url Wird direkt aus dem Feld js_data.audience zugeordnet, wenn details.link, details.request.path und details.return_to nicht vorhanden sind.
js_data.details.body.email_verified security_result.detection_fields Aus dem Feld „js_data.details.body.email_verified“ zugeordnet. Der Schlüssel ist „email_verified“.
js_data.details.body.is_signup security_result.detection_fields Aus dem Feld „js_data.details.body.is_signup“ zugeordnet. Der Schlüssel ist „is_signup“.
js_data.details.body.transaction.redirect_uri target.url Wird direkt aus dem Feld js_data.details.body.transaction.redirect_uri zugeordnet, wenn details.link, details.request.path, details.return_to und js_data.audience nicht vorhanden sind.
js_data.scope security_result.detection_fields Aus dem Feld „js_data.scope“ zugeordnet. Der Schlüssel ist „scope“.
js_data.tracking_id security_result.detection_fields Aus dem Feld „js_data.tracking_id“ zugeordnet. Der Schlüssel ist „tracking_id“.
log_id metadata.product_log_id Wird direkt aus dem Feld log_id zugeordnet.
metadata.log_type metadata.log_type Wird direkt aus dem Feld log_type zugeordnet.
metadata.product_name metadata.product_name Legen Sie diesen Wert auf „AUTH_ZERO“ fest.
metadata.vendor_name metadata.vendor_name Legen Sie diesen Wert auf „AUTH_ZERO“ fest.
metadata.product_event_type metadata.product_event_type Wird direkt aus dem Feld type zugeordnet.
network.http.parsed_user_agent network.http.parsed_user_agent Aus dem Feld user_agent geparst.
network.http.user_agent network.http.user_agent Wird direkt aus dem Feld user_agent zugeordnet.
security_result.action security_result.action Wird durch das Feld type (ALLOW oder BLOCK) bestimmt. Spezifische Zuordnungen finden Sie im Parsercode.
strategy security_result.detection_fields Aus dem Feld strategy zugeordnet. Der Schlüssel ist „strategy“.
strategy_type security_result.detection_fields Aus dem Feld strategy_type zugeordnet. Der Schlüssel ist „strategy_type“.
target.user.email_addresses target.user.email_addresses Wird direkt aus dem Feld user_name zugeordnet, wenn es sich um eine E-Mail-Adresse handelt, andernfalls aus anderen Feldern abgeleitet (siehe oben).
target.user.userid target.user.userid Wird direkt aus dem Feld user_id zugeordnet, oder aus details.response.body.user_id oder user_name, wenn user_id nicht vorhanden ist.
user_agent network.http.user_agent Wird direkt aus dem Feld user_agent zugeordnet.
user_id target.user.userid Wird direkt aus dem Feld user_id zugeordnet.
user_name target.user.email_addresses Wird direkt aus dem Feld user_name zugeordnet. Legen Sie „MACHINE“ fest, wenn security_result.action „ALLOW“ und type „slo“, „sapi“, „s“, „ss“ oder „ssa“ ist. Legen Sie „OTP“ fest, wenn extensions.auth.type „MACHINE“ und type „slo“ ist. Wird durch eine Kombination von Feldern bestimmt, darunter type, client_name, ip, hostname und has_user. Spezifische Zuordnungen finden Sie im Parsercode.

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

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