Recopila registros de Keycloak

Compatible con:

En este documento, se explica cómo configurar Keycloak para enviar registros a Google Security Operations con webhooks.

Keycloak es una solución de administración de identidades y accesos (IAM) de código abierto que proporciona funciones de inicio de sesión único (SSO), federación de usuarios, intermediación de identidades y acceso con redes sociales. Admite los protocolos OpenID Connect, OAuth 2.0 y SAML 2.0, y hace un seguimiento de los eventos de los usuarios (acceso, salida, registro y cambios de contraseña) y de los administradores (operaciones de administración de usuarios, clientes, dominios y roles) para la auditoría de seguridad.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

  • Una instancia de Google SecOps
  • Una instancia de Keycloak en ejecución (se recomienda la versión 20 o una posterior)
  • Acceso de administrador a la Consola del administrador de Keycloak
  • Acceso al sistema de archivos o al contenedor del servidor de Keycloak para implementar extensiones
  • Acceso a la consola de Google Cloud (para crear claves de API)

Crea un feed de webhook en Google SecOps

Crea el feed

  1. Ve a Configuración > Administración de datos > Feeds. Si estás en una plataforma solo de SIEM, ve a Configuración > Feeds.
  2. Haz clic en Agregar feed nuevo.
  3. En la página siguiente, haz clic en Configurar un solo feed.
  4. En el campo Nombre del feed, ingresa un nombre para el feed (por ejemplo, Keycloak Events).
  5. Selecciona Webhook como el Tipo de origen.
  6. Selecciona Keycloak como el Tipo de registro.
  7. Haz clic en Siguiente.
  8. Especifica valores para los siguientes parámetros de entrada:
    • Delimitador de división (opcional): Ingresa \n para dividir los eventos de varias líneas (cada POST de webhook contiene un solo evento, por lo que se puede dejar vacío).
    • Espacio de nombres del recurso: Es el espacio de nombres del recurso.
    • Etiquetas de transferencia: Es la etiqueta que se aplicará a los eventos de este feed.
  9. Haz clic en Siguiente.
  10. Revisa la configuración de tu feed de noticias nuevo en la pantalla Finalizar y, luego, haz clic en Enviar.

Genera y guarda la clave secreta

Después de crear el feed, debes generar una clave secreta para la autenticación:

  1. En la página de detalles del feed, haz clic en Generar clave secreta.
  2. Aparecerá un diálogo con la clave secreta.
  3. Copia y guarda la clave secreta de forma segura.

Importante: La clave secreta se muestra solo una vez y no se puede recuperar más adelante. Si la pierdes, deberás generar una nueva.

Obtén la URL del extremo del feed

  1. Ve a la pestaña Detalles del feed.
  2. En la sección Información del extremo, copia la URL del extremo del feed.
  3. El formato de la URL es el siguiente:

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

    Donde {region} es la región de tu instancia de Google SecOps (por ejemplo, us, europe o asia-southeast1) y {parent} es la ruta de acceso del recurso en el formato projects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.

  4. Guarda esta URL para los próximos pasos.

  5. Haz clic en Listo.

Crea una clave de API de Google Cloud

Chronicle requiere una clave de API para la autenticación. Crea una clave de API restringida en la consola de Google Cloud .

Crea la clave de API

  1. Ve a la página Credenciales de la consola deGoogle Cloud .
  2. Selecciona tu proyecto (el proyecto asociado con tu instancia de Chronicle).
  3. Haz clic en Crear credenciales > Clave de API.
  4. Se creará una clave de API y se mostrará en un diálogo.
  5. Haz clic en Editar clave de API para restringir la clave.

Restringe la clave de API

  1. En la página de configuración de la clave de API, haz lo siguiente:
    • Nombre: Ingresa un nombre descriptivo (por ejemplo, Chronicle Webhook API Key).
  2. En Restricciones de API, haz lo siguiente:
    1. Selecciona Restringir clave.
    2. En el menú desplegable Seleccionar APIs, busca y selecciona API de Google SecOps (o API de Chronicle).
  3. Haz clic en Guardar.
  4. Copia el valor de la clave de API del campo Clave de API que se encuentra en la parte superior de la página.
  5. Guarda la clave de API de forma segura.

Habilita el almacenamiento de eventos en Keycloak

Antes de configurar la extensión de webhook, habilita el almacenamiento de eventos en Keycloak para que se generen y estén disponibles para el reenvío.

Habilita los eventos de usuario

  1. Accede a la Consola del administrador de Keycloak.
  2. Selecciona el dominio que deseas supervisar en el menú desplegable de dominios que se encuentra en la esquina superior izquierda.
  3. Ve a Configuración de dominios > Eventos.
  4. Selecciona la pestaña secundaria Configuración de eventos de usuario.
  5. Habilita el botón de activación Guardar eventos.
  6. Establece el período de Vencimiento (se recomienda un mínimo de 7 días).
  7. Haz clic en Guardar.

Habilitar eventos de administrador

  1. En la misma pestaña Eventos, selecciona la pestaña secundaria Configuración de eventos de administrador.
  2. Habilita el botón de activación Guardar eventos.
  3. Habilita el botón de activación Incluir representación para capturar todos los detalles de los objetos modificados.
  4. Establece el período de Vencimiento (se recomienda un mínimo de 7 días).
  5. Haz clic en Guardar.

Instala la extensión de objeto de escucha de eventos de webhook

Keycloak no incluye un objeto de escucha de eventos de webhook nativo. Instala la extensión keycloak-events de Phase Two (p2-inc) para habilitar la entrega de webhooks.

Descarga e implementa la extensión

  1. Descarga el JAR de la versión más reciente desde la página de versiones de keycloak-events en Maven Central o compílalo desde la fuente:

    git clone https://github.com/p2-inc/keycloak-events.git
    cd keycloak-events
    mvn clean install
    
  2. Copia el archivo JAR fat resultante en el directorio providers de Keycloak:

    cp target/keycloak-events-*.jar /opt/keycloak/providers/
    
  3. Vuelve a compilar y reiniciar Keycloak:

    /opt/keycloak/bin/kc.sh build
    /opt/keycloak/bin/kc.sh start
    

Habilita el objeto de escucha de eventos de webhook

  1. Accede a la Consola del administrador de Keycloak.
  2. Selecciona el dominio de destino en el menú desplegable de dominios.
  3. Ve a Configuración de dominios > Eventos.
  4. En el menú desplegable Objetos de escucha de eventos, selecciona ext-event-webhook.
  5. Haz clic en Guardar.

Configura el webhook de Keycloak

Crea la URL de webhook

  • Combina la URL del extremo de Chronicle y la clave de API:

    <ENDPOINT_URL>?key=<API_KEY>
    
  • Ejemplo:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...
    

Crea una suscripción de webhook a través de la API de REST de Keycloak

La extensión keycloak-events proporciona extremos de REST para administrar las suscripciones de webhook. Usa la API de REST de administrador de Keycloak para crear un webhook.

Paso 1: Obtén un token de acceso

  • Solicita un token de acceso de Keycloak con una cuenta de administrador:

    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')
    

Reemplaza lo siguiente:

  • <KEYCLOAK_HOST>: El nombre de host y el puerto de tu servidor de Keycloak (por ejemplo, keycloak.example.com:8443)
  • <ADMIN_USERNAME>: Es tu nombre de usuario de administrador de Keycloak.
  • <ADMIN_PASSWORD>: Es tu contraseña de administrador de Keycloak.

Paso 2: Crea el webhook

  • Envía una solicitud POST para crear la suscripción al webhook para el dominio de destino:

    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": ["*"]
      }'
    

Reemplaza lo siguiente:

  • <KEYCLOAK_HOST>: Es el nombre de host de tu servidor de Keycloak.
  • <REALM_NAME>: Es el nombre del dominio que se supervisará (por ejemplo, master o my-realm).
  • <ENDPOINT_URL>: Es la URL del extremo del feed de Chronicle que se copió antes.
  • <API_KEY>: Es la clave de API de Google Cloud que se creó antes.
  • <SECRET_KEY>: Es la clave secreta del webhook de Chronicle que se generó antes.
  • <WEBHOOK_HMAC_SECRET>: Es una cadena de secreto arbitraria para la firma HMAC de las cargas útiles de webhook (por ejemplo, mySecretKey123).

Paso 3: Verifica el webhook

  • Para confirmar que se creó el webhook, enumera todos los webhooks del dominio:

    curl -sS -X GET "https://<KEYCLOAK_HOST>/realms/<REALM_NAME>/webhooks" \
      -H "Authorization: Bearer ${TOKEN}" \
      -H "Accept: application/json"
    

La respuesta devuelve una lista de objetos de webhook. Verifica que tu webhook aparezca con "enabled": "true" y la URL correcta.

Tipos de eventos de webhook

El campo eventTypes acepta un array de expresiones para filtrar qué eventos se envían:

  • *: Envía todos los eventos (recomendado para la integración de SIEM).
  • access.*: Envía todos los eventos de acceso
  • admin.*: Envía todos los eventos de administrador.
  • admin.USER-*: Envía todos los eventos de administrador relacionados con los usuarios.
  • admin-USER-CREATE: Envía solo eventos de administrador de creación de usuarios.

Comportamiento de reintento de webhook

La extensión usa la retirada exponencial automática para los reintentos cuando se recibe una respuesta que no es 2xx:

Parámetro Valor predeterminado Descripción
backoffInitialInterval 500 ms Intervalo de reintento inicial
backoffMaxElapsedTime 900,000 ms (15 min) Tiempo total máximo de reintentos
backoffMaxInterval 180000 ms (3 min) Intervalo máximo entre reintentos
backoffMultiplier 5 Multiplicador para cada intervalo de reintento
backoffRandomizationFactor 0.5 Factor de aleatorización para la fluctuación

Referencia de los métodos de autenticación

Los feeds de webhook de Chronicle admiten varios métodos de autenticación. Elige el método que admita tu proveedor.

Si tu proveedor admite encabezados HTTP personalizados, usa este método para obtener una mayor seguridad.

  • Formato de la solicitud:

    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"
    }
    

Ventajas:

  • La clave de API y el secreto no son visibles en la URL
  • Más seguro (los encabezados no se registran en los registros de acceso del servidor web)
  • Es el método preferido cuando el proveedor lo admite.

Método 2: Parámetros de consulta

Si tu proveedor no admite encabezados personalizados, agrega credenciales a la URL.

  • Formato de la URL:

    <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>
    
  • Ejemplo:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
    
  • Formato de la solicitud:

    POST <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY> HTTP/1.1
    Content-Type: application/json
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

Desventajas:

  • Credenciales visibles en la URL
  • Se puede registrar en los registros de acceso del servidor web
  • Menos seguro que los encabezados

Método 3: Híbrido (URL y encabezado)

Algunos parámetros de configuración usan la clave de API en la URL y la clave secreta en el encabezado.

  • Formato de la solicitud:

    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"
    }
    

Nombres de encabezados de autenticación

Chronicle acepta los siguientes nombres de encabezado para la autenticación:

Para la clave de API:

  • x-goog-chronicle-auth (recomendada)
  • X-Goog-Chronicle-Auth (no distingue mayúsculas de minúsculas)

Para la clave secreta:

  • x-chronicle-auth (recomendada)
  • X-Chronicle-Auth (no distingue mayúsculas de minúsculas)

Límites y prácticas recomendadas para los webhooks

Límites de solicitudes

Límite Valor
Tamaño máximo de la solicitud 4 MB
QPS máx. (consultas por segundo) 15,000
Tiempo de espera de la solicitud 30 segundos
Comportamiento de reintento Automática con retirada exponencial

Registros de muestra admitidos

En los siguientes ejemplos, se muestran los registros JSON de Keycloak que el analizador predeterminado asigna a los tipos de eventos del modelo de datos unificado (UDM):

  • Evento de acceso del usuario (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"
        }
      ]
    }
    
  • Evento de salida del usuario (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"
        }
      ]
    }
    
  • Evento de acceso a recursos del usuario (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"
        }
      ]
    }
    
  • Evento de conexión de red (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": ""
        }
      ]
    }
    
  • Evento de actualización de estado (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": ""
        }
      ]
    }
    
  • Evento de usuario sin categorizar (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": ""
        }
      ]
    }
    
  • Evento genérico (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": ""
        }
      ]
    }
    

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
payload.client_id additional.fields Se combinó con los campos creados a partir de payload.client_id y payload.realm_id
payload.realm_id additional.fields
source_timestamp metadata.event_timestamp Se analiza con el filtro de fecha con los patrones ISO8601 y yyyy-MM-dd'T'HH:mm:ss.SSSZ
payload.ip_address metadata.event_type Se establece en "STATUS_UPDATE" si payload.ip_address no está vacío; de lo contrario, se establece en "USER_UNCATEGORIZED" si uuid no está vacío; de lo contrario, se establece en "GENERIC_EVENT".
uuid metadata.event_type
payload.type metadata.product_event_type El valor se copia directamente.
payload.session_id network.session_id El valor se copia directamente.
payload.ip_address principal.ip El valor se copia directamente.
source_metadata.schema principal.resource.attribute.labels Se combinó con las etiquetas creadas a partir de source_metadata.schema, source_metadata.table, source_metadata.is_deleted (convertido en cadena), source_metadata.change_type, source_metadata.tx_id y source_metadata.lsn
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 El valor se copia directamente.
objeto security_result.detection_fields Se combinó con las etiquetas creadas a partir de object, read_method y payload.id
read_method security_result.detection_fields
payload.id security_result.detection_fields
redirect_uri target.url El valor se copia directamente.
nombre de usuario target.user.userid El valor se copia directamente.
metadata.product_name metadata.product_name Establece en "KEYCLOAK".
metadata.vendor_name metadata.vendor_name Establece en "KEYCLOAK".
username" from "details_json target.user.userid Asignado desde el registro de cambios
redirect_uri" from "details_json target.url Asignado desde el registro de cambios
realm_id" and "client_id additional.fields Asignado desde el registro de cambios

Registro de cambios

Consulta el registro de cambios de este analizador

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.