Recopila registros de Cisco Identity Intelligence

Compatible con:

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

  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, Cisco Identity Intelligence Events).
  5. Selecciona Webhook como el Tipo de origen.
  6. Selecciona Cisco Identity Intelligence 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 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.
  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.

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 Google Cloud Console.

Crea la clave de API

  1. Ve a la página Credenciales de la consola de Google 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.

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

  1. Accede a Cisco Identity Intelligence.
  2. Ve a Integraciones.
  3. Haz clic en Agregar integración.
  4. Desplázate hacia abajo hasta la sección Webhook.
  5. Haz clic en Agregar destino de webhook.
  6. 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.
  7. Expande la sección Parámetros HTTP de invocación.
  8. Agrega los siguientes parámetros con el tipo Encabezado:
    • Clave: Content-Type, Valor: application/json
    • Clave: Accept, Valor: application/json
  9. En la sección Usa este destino para, selecciona Verificación fallida para recibir notificaciones cuando las verificaciones de identidad detecten resultados fallidos.
  10. Haz clic en Guardar.

Prueba la conexión del webhook

  1. En la página Integraciones, busca el destino de notificación de webhook que creaste.
  2. Haz clic en el menú de tres puntos que se encuentra en el lado derecho de la fila.
  3. Selecciona Probar conectividad.
  4. 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.

  1. Ve a la página de detalles de la verificación que desees en Cisco Identity Intelligence.
  2. Expande el menú desplegable que se encuentra en la esquina superior derecha de la página.
  3. Selecciona la casilla de verificación del destino de notificación de webhook que creaste.
  4. 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.

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.