Recopila registros de Cisco Identity Intelligence
En este documento, se explica cómo configurar Cisco Identity Intelligence para enviar registros a Google Security Operations con webhooks.
Cisco Identity Intelligence (antes Oort Security) es una plataforma de detección y respuesta ante amenazas de identidad que supervisa continuamente el comportamiento de los usuarios, los patrones de autenticación, el uso de dispositivos y los privilegios de acceso en todos los proveedores de identidad. Detecta amenazas basadas en la identidad, parámetros de configuración incorrectos y violaciones de cumplimiento a través del análisis de la actividad del usuario, las verificaciones de seguridad con errores, las puntuaciones de confianza y los comportamientos riesgosos.
Antes de comenzar
Asegúrate de cumplir con los siguientes requisitos:
- Una instancia de Google SecOps
- Acceso con privilegios a un usuario de Cisco Identity Intelligence
- Permisos administrativos para gestionar integraciones en Cisco Identity Intelligence
- Acceso a la Google Cloud Console (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,
Cisco Identity Intelligence Events). - Selecciona Webhook como el Tipo de origen.
- Selecciona Cisco Identity Intelligence 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 eventos de varias líneas. - 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.
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 Google Cloud Console.
Crea la clave de API
- Ve a la página Credenciales de la consola de Google 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.
Configura el webhook de Cisco Identity Intelligence
Crea la URL de webhook
Combina la URL del extremo de Chronicle y la clave de API:
<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>Ejemplo:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
Reemplaza lo siguiente:
<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.
Crea un destino de notificación de webhook en Cisco Identity Intelligence
- Accede a Cisco Identity Intelligence.
- Ve a Integraciones.
- Haz clic en Agregar integración.
- Desplázate hacia abajo hasta la sección Webhook.
- Haz clic en Agregar destino de webhook.
- Proporciona los siguientes detalles de configuración:
- Nombre: Ingresa un nombre descriptivo (por ejemplo,
Chronicle SIEM Integration). - URL de webhook: Pega la URL del extremo completa con la clave de API y la clave secreta que se mencionaron anteriormente.
- Tipo de autorización: Selecciona Clave de API.
- Nombre de la clave de API: Ingresa un nombre de clave (por ejemplo,
x-goog-chronicle-auth). - Valor de la clave de API: Ingresa la clave de API de Google Cloud.
- Nombre: Ingresa un nombre descriptivo (por ejemplo,
- Expande la sección Parámetros HTTP de invocación.
- Agrega los siguientes parámetros con el tipo Encabezado:
- Clave:
Content-Type, Valor:application/json - Clave:
Accept, Valor:application/json
- Clave:
- En la sección Usa este destino para, selecciona Verificación fallida para recibir notificaciones cuando las verificaciones de identidad detecten resultados fallidos.
Haz clic en Guardar.
Prueba la conexión del webhook
- En la página Integraciones, busca el destino de notificación de webhook que creaste.
- Haz clic en el menú de tres puntos que se encuentra en el lado derecho de la fila.
- Selecciona Probar conectividad.
- Verifica que el mensaje de prueba se haya entregado correctamente.
Habilita el webhook para las verificaciones de identidad
Después de crear el destino de notificación de webhook, debes habilitarlo para las verificaciones de identidad específicas que deseas supervisar.
- Ve a la página de detalles de la verificación que desees en Cisco Identity Intelligence.
- Expande el menú desplegable que se encuentra en la esquina superior derecha de la página.
- Selecciona la casilla de verificación del destino de notificación de webhook que creaste.
Repite el proceso para cada verificación que quieras enviar a Google SecOps.
Para obtener más información, consulta la documentación del webhook de Cisco Identity Intelligence.
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 mejorar la 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)
Algunas configuraciones 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 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 |
Tabla de asignación de UDM
| Campo de registro | Asignación de UDM | Lógica |
|---|---|---|
| cuenta | account_label.value | El valor se copia directamente. |
| cuenta | account_label.key | Establece el valor en "account". |
| account_label | security_result.detection_fields | Se combinó en detection_fields |
| additional_detaildescription.key | additional_detaildescription.key | Se estableció en "descripción detallada" |
| detaildescription | additional_detaildescription.value.list_value.values | Se combinó desde detaildescription |
| additional_detaildescription | event.idm.read_only_udm.additional.fields | Se combinó con additional.fields |
| additional_recommendedaction.key | additional_recommendedaction.key | Se estableció en "acción recomendada". |
| recommendedAction | additional_recommendedaction.value.list_value.values | Se combinó desde recommendedAction |
| additional_recommendedaction | event.idm.read_only_udm.additional.fields | Se combinó con additional.fields |
| datos1 | usersFailing_label | El valor se copia directamente. |
| data.login | login_label | El valor se copia directamente. |
| detail-type | security_result.summary | El valor se copia directamente. |
| detail.id | security_result.rule_id | El valor se copia directamente. |
| detail.title | security_result.rule_name | El valor se copia directamente. |
| detail.severity | security_result.severity | Valor de detail.severity si está en [CRITICAL,ERROR,HIGH,INFORMATIONAL,LOW,MEDIUM]; de lo contrario, MEDIUM si es moderado |
| detaildescription | value_array.string_value | El valor se copia directamente. |
| detailsdata.key | add_label.value, add_label.key | Valor de detailsdata.value, clave como "loginDetails %{index} details %{detailindex} %{detailsdata.key}" si no es failedSigninDetails o ips |
| detailsdata.value | add_label.value, add_label.key | |
| detailsdata.key | security_result.detection_fields | Se combinó add_label si se cumplieron las condiciones |
| detailsdata.value | security_result.detection_fields | |
| field_.value | security_result.detection_fields | Se combinaron varios campos anidados en json_array (msg, ipInfo, asn, coordinates, first_event, second_event, locations) con claves como "%{index} %{detailindex} %{index1} %{key}", etc., sin incluir ipAddress, ip, etc. |
| field_.key | security_result.detection_fields | |
| id | metadata.product_log_id | El valor se copia directamente. |
| login_label | principal.user.email_addresses | Se combina si coincide con la regex de correo electrónico |
| msg.ipAddress | principal.ip | Se combina si no está vacío |
| msg.first_event.ip_address | principal.ip | Se combina si no está vacío |
| msg.second_event.ip_address | principal.ip | Se combina si no está vacío |
| msg_travels_first_event_ip_address | principal.ip | Se combina si no está vacío |
| msg_travels_second_event_ip_address | principal.ip | |
| recommendedAction | value_array.string_value | El valor se copia directamente. |
| security_result | event.idm.read_only_udm.security_result | Se combinó con security_result |
| source | source_label.value | El valor se copia directamente. |
| source | source_label.key | Establece el valor en "source". |
| source_label | event.idm.read_only_udm.src.labels | Se combinó en src.labels |
| hora | @timestamp | Se analiza con el filtro de fecha con ISO8601, RFC 3339, yyyy-MM-ddTHH:mm:ss.SSSSSSZ |
| usersFailing_label | principal.user.email_addresses | Se combina si coincide con la regex de correo electrónico |
| versión | metadata.product_version | El valor se copia directamente. |
| has_principal | event.idm.read_only_udm.metadata.event_type | Se establece en "STATUS_UPDATE" si has_principal es verdadero; de lo contrario, se establece en "USER_UNCATEGORIZED" si has_user es verdadero; de lo contrario, se establece en "GENERIC_EVENT". |
| has_user | event.idm.read_only_udm.metadata.event_type | |
| metadata.product_name | metadata.product_name | Establece el valor en "OORT". |
| metadata.vendor_name | metadata.vendor_name | Establece el valor en "OORT". |
detail.published |
event.idm.read_only_udm.metadata.collected_timestamp |
Asignado desde el registro de cambios |
detail.login |
event.idm.read_only_udm.principal.user.userid |
Asignado desde el registro de cambios |
detail.userTrustLevel |
event.idm.read_only_udm.principal.user.attribute.labels |
Asignado desde el registro de cambios |
detail.login |
event.idm.read_only_udm.principal.user.user_display_name |
Asignado desde el registro de cambios |
detail.checkTopics |
event.idm.read_only_udm.security_result.category_details |
Asignado desde el registro de cambios |
region |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
detail.checkId |
event.idm.read_only_udm.security_result.detection_fields |
Asignado desde el registro de cambios |
detail.checkScope |
event.idm.read_only_udm.security_result.detection_fields |
Asignado desde el registro de cambios |
detail.frameworks |
event.idm.read_only_udm.security_result.detection_fields |
Asignado desde el registro de cambios |
detail.explainabilityEventIds |
event.idm.read_only_udm.security_result.detection_fields |
Asignado desde el registro de cambios |
data.value |
event.idm.read_only_udm.security_result.detection_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.