Auth0-Logs erfassen
Parserversion: 16.0
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:
- Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
- Klicken Sie auf Neuen Feed hinzufügen.
- Klicken Sie auf der nächsten Seite auf Einzelnen Feed konfigurieren.
- Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B. Auth0-Logs.
- Wählen Sie Webhook als Quelltyp aus.
- Wählen Sie AUTH_ZERO als Protokolltyp aus.
- Klicken Sie auf Weiter.
- 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.
- Trennzeichen: Das Trennzeichen, das zum Trennen von Logzeilen verwendet wird, z. B.
- Klicken Sie auf Weiter.
- Prüfen Sie die Feedkonfiguration auf dem Bildschirm Abschließen und klicken Sie dann auf Senden.
- Klicken Sie auf Geheimen Schlüssel generieren, um einen geheimen Schlüssel zur Authentifizierung dieses Feeds zu generieren.
- 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.
- Kopieren Sie auf dem Tab Details die Feed-Endpunkt-URL aus dem Feld Endpunktinformationen. Sie müssen diese Endpunkt-URL in Ihrer Clientanwendung angeben.
- Klicken Sie auf Fertig.
API-Schlüssel für den Webhook-Feed erstellen
Rufen Sie die Google Cloud Console > Anmeldedaten auf.
Klicken Sie auf Anmeldedaten erstellen und wählen Sie anschließend API-Schlüssel aus.
Beschränken Sie den Zugriff des API-Schlüssels auf die Chronicle API.
Endpunkt-URL angeben
- Geben Sie in Ihrer Clientanwendung die HTTPS-Endpunkt-URL an, die im Webhook-Feed angegeben ist.
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 = SECRETEmpfehlung: 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
- Rufen Sie das Auth0-Dashboard auf.
- Gehen Sie zu Monitoring > Streams.
- Klicken Sie auf Logstream erstellen.
- Klicken Sie auf den Button Benutzerdefinierter Webhook und geben Sie einen Namen Ihrer Wahl ein. Beispiel: Google SecOps-Webhook.
- 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.
- Klicken Sie auf Speichern, um den Webhook zu erstellen.
- Lösen Sie das mit dem Hook verknüpfte Ereignis aus (z. B. neuen Nutzer registrieren, anmelden).
- 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