Keycloak-Logs erfassen
In diesem Dokument wird beschrieben, wie Sie Keycloak so konfigurieren, dass Logs über Webhooks an Google Security Operations gesendet werden.
Keycloak ist eine Open-Source-Lösung für die Identitäts- und Zugriffsverwaltung (IAM), die Einmalanmeldung (SSO), Nutzerföderation, Identitäts-Brokering und Social Login bietet. Es unterstützt die Protokolle OpenID Connect, OAuth 2.0 und SAML 2.0 und verfolgt Nutzerereignisse (Anmeldung, Abmeldung, Registrierung, Passwortänderungen) und Administratorereignisse (Nutzer-, Client-, Realm- und Rollenverwaltungsvorgänge) für Sicherheitsaudits.
Hinweis
Folgende Voraussetzungen müssen erfüllt sein:
- Eine Google SecOps-Instanz
- Eine laufende Keycloak-Instanz (Version 20 oder höher empfohlen)
- Administratorzugriff auf die Keycloak Admin-Konsole
- Zugriff auf das Dateisystem oder den Container des Keycloak-Servers, um Erweiterungen bereitzustellen
- Zugriff auf die Google Cloud Console (zum Erstellen von API-Schlüsseln)
Webhook-Feed in Google SecOps erstellen
Feed erstellen
- 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.
Keycloak Events. - Wählen Sie Webhook als Quelltyp aus.
- Wählen Sie Keycloak als Logtyp aus.
- Klicken Sie auf Weiter.
- Geben Sie Werte für die folgenden Eingabeparameter an:
- Trennzeichen für Aufteilung (optional): Geben Sie
\nein, um mehrzeilige Ereignisse aufzuteilen. Da jeder Webhook-POST ein einzelnes Ereignis enthält, kann dieses Feld leer bleiben. - Asset-Namespace: Der Asset-Namespace
- Labels für Datenaufnahme: Das Label, das auf die Ereignisse aus diesem Feed angewendet werden soll.
- Trennzeichen für Aufteilung (optional): Geben Sie
- Klicken Sie auf Weiter.
- Prüfen Sie die neue Feedkonfiguration auf dem Bildschirm Abschließen und klicken Sie dann auf Senden.
Secret-Schlüssel generieren und speichern
Nachdem Sie den Feed erstellt haben, müssen Sie einen Secret-Schlüssel für die Authentifizierung generieren:
- Klicken Sie auf der Feed-Detailseite auf Geheimen Schlüssel generieren.
- In einem Dialogfeld wird der geheime Schlüssel angezeigt.
- Kopieren und speichern Sie den geheimen Schlüssel an einem sicheren Ort.
Wichtig: Der geheime Schlüssel wird nur einmal angezeigt und kann später nicht mehr abgerufen werden. Wenn Sie ihn verlieren, müssen Sie einen neuen geheimen Schlüssel generieren.
Feed-Endpunkt-URL abrufen
- Gehen Sie zum Tab Details des Feeds.
- Kopieren Sie im Abschnitt Endpunktinformationen die Feed-Endpunkt-URL.
Das URL-Format lautet:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:importDabei ist
{region}die Region Ihrer Google SecOps-Instanz (z. B.us,europeoderasia-southeast1) und{parent}der Ressourcenpfad im Formatprojects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.Speichern Sie diese URL für die nächsten Schritte.
Klicken Sie auf Fertig.
Google Cloud API-Schlüssel erstellen
Chronicle erfordert einen API-Schlüssel für die Authentifizierung. Erstellen Sie in der Google Cloud Console einen eingeschränkten API-Schlüssel.
API-Schlüssel erstellen
- Rufen Sie die Seite „Anmeldedaten“ derGoogle Cloud Console auf.
- Wählen Sie Ihr Projekt aus (das Projekt, das mit Ihrer Chronicle-Instanz verknüpft ist).
- Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel.
- Ein API-Schlüssel wird erstellt und in einem Dialogfeld angezeigt.
- Klicken Sie auf API-Schlüssel bearbeiten, um den Schlüssel einzuschränken.
API-Schlüssel einschränken
- Auf der Seite mit den Einstellungen für den API-Schlüssel:
- Name: Geben Sie einen aussagekräftigen Namen ein (z. B.
Chronicle Webhook API Key).
- Name: Geben Sie einen aussagekräftigen Namen ein (z. B.
- Gehen Sie unter API-Einschränkungen so vor:
- Wählen Sie Schlüssel einschränken aus.
- Suchen Sie im Drop-down-Menü APIs auswählen nach der Google SecOps API (oder Chronicle API) und wählen Sie sie aus.
- Klicken Sie auf Speichern.
- Kopieren Sie den Wert des API-Schlüssels aus dem Feld API-Schlüssel oben auf der Seite.
- Speichern Sie den API-Schlüssel an einem sicheren Ort.
Ereignisspeicherung in Keycloak aktivieren
Bevor Sie die Webhook-Erweiterung konfigurieren, müssen Sie die Ereignisspeicherung in Keycloak aktivieren, damit Ereignisse generiert und zur Weiterleitung verfügbar gemacht werden.
Nutzerereignisse aktivieren
- Melden Sie sich in der Keycloak-Admin-Konsole an.
- Wählen Sie links oben im Drop-down-Menü den Realm aus, den Sie beobachten möchten.
- Rufen Sie Realm Settings > Events auf.
- Wählen Sie den Untertab Einstellungen für Nutzerereignisse aus.
- Aktivieren Sie die Option Termine speichern.
- Legen Sie den Ablaufzeitraum fest (empfohlen: mindestens 7 Tage).
- Klicken Sie auf Speichern.
Administratorereignisse aktivieren
- Wählen Sie auf dem Tab Ereignisse den Untertab Einstellungen für Administratorereignisse aus.
- Aktivieren Sie die Option Termine speichern.
- Aktivieren Sie die Option Darstellung einschließen, um alle Details der geänderten Objekte zu erfassen.
- Legen Sie den Ablaufzeitraum fest (empfohlen: mindestens 7 Tage).
- Klicken Sie auf Speichern.
Webhook-Ereignis-Listener-Erweiterung installieren
Keycloak enthält keinen nativen Webhook-Ereignis-Listener. Installieren Sie die Erweiterung keycloak-events von Phase Two (p2-inc), um die Webhook-Zustellung zu aktivieren.
Erweiterung herunterladen und bereitstellen
Laden Sie die neueste JAR-Datei von der Seite mit den Keycloak-Events-Releases auf Maven Central herunter oder erstellen Sie sie aus dem Quellcode:
git clone https://github.com/p2-inc/keycloak-events.git cd keycloak-events mvn clean installKopieren Sie die resultierende Fat-JAR-Datei in das Keycloak-Verzeichnis
providers:cp target/keycloak-events-*.jar /opt/keycloak/providers/Erstellen Sie Keycloak neu und starten Sie es neu:
/opt/keycloak/bin/kc.sh build /opt/keycloak/bin/kc.sh start
Webhook-Ereignis-Listener aktivieren
- Melden Sie sich in der Keycloak-Admin-Konsole an.
- Wählen Sie im Drop-down-Menü „Realm“ den Ziel-Realm aus.
- Rufen Sie Realm Settings > Events auf.
- Wählen Sie im Drop-down-Menü Event-Listener die Option ext-event-webhook aus.
- Klicken Sie auf Speichern.
Keycloak-Webhook konfigurieren
Webhook-URL erstellen
Kombinieren Sie die Chronicle-Endpunkt-URL und den API-Schlüssel:
<ENDPOINT_URL>?key=<API_KEY>Beispiel:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...
Webhook-Abo über die Keycloak REST API erstellen
Die Erweiterung keycloak-events bietet REST-Endpunkte zum Verwalten von Webhook-Abos. Verwenden Sie die Keycloak Admin REST API, um einen Webhook zu erstellen.
Schritt 1: Zugriffstoken abrufen
Fordern Sie mit einem Administratorkonto ein Zugriffstoken von Keycloak an:
TOKEN=$(curl -sS -X POST "https://<KEYCLOAK_HOST>/realms/master/protocol/openid-connect/token" \ -H "Content-Type: application/x-www-form-urlencoded" \ --data-urlencode "grant_type=password" \ --data-urlencode "client_id=admin-cli" \ --data-urlencode "username=<ADMIN_USERNAME>" \ --data-urlencode "password=<ADMIN_PASSWORD>" \ | sed -n 's/.*"access_token":"\([^"]*\)".*/\1/p')
Ersetzen Sie Folgendes:
<KEYCLOAK_HOST>: Hostname und Port Ihres Keycloak-Servers (z. B.keycloak.example.com:8443)<ADMIN_USERNAME>: Ihr Keycloak-Administratornutzername<ADMIN_PASSWORD>: Ihr Keycloak-Administratorpasswort
Schritt 2: Webhook erstellen
Senden Sie eine POST-Anfrage, um das Webhook-Abo für den Zielbereich zu erstellen:
curl -sS -X POST "https://<KEYCLOAK_HOST>/realms/<REALM_NAME>/webhooks" \ -H "Authorization: Bearer ${TOKEN}" \ -H "Content-Type: application/json" \ -d '{ "enabled": "true", "url": "<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>", "secret": "<WEBHOOK_HMAC_SECRET>", "eventTypes": ["*"] }'
Ersetzen Sie Folgendes:
<KEYCLOAK_HOST>: Der Hostname Ihres Keycloak-Servers<REALM_NAME>: Der Name des zu überwachenden Realms (z. B.masterodermy-realm)<ENDPOINT_URL>: Die zuvor kopierte URL des Chronicle-Feed-Endpunkts<API_KEY>: Der zuvor erstellte Google Cloud API-Schlüssel<SECRET_KEY>: Der zuvor generierte geheime Schlüssel für den Chronicle-Webhook<WEBHOOK_HMAC_SECRET>: Ein beliebiger Secret-String für die HMAC-Signatur von Webhook-Nutzlasten (z. B.mySecretKey123)
Schritt 3: Webhook überprüfen
Prüfen Sie, ob der Webhook erstellt wurde, indem Sie alle Webhooks für den Realm auflisten:
curl -sS -X GET "https://<KEYCLOAK_HOST>/realms/<REALM_NAME>/webhooks" \ -H "Authorization: Bearer ${TOKEN}" \ -H "Accept: application/json"
Die Antwort enthält eine Liste von Webhook-Objekten. Prüfen Sie, ob Ihr Webhook mit "enabled": "true" und der richtigen URL angezeigt wird.
Webhook-Ereignistypen
Im Feld eventTypes wird ein Array von Ausdrücken akzeptiert, um zu filtern, welche Ereignisse gesendet werden:
*: Alle Ereignisse senden (empfohlen für die SIEM-Integration)access.*: Alle Zugriffsereignisse sendenadmin.*: Alle Administratorereignisse sendenadmin.USER-*: Alle Administratorereignisse im Zusammenhang mit Nutzern sendenadmin-USER-CREATE: Nur Administratorereignisse zur Nutzererstellung senden
Verhalten bei Webhook-Wiederholungsversuchen
Die Erweiterung verwendet einen automatischen exponentiellen Backoff für Wiederholungsversuche, wenn eine Antwort empfangen wird, die nicht 2xx ist:
| Parameter | Standardwert | Beschreibung |
|---|---|---|
| backoffInitialInterval | 500 ms | Anfängliches Wiederholungsintervall |
| backoffMaxElapsedTime | 900.000 ms (15 Minuten) | Maximale Gesamtwiederholungszeit |
| backoffMaxInterval | 180.000 ms (3 Minuten) | Maximales Intervall zwischen Wiederholungsversuchen |
| backoffMultiplier | 5 | Multiplikator für jedes Wiederholungsintervall |
| backoffRandomizationFactor | 0,5 | Randomisierungsfaktor für Jitter |
Referenz zu Authentifizierungsmethoden
Chronicle-Webhook-Feeds unterstützen mehrere Authentifizierungsmethoden. Wählen Sie die Methode aus, die von Ihrem Anbieter unterstützt wird.
Methode 1: Benutzerdefinierte Header (empfohlen)
Wenn Ihr Anbieter benutzerdefinierte HTTP-Header unterstützt, verwenden Sie diese Methode, um die Sicherheit zu erhöhen.
Anfrageformat:
POST <ENDPOINT_URL> HTTP/1.1 Content-Type: application/json x-goog-chronicle-auth: <API_KEY> x-chronicle-auth: <SECRET_KEY> { "event": "data", "timestamp": "2025-01-15T10:30:00Z" }
Vorteile:
- API-Schlüssel und Secret sind in der URL nicht sichtbar.
- Sicherer (Header werden nicht in Webserver-Zugriffslogs protokolliert)
- Bevorzugte Methode, wenn der Anbieter sie unterstützt
Methode 2: Suchparameter
Wenn Ihr Anbieter keine benutzerdefinierten Header unterstützt, hängen Sie die Anmeldedaten an die URL an.
URL-Format:
<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>Beispiel:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...Anfrageformat:
POST <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY> HTTP/1.1 Content-Type: application/json { "event": "data", "timestamp": "2025-01-15T10:30:00Z" }
Nachteile:
- Anmeldedaten in URL sichtbar
- Kann in Webserver-Zugriffsprotokollen protokolliert werden
- Weniger sicher als Header
Methode 3: Hybrid (URL + Header)
Bei einigen Konfigurationen wird der API-Schlüssel in der URL und der geheime Schlüssel im Header verwendet.
Anfrageformat:
POST <ENDPOINT_URL>?key=<API_KEY> HTTP/1.1 Content-Type: application/json x-chronicle-auth: <SECRET_KEY> { "event": "data", "timestamp": "2025-01-15T10:30:00Z" }
Namen der Authentifizierungsheader
Chronicle akzeptiert die folgenden Headernamen für die Authentifizierung:
Für API-Schlüssel:
x-goog-chronicle-auth(empfohlen)X-Goog-Chronicle-Auth(Groß-/Kleinschreibung wird nicht berücksichtigt)
Für den geheimen Schlüssel:
x-chronicle-auth(empfohlen)X-Chronicle-Auth(Groß-/Kleinschreibung wird nicht berücksichtigt)
Webhook-Limits und Best Practices
Anfragelimits
| Limit | Wert |
|---|---|
| Maximale Anfragegröße | 4 MB |
| Maximale Abfragen pro Sekunde | 15.000 |
| Zeitlimit für Anfragen | 30 Sekunden |
| Wiederholungsverhalten | Automatisch mit exponentiellem Backoff |
Unterstützte Beispielprotokolle
Die folgenden Beispiele zeigen Keycloak-JSON-Logs, die vom Standardparser den Ereignistypen des Unified Data Model (UDM) zugeordnet werden:
Nutzeranmeldeereignis (
USER_LOGIN){ "timestamp": "2024-10-12T15:10:04.123456789Z", "log_type": "KEYCLOAK", "uuid": "dummy_user_01", "read_timestamp": "2024-10-12T15:10:04Z", "source_timestamp": "2024-10-12T15:10:04.123456781Z", "object": "synth_object_01", "read_method": "synth_read_method_01", "stream_name": "synth_stream_name_01", "schema_key": "synth_schema_key_01", "sort_keys": "synth_sort_keys_01", "source_metadata": { "schema": "synth_schema_01", "table": "synth_table_01", "is_deleted": true, "change_type": "synth_change_type_01", "tx_id": "synth_tx_id_01", "lsn": "synth_lsn_01", "primary_keys": "synth_primary_keys_01" }, "payload": { "id": "synth_id_01", "client_id": "synth_client_id_01", "error": "synth_error_01", "ip_address": "1.1.1.1", "realm_id": "synth_realm_id_01", "session_id": "synth_session_id_01", "event_time": "2024-10-12T15:10:04Z", "type": "LOGIN", "user_id": "dummy_user_01", "details_json": "{\"uuid\":\"dummy_user_01\",\"read_timestamp\":\"2024-10-12T15:10:04Z\",\"source_timestamp\":\"2024-10-12T15:10:04.123456781Z\",\"object\":\"synth_object_01\",\"read_method\":\"synth_read_method_01\",\"stream_name\":\"synth_stream_name_01\",\"schema_key\":\"synth_schema_key_01\",\"sort_keys\":\"synth_sort_keys_01\",\"username\":\"dummy_user_01\",\"redirect_uri\":\"synth_redirect_uri_01\",\"st\":\"synth_st_01\",\"refresh_token_id\":\"synth_refresh_token_id_01\",\"token_id\":\"synth_token_id_01\",\"environnement\":\"synth_environnement_01\",\"status_code\":\"200\",\"parameters\":{}}" }, "username": "dummy_user_01", "redirect_uri": "synth_redirect_uri_01", "ctx": { "actionId": "synth_actionId_01", "clientId": "synth_clientId_01", "executionId": "synth_executionId_01", "host": "host-01.dummy.net", "ip": "1.1.1.1", "messageId": "dummy_user_01@dummy.net", "process": "synth_process_01", "realmId": "synth_realmId_01", "referer": "synth_referer_01", "requestId": "synth_requestId_01", "sessionId": "synth_sessionId_01", "source": "synth_source_01", "trackerId": "synth_trackerId_01", "uri": "synth_uri_01", "userAgent": "dummy_user_01", "userId": "dummy_user_01", "username": "dummy_user_01" }, "env": { "application": "synth_application_01", "instance": "synth_instance_01", "st": "synth_st_01" }, "st": "synth_st_01", "refresh_token_id": "synth_refresh_token_id_01", "token_id": "synth_token_id_01", "environnement": "synth_environnement_01", "status_code": "200", "events": [ { "typeEv": "LOGIN", "message": "HTTP 200 Found" } ] }Nutzerabmeldeereignis (
USER_LOGOUT){ "timestamp": "2024-10-12T16:17:17.123456789Z", "log_type": "KEYCLOAK", "uuid": "dummy_admin_02", "read_timestamp": "2024-10-12T16:17:17Z", "source_timestamp": "2024-10-12T16:17:17.123456782Z", "object": "synth_object_02", "read_method": "synth_read_method_02", "stream_name": "synth_stream_name_02", "schema_key": "synth_schema_key_02", "sort_keys": "synth_sort_keys_02", "source_metadata": { "schema": "synth_schema_02", "table": "synth_table_02", "is_deleted": false, "change_type": "synth_change_type_02", "tx_id": "synth_tx_id_02", "lsn": "synth_lsn_02", "primary_keys": "synth_primary_keys_02" }, "payload": { "id": "synth_id_02", "client_id": "synth_client_id_02", "error": "synth_error_02", "ip_address": "1.1.1.2", "realm_id": "synth_realm_id_02", "session_id": "synth_session_id_02", "event_time": "2024-10-12T16:17:17Z", "user_id": "dummy_admin_02", "details_json": "{\"parameters\":{}}" }, "username": "dummy_admin_02", "redirect_uri": "synth_redirect_uri_02", "ctx": { "actionId": "synth_actionId_02", "clientId": "synth_clientId_02", "executionId": "synth_executionId_02", "host": "gw-edge-02.dummy.net", "ip": "1.1.1.2", "messageId": "dummy_admin_02@dummy.net", "process": "synth_process_02", "realmId": "synth_realmId_02", "referer": "synth_referer_02", "requestId": "synth_requestId_02", "sessionId": "synth_sessionId_02", "source": "synth_source_02", "trackerId": "synth_trackerId_02", "uri": "synth_uri_02", "userAgent": "dummy_admin_02", "userId": "dummy_admin_02", "username": "dummy_admin_02" }, "env": { "application": "synth_application_02", "instance": "synth_instance_02", "st": "synth_st_02" }, "st": "synth_st_02", "refresh_token_id": "synth_refresh_token_id_02", "token_id": "synth_token_id_02", "environnement": "synth_environnement_02", "status_code": "200", "events": [ { "typeEv": "LOGOUT", "message": "HTTP 302 Found" } ] }Ereignis für den Zugriff auf Nutzerressourcen (
USER_RESOURCE_ACCESS){ "timestamp": "2024-10-12T17:24:30.123456789Z", "log_type": "KEYCLOAK", "uuid": "dummy_svc_03", "read_timestamp": "2024-10-12T17:24:30Z", "source_timestamp": "2024-10-12T17:24:30.123456783Z", "object": "synth_object_03", "read_method": "synth_read_method_03", "stream_name": "synth_stream_name_03", "schema_key": "synth_schema_key_03", "sort_keys": "synth_sort_keys_03", "source_metadata": { "schema": "synth_schema_03", "table": "synth_table_03", "is_deleted": true, "change_type": "synth_change_type_03", "tx_id": "synth_tx_id_03", "lsn": "synth_lsn_03", "primary_keys": "synth_primary_keys_03" }, "payload": { "id": "synth_id_03", "client_id": "synth_client_id_03", "error": "synth_error_03", "ip_address": "1.1.1.3", "realm_id": "synth_realm_id_03", "session_id": "synth_session_id_03", "event_time": "2024-10-12T17:24:30Z", "user_id": "dummy_svc_03", "details_json": "{\"parameters\":{}}" }, "username": "dummy_svc_03", "redirect_uri": "synth_redirect_uri_03", "ctx": { "actionId": "synth_actionId_03", "clientId": "synth_clientId_03", "executionId": "synth_executionId_03", "host": "auth-srv-03.dummy.net", "ip": "1.1.1.3", "messageId": "dummy_svc_03@dummy.net", "process": "synth_process_03", "realmId": "synth_realmId_03", "referer": "synth_referer_03", "requestId": "synth_requestId_03", "sessionId": "synth_sessionId_03", "source": "synth_source_03", "trackerId": "synth_trackerId_03", "uri": "synth_uri_03", "userAgent": "dummy_svc_03", "userId": "dummy_svc_03", "username": "dummy_svc_03" }, "env": { "application": "synth_application_03", "instance": "synth_instance_03", "st": "synth_st_03" }, "st": "synth_st_03", "refresh_token_id": "synth_refresh_token_id_03", "token_id": "synth_token_id_03", "environnement": "synth_environnement_03", "status_code": "200", "events": [ { "typeEv": "USER_INFO_REQUEST", "message": "HTTP 401 Found" } ] }Netzwerkverbindungsereignis (
NETWORK_CONNECTION){ "timestamp": "2024-10-12T18:31:43.123456789Z", "log_type": "KEYCLOAK", "uuid": "dummy_auditor_04", "read_timestamp": "2024-10-12T18:31:43Z", "source_timestamp": "2024-10-12T18:31:43.123456784Z", "object": "synth_object_04", "read_method": "synth_read_method_04", "stream_name": "synth_stream_name_04", "schema_key": "synth_schema_key_04", "sort_keys": "synth_sort_keys_04", "source_metadata": { "schema": "synth_schema_04", "table": "synth_table_04", "is_deleted": false, "change_type": "synth_change_type_04", "tx_id": "synth_tx_id_04", "lsn": "synth_lsn_04", "primary_keys": "synth_primary_keys_04" }, "payload": { "id": "synth_id_04", "client_id": "synth_client_id_04", "error": "synth_error_04", "ip_address": "1.1.1.4", "realm_id": "synth_realm_id_04", "session_id": "synth_session_id_04", "event_time": "2024-10-12T18:31:43Z", "user_id": "dummy_auditor_04", "details_json": "{\"parameters\":{}}" }, "username": "dummy_auditor_04", "redirect_uri": "synth_redirect_uri_04", "ctx": { "actionId": "synth_actionId_04", "clientId": "synth_clientId_04", "executionId": "synth_executionId_04", "host": "db-node-04.dummy.net", "ip": "1.1.1.4", "messageId": "dummy_auditor_04@dummy.net", "process": "synth_process_04", "realmId": "synth_realmId_04", "referer": "synth_referer_04", "requestId": "synth_requestId_04", "sessionId": "synth_sessionId_04", "source": "synth_source_04", "trackerId": "synth_trackerId_04", "uri": "synth_uri_04", "userAgent": "dummy_auditor_04", "userId": "dummy_auditor_04", "username": "dummy_auditor_04" }, "env": { "application": "synth_application_04", "instance": "synth_instance_04", "st": "synth_st_04" }, "st": "synth_st_04", "refresh_token_id": "synth_refresh_token_id_04", "token_id": "synth_token_id_04", "environnement": "synth_environnement_04", "status_code": "200", "events": [ { "message": "HTTP 403 Found", "typeEv": "" } ] }Ereignis zur Statusaktualisierung (
STATUS_UPDATE){ "timestamp": "2024-10-12T19:38:56.123456789Z", "log_type": "KEYCLOAK", "uuid": "dummy_analyst_05", "read_timestamp": "2024-10-12T19:38:56Z", "source_timestamp": "2024-10-12T19:38:56.123456785Z", "object": "synth_object_05", "read_method": "synth_read_method_05", "stream_name": "synth_stream_name_05", "schema_key": "synth_schema_key_05", "sort_keys": "synth_sort_keys_05", "source_metadata": { "schema": "synth_schema_05", "table": "synth_table_05", "is_deleted": true, "change_type": "synth_change_type_05", "tx_id": "synth_tx_id_05", "lsn": "synth_lsn_05", "primary_keys": "synth_primary_keys_05" }, "payload": { "id": "synth_id_05", "client_id": "synth_client_id_05", "error": "synth_error_05", "ip_address": "1.1.1.5", "realm_id": "synth_realm_id_05", "session_id": "synth_session_id_05", "event_time": "2024-10-12T19:38:56Z", "user_id": "dummy_analyst_05", "details_json": "{\"parameters\":{}}" }, "username": "dummy_analyst_05", "redirect_uri": "synth_redirect_uri_05", "ctx": { "actionId": "synth_actionId_05", "clientId": "synth_clientId_05", "executionId": "synth_executionId_05", "ip": "1.1.1.5", "messageId": "dummy_analyst_05@dummy.net", "process": "synth_process_05", "realmId": "synth_realmId_05", "referer": "synth_referer_05", "requestId": "synth_requestId_05", "sessionId": "synth_sessionId_05", "source": "synth_source_05", "trackerId": "synth_trackerId_05", "uri": "synth_uri_05", "userAgent": "dummy_analyst_05", "userId": "dummy_analyst_05", "username": "dummy_analyst_05" }, "env": { "application": "synth_application_05", "instance": "synth_instance_05", "st": "synth_st_05" }, "st": "synth_st_05", "refresh_token_id": "synth_refresh_token_id_05", "token_id": "synth_token_id_05", "environnement": "synth_environnement_05", "status_code": "200", "events": [ { "message": "HTTP 404 Found", "typeEv": "" } ] }Nicht kategorisiertes Nutzerereignis (
USER_UNCATEGORIZED){ "timestamp": "2024-10-12T20:45:09.123456789Z", "log_type": "KEYCLOAK", "uuid": "dummy_user_01", "read_timestamp": "2024-10-12T20:45:09Z", "source_timestamp": "2024-10-12T20:45:09.123456786Z", "object": "synth_object_06", "read_method": "synth_read_method_06", "stream_name": "synth_stream_name_06", "schema_key": "synth_schema_key_06", "sort_keys": "synth_sort_keys_06", "source_metadata": { "schema": "synth_schema_06", "table": "synth_table_06", "is_deleted": false, "change_type": "synth_change_type_06", "tx_id": "synth_tx_id_06", "lsn": "synth_lsn_06", "primary_keys": "synth_primary_keys_06" }, "payload": { "id": "synth_id_06", "client_id": "synth_client_id_06", "error": "synth_error_06", "realm_id": "synth_realm_id_06", "session_id": "synth_session_id_06", "event_time": "2024-10-12T20:45:09Z", "user_id": "dummy_user_01", "details_json": "{\"parameters\":{}}" }, "username": "dummy_user_01", "redirect_uri": "synth_redirect_uri_06", "ctx": { "actionId": "synth_actionId_06", "clientId": "synth_clientId_06", "executionId": "synth_executionId_06", "host": "host-01.dummy.net", "messageId": "dummy_user_01@dummy.net", "process": "synth_process_06", "realmId": "synth_realmId_06", "referer": "synth_referer_06", "requestId": "synth_requestId_06", "sessionId": "synth_sessionId_06", "source": "synth_source_06", "trackerId": "synth_trackerId_06", "uri": "synth_uri_06", "userAgent": "dummy_user_01", "userId": "dummy_user_01", "username": "dummy_user_01" }, "env": { "application": "synth_application_06", "instance": "synth_instance_06", "st": "synth_st_06" }, "st": "synth_st_06", "refresh_token_id": "synth_refresh_token_id_06", "token_id": "synth_token_id_06", "environnement": "synth_environnement_06", "status_code": "200", "events": [ { "message": "HTTP 200 Found", "typeEv": "" } ] }Allgemeines Ereignis (
GENERIC_EVENT){ "timestamp": "2024-10-12T21:52:22.123456789Z", "log_type": "KEYCLOAK", "read_timestamp": "2024-10-12T21:52:22Z", "source_timestamp": "2024-10-12T21:52:22.123456787Z", "object": "synth_object_07", "read_method": "synth_read_method_07", "stream_name": "synth_stream_name_07", "schema_key": "synth_schema_key_07", "sort_keys": "synth_sort_keys_07", "source_metadata": { "schema": "synth_schema_07", "table": "synth_table_07", "is_deleted": true, "change_type": "synth_change_type_07", "tx_id": "synth_tx_id_07", "lsn": "synth_lsn_07", "primary_keys": "synth_primary_keys_07" }, "payload": { "id": "synth_id_07", "client_id": "synth_client_id_07", "error": "synth_error_07", "realm_id": "synth_realm_id_07", "session_id": "synth_session_id_07", "event_time": "2024-10-12T21:52:22Z", "user_id": "dummy_admin_02", "details_json": "{\"parameters\":{}}" }, "username": "dummy_admin_02", "redirect_uri": "synth_redirect_uri_07", "ctx": { "actionId": "synth_actionId_07", "clientId": "synth_clientId_07", "executionId": "synth_executionId_07", "host": "gw-edge-02.dummy.net", "messageId": "dummy_admin_02@dummy.net", "process": "synth_process_07", "realmId": "synth_realmId_07", "referer": "synth_referer_07", "requestId": "synth_requestId_07", "sessionId": "synth_sessionId_07", "source": "synth_source_07", "trackerId": "synth_trackerId_07", "uri": "synth_uri_07", "userAgent": "dummy_admin_02", "userId": "dummy_admin_02" }, "env": { "application": "synth_application_07", "instance": "synth_instance_07", "st": "synth_st_07" }, "st": "synth_st_07", "refresh_token_id": "synth_refresh_token_id_07", "token_id": "synth_token_id_07", "environnement": "synth_environnement_07", "status_code": "200", "events": [ { "message": "HTTP 302 Found", "typeEv": "" } ] }
UDM-Zuordnungstabelle
| Logfeld | UDM-Zuordnung | Logik |
|---|---|---|
| payload.client_id | additional.fields | Zusammengeführt mit Feldern, die aus payload.client_id und payload.realm_id erstellt wurden |
| payload.realm_id | additional.fields | |
| source_timestamp | metadata.event_timestamp | Geparsed mit Datumsfilter mit den Mustern ISO8601 und yyyy-MM-dd'T'HH:mm:ss.SSSZ |
| payload.ip_address | metadata.event_type | Wird auf „STATUS_UPDATE“ gesetzt, wenn payload.ip_address nicht leer ist, andernfalls auf „USER_UNCATEGORIZED“, wenn uuid nicht leer ist, andernfalls auf „GENERIC_EVENT“ |
| uuid | metadata.event_type | |
| payload.type | metadata.product_event_type | Wert direkt kopiert |
| payload.session_id | network.session_id | Wert direkt kopiert |
| payload.ip_address | principal.ip | Wert direkt kopiert |
| source_metadata.schema | principal.resource.attribute.labels | Zusammengeführt mit Labels, die aus source_metadata.schema, source_metadata.table, source_metadata.is_deleted (in String konvertiert), source_metadata.change_type, source_metadata.tx_id, source_metadata.lsn erstellt wurden |
| source_metadata.table | principal.resource.attribute.labels | |
| source_metadata.is_deleted | principal.resource.attribute.labels | |
| source_metadata.change_type | principal.resource.attribute.labels | |
| source_metadata.tx_id | principal.resource.attribute.labels | |
| source_metadata.lsn | principal.resource.attribute.labels | |
| uuid | principal.user.userid | Wert direkt kopiert |
| Objekt | security_result.detection_fields | Zusammengeführt mit Labels, die aus „object“, „read_method“ und „payload.id“ erstellt wurden |
| read_method | security_result.detection_fields | |
| payload.id | security_result.detection_fields | |
| redirect_uri | target.url | Wert direkt kopiert |
| Nutzername | target.user.userid | Wert direkt kopiert |
| metadata.product_name | metadata.product_name | Legen Sie diesen Wert auf „KEYCLOAK“ fest. |
| metadata.vendor_name | metadata.vendor_name | Legen Sie diesen Wert auf „KEYCLOAK“ fest. |
username" from "details_json |
target.user.userid |
Aus Änderungsprotokoll zugeordnet |
redirect_uri" from "details_json |
target.url |
Aus Änderungsprotokoll zugeordnet |
realm_id" and "client_id |
additional.fields |
Aus Änderungsprotokoll zugeordnet |
Änderungsprotokoll
Änderungsprotokoll für diesen Parser ansehen
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten