Keycloak-Logs erfassen

Unterstützt in:

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

  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. Keycloak Events.
  5. Wählen Sie Webhook als Quelltyp aus.
  6. Wählen Sie Keycloak als Logtyp aus.
  7. Klicken Sie auf Weiter.
  8. Geben Sie Werte für die folgenden Eingabeparameter an:
    • Trennzeichen für Aufteilung (optional): Geben Sie \n ein, 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.
  9. Klicken Sie auf Weiter.
  10. 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:

  1. Klicken Sie auf der Feed-Detailseite auf Geheimen Schlüssel generieren.
  2. In einem Dialogfeld wird der geheime Schlüssel angezeigt.
  3. 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

  1. Gehen Sie zum Tab Details des Feeds.
  2. Kopieren Sie im Abschnitt Endpunktinformationen die Feed-Endpunkt-URL.
  3. Das URL-Format lautet:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import
    

    Dabei ist {region} die Region Ihrer Google SecOps-Instanz (z. B. us, europe oder asia-southeast1) und {parent} der Ressourcenpfad im Format projects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.

  4. Speichern Sie diese URL für die nächsten Schritte.

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

  1. Rufen Sie die Seite „Anmeldedaten“ derGoogle Cloud Console auf.
  2. Wählen Sie Ihr Projekt aus (das Projekt, das mit Ihrer Chronicle-Instanz verknüpft ist).
  3. Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel.
  4. Ein API-Schlüssel wird erstellt und in einem Dialogfeld angezeigt.
  5. Klicken Sie auf API-Schlüssel bearbeiten, um den Schlüssel einzuschränken.

API-Schlüssel einschränken

  1. 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).
  2. Gehen Sie unter API-Einschränkungen so vor:
    1. Wählen Sie Schlüssel einschränken aus.
    2. Suchen Sie im Drop-down-Menü APIs auswählen nach der Google SecOps API (oder Chronicle API) und wählen Sie sie aus.
  3. Klicken Sie auf Speichern.
  4. Kopieren Sie den Wert des API-Schlüssels aus dem Feld API-Schlüssel oben auf der Seite.
  5. 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

  1. Melden Sie sich in der Keycloak-Admin-Konsole an.
  2. Wählen Sie links oben im Drop-down-Menü den Realm aus, den Sie beobachten möchten.
  3. Rufen Sie Realm Settings > Events auf.
  4. Wählen Sie den Untertab Einstellungen für Nutzerereignisse aus.
  5. Aktivieren Sie die Option Termine speichern.
  6. Legen Sie den Ablaufzeitraum fest (empfohlen: mindestens 7 Tage).
  7. Klicken Sie auf Speichern.

Administratorereignisse aktivieren

  1. Wählen Sie auf dem Tab Ereignisse den Untertab Einstellungen für Administratorereignisse aus.
  2. Aktivieren Sie die Option Termine speichern.
  3. Aktivieren Sie die Option Darstellung einschließen, um alle Details der geänderten Objekte zu erfassen.
  4. Legen Sie den Ablaufzeitraum fest (empfohlen: mindestens 7 Tage).
  5. 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

  1. 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 install
    
  2. Kopieren Sie die resultierende Fat-JAR-Datei in das Keycloak-Verzeichnis providers:

    cp target/keycloak-events-*.jar /opt/keycloak/providers/
    
  3. 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

  1. Melden Sie sich in der Keycloak-Admin-Konsole an.
  2. Wählen Sie im Drop-down-Menü „Realm“ den Ziel-Realm aus.
  3. Rufen Sie Realm Settings > Events auf.
  4. Wählen Sie im Drop-down-Menü Event-Listener die Option ext-event-webhook aus.
  5. 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. master oder my-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 senden
  • admin.*: Alle Administratorereignisse senden
  • admin.USER-*: Alle Administratorereignisse im Zusammenhang mit Nutzern senden
  • admin-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.

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