Recopila registros de Keycloak
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
- Ve a Configuración > Administración de datos > Feeds. Si estás en una plataforma solo de SIEM, ve a Configuración > Feeds.
- Haz clic en Agregar feed nuevo.
- En la página siguiente, haz clic en Configurar un solo feed.
- En el campo Nombre del feed, ingresa un nombre para el feed (por ejemplo,
Keycloak Events). - Selecciona Webhook como el Tipo de origen.
- Selecciona Keycloak como el Tipo de registro.
- Haz clic en Siguiente.
- Especifica valores para los siguientes parámetros de entrada:
- Delimitador de división (opcional): Ingresa
\npara 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.
- Delimitador de división (opcional): Ingresa
- Haz clic en Siguiente.
- 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:
- En la página de detalles del feed, haz clic en Generar clave secreta.
- Aparecerá un diálogo con la clave secreta.
- 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
- Ve a la pestaña Detalles del feed.
- En la sección Información del extremo, copia la URL del extremo del feed.
El formato de la URL es el siguiente:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:importDonde
{region}es la región de tu instancia de Google SecOps (por ejemplo,us,europeoasia-southeast1) y{parent}es la ruta de acceso del recurso en el formatoprojects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.Guarda esta URL para los próximos pasos.
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
- Ve a la página Credenciales de la consola deGoogle Cloud .
- Selecciona tu proyecto (el proyecto asociado con tu instancia de Chronicle).
- Haz clic en Crear credenciales > Clave de API.
- Se creará una clave de API y se mostrará en un diálogo.
- Haz clic en Editar clave de API para restringir la clave.
Restringe la clave de API
- 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).
- Nombre: Ingresa un nombre descriptivo (por ejemplo,
- En Restricciones de API, haz lo siguiente:
- Selecciona Restringir clave.
- En el menú desplegable Seleccionar APIs, busca y selecciona API de Google SecOps (o API de Chronicle).
- Haz clic en Guardar.
- Copia el valor de la clave de API del campo Clave de API que se encuentra en la parte superior de la página.
- 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
- Accede a la Consola del administrador de Keycloak.
- Selecciona el dominio que deseas supervisar en el menú desplegable de dominios que se encuentra en la esquina superior izquierda.
- Ve a Configuración de dominios > Eventos.
- Selecciona la pestaña secundaria Configuración de eventos de usuario.
- Habilita el botón de activación Guardar eventos.
- Establece el período de Vencimiento (se recomienda un mínimo de 7 días).
- Haz clic en Guardar.
Habilitar eventos de administrador
- En la misma pestaña Eventos, selecciona la pestaña secundaria Configuración de eventos de administrador.
- Habilita el botón de activación Guardar eventos.
- Habilita el botón de activación Incluir representación para capturar todos los detalles de los objetos modificados.
- Establece el período de Vencimiento (se recomienda un mínimo de 7 días).
- 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
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 installCopia el archivo JAR fat resultante en el directorio
providersde Keycloak:cp target/keycloak-events-*.jar /opt/keycloak/providers/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
- Accede a la Consola del administrador de Keycloak.
- Selecciona el dominio de destino en el menú desplegable de dominios.
- Ve a Configuración de dominios > Eventos.
- En el menú desplegable Objetos de escucha de eventos, selecciona ext-event-webhook.
- 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,masteromy-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 accesoadmin.*: 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.
Método 1: Encabezados personalizados (recomendado)
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.