Recopila registros de Aqua Security

Versión del analizador: 1.0

Compatible con:

Este analizador extrae campos de los registros de Aqua Security y los transforma en el modelo de datos unificado (UDM). Analiza el campo message como JSON, extrae el usuario, la IP de origen y otros campos relevantes, los asigna a campos de UDM y categoriza los eventos según el campo action, lo que enriquece los datos con contexto de seguridad, como nombres de reglas, descripciones y detalles de CVE.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

  • Instancia de Google SecOps.
  • Acceso con privilegios a la consola de administración de Aqua Security

Cómo configurar feeds

Para configurar un feed, sigue estos pasos:

  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, Registros de Aqua Security).
  5. Selecciona Webhook como el Tipo de origen.
  6. Selecciona Aqua Security como el Tipo de registro.
  7. Haz clic en Siguiente.
  8. Opcional: Especifica valores para los siguientes parámetros de entrada:
    • Delimitador de división: Es el delimitador que se usa para separar las líneas de registro, como \n.
    • Espacio de nombres del recurso: Es el espacio de nombres del recurso.
    • Etiquetas de transferencia: Es la etiqueta que se aplica a los eventos de este feed.
  9. Haz clic en Siguiente.
  10. Revisa la configuración del feed en la pantalla Finalizar y, luego, haz clic en Enviar.
  11. Haz clic en Generar clave secreta para generar una clave secreta que autentique este feed.
  12. Copia y almacena la clave secreta. No puedes volver a ver esta clave secreta. Si es necesario, puedes volver a generar una clave secreta nueva, pero esta acción hará que la clave secreta anterior quede obsoleta.
  13. En la pestaña Detalles, copia la URL del extremo del feed del campo Información del extremo. Debes especificar esta URL de extremo en tu aplicación cliente.
  14. Haz clic en Listo.

Crea una clave de API para el feed de webhook

  1. Ve a la consola deGoogle Cloud > Credenciales.

    Ir a Credenciales

  2. Haz clic en Crear credenciales y selecciona Clave de API.

  3. Restringe el acceso de la clave de API a la API de Chronicle.

Especifica la URL del extremo

  1. En tu aplicación cliente, especifica la URL del extremo HTTPS que se proporciona en el feed de webhook.
  2. Para habilitar la autenticación, especifica la clave de API y la clave secreta como parte del encabezado personalizado en el siguiente formato:

    X-goog-api-key = API_KEY
    X-Webhook-Access-Key = SECRET
    

    Recomendación: Especifica la clave de API como un encabezado en lugar de especificarla en la URL.

  3. Si tu cliente de webhook no admite encabezados personalizados, puedes especificar la clave de API y la clave secreta con parámetros de consulta en el siguiente formato:

    ENDPOINT_URL?key=API_KEY&secret=SECRET
    

    Reemplaza lo siguiente:

    • ENDPOINT_URL: Es la URL del extremo del feed.
    • API_KEY: Es la clave de API para autenticarse en Google SecOps.
    • SECRET: Es la clave secreta que generaste para autenticar el feed.

Crea un webhook en Aqua Security para Google SecOps

  1. Accede a la consola de Aqua Security.
  2. Ve a Configuración > Webhook de resultados del análisis de imágenes.
  3. Marca la casilla de verificación Habilitar el envío de resultados del análisis de imágenes.
  4. Ingresa el <ENDPOINT_URL>, seguido de <API_KEY> y <SECRET>.
  5. Haz clic en Guardar.

Tabla de asignación de UDM

Campo de registro (en orden ascendente) Asignación de UDM Lógica
jsonPayload.action metadata.event_type Se asigna según el valor de "jsonPayload.action". Consulta el código del analizador para ver las asignaciones específicas.
jsonPayload.action security_result.summary Asignado directamente.
jsonPayload.adjective target.file.full_path Se asigna directamente si "jsonPayload.container" está vacío.
jsonPayload.category target.asset.category Asignado directamente.
jsonPayload.cfappname target.application Asignado directamente.
jsonPayload.cfspace principal.user.userid Se asigna directamente si "jsonPayload.user" está vacío.
jsonPayload.command principal.ip Se extrajo con el patrón de grok "user %{GREEDYDATA:user_id} \(%{IP:src_ip}\)".
jsonPayload.command principal.user.userid Se extrajo con el patrón de grok "user %{GREEDYDATA:user_id} \(%{IP:src_ip}\)".
jsonPayload.container target.asset.product_object_id Asignado directamente.
jsonPayload.data security_result.detection_fields Se analiza como pares clave-valor y se asigna a campos individuales dentro de "security_result.detection_fields".
jsonPayload.description security_result.description Se asigna directamente si 'jsonPayload.reason' está vacío.
jsonPayload.host principal.hostname Asignado directamente.
jsonPayload.hostgroup target.group.group_display_name Asignado directamente.
jsonPayload.hostid target.asset_id Se asignó como "ID de host: %{jsonPayload.hostid}".
jsonPayload.hostip target.ip Asignado directamente.
jsonPayload.image target.file.full_path Asignado directamente.
jsonPayload.level security_result.action Se establece en "ALLOW" si 'jsonPayload.level' es "success".
jsonPayload.reason security_result.description Asignado directamente.
jsonPayload.rule security_result.rule_name Asignado directamente.
jsonPayload.user principal.user.userid Asignado directamente.
jsonPayload.vm_location target.asset.location.name Asignado directamente.
jsonPayload.vm_name target.resource.name Asignado directamente.
resource.labels.instance_id target.resource.id Asignado directamente.
resource.labels.project_id target.asset.attribute.cloud.project.id Asignado directamente.
resource.labels.zone target.asset.attribute.cloud.availability_zone Asignado directamente.
timestamp metadata.event_timestamp Se asigna directamente después de convertir al formato ISO8601.
extensions.auth.type Se establece en "SSO" si "jsonPayload.description" contiene "SAML"; de lo contrario, se establece en "AUTHTYPE_UNSPECIFIED" si "jsonPayload.action" es "login" o "Login".
metadata.log_type Establece en "AQUA_SECURITY".
metadata.product_name Establece en "AQUA_SECURITY".
metadata.vendor_name Establece en "AQUA_SECURITY".
target.asset.attribute.cloud.environment Establécelo en "GOOGLE_CLOUD_PLATFORM".
target.resource.type Se establece en "VIRTUAL_MACHINE".

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.