Configura un webhook de SIEM

Compatible con:

Antes de comenzar

Usa los ejemplos de la línea de comandos

En este documento, se incluyen ejemplos de comandos de curl para ayudarte a configurar y probar tu feed de webhook. En estos ejemplos, se usan variables de marcador de posición editables. Para usarlas de forma eficaz, haz lo siguiente:

  1. Edita las variables: A medida que sigas los pasos de configuración, obtendrás valores para el extremo del webhook, una clave de API y un secreto. Haz clic en las variables de marcador de posición del código de muestra y reemplázalas por tus valores reales:

    Si editas una variable en una muestra de código, se actualizará en todos los ejemplos de esta página.

  2. Copiar el comando: Haz clic en el ícono Copiar la muestra de código en el bloque de código.

  3. Ejecuta el comando: Pega el comando copiado en el entorno de la terminal y ejecútalo.

    Asegúrate de que el comando curl incluya la marca --fail (o -f). Esto garantiza que curl devuelva un código de salida distinto de cero si la solicitud HTTP falla y un código de salida de 0 para indicar que se realizó correctamente. Esto es necesario para el siguiente paso.

  4. Verifica que se haya completado correctamente: Un comando curl exitoso no devuelve ningún resultado. Para confirmar que se realizó correctamente, haz lo siguiente:

    Si el comando curl incluyó la marca --fail (o -f), verifica el código de salida ejecutando el siguiente comando inmediatamente después:

    echo $?
    

    Un código de salida de 0 indica que la operación se realizó correctamente.

Configura un feed de webhook HTTPS

Para configurar un feed de webhook HTTPS, haz lo siguiente:

  1. Crea un feed de webhook HTTPS y copia la URL del extremo y la clave secreta.
  2. Crea una clave de API para usarla con la URL del extremo. También puedes reutilizar tu clave de API existente para autenticarte en Google SecOps.
  3. Especifica la URL del extremo en tu aplicación.

Envía varios eventos en una sola solicitud de webhook

En la siguiente muestra de código, se indica cómo dar formato a un solo cuerpo de la solicitud con varios objetos JSON separados por saltos de línea:

curl --location 'ENDPOINT_URL' \
  --header 'Content-Type: application/json' \
  --header 'X-goog-api-key: API_KEY' \
  --header 'X-Webhook-Access-Key: SECRET' \
  --data $'{"principal": {"asset_id": "asset 123"}, "metadata": {"event_type": "GENERIC_EVENT", "product_name": "Product Acme"}}\n{"principal": {"asset_id": "asset 123"}, "metadata": {"event_type": "GENERIC_EVENT", "product_name": "Product Acme"}}' \
  --fail

Crea un feed de webhook HTTPS

  1. En el menú de Google SecOps, selecciona 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 el campo Nombre del feed, ingresa un nombre para el feed.
  4. En la lista Tipo de fuente, selecciona Webhook.
  5. Selecciona el Tipo de registro. Por ejemplo, para crear un feed para Open Cybersecurity Schema Framework, selecciona Open Cybersecurity Schema Framework (OCSF) como el Tipo de registro.
  6. Haz clic en Siguiente.
  7. 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 aplicará a los eventos de este feed.
  8. Haz clic en Siguiente.
  9. Revisa la configuración de tu feed de noticias nuevo en la pantalla Finalizar y, luego, haz clic en Enviar.
  10. Haz clic en Generar clave secreta para generar una clave secreta que autentique este feed.
  11. Copia y almacena la clave secreta, ya que no podrás volver a verla. Puedes generar una clave secreta nueva, pero, si lo haces, la clave secreta anterior quedará obsoleta.
  12. 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.
  13. Opcional: Haz clic en el botón de activación Feed habilitado para inhabilitar el feed. El feed está habilitado de forma predeterminada.
  14. Haz clic en Listo.

Crea una clave de API para el feed de webhook

  1. Ve a la página Credenciales de la consola de Google Cloud .
  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 el extremo HTTPS disponible en el feed de webhook.
  2. Habilita la autenticación especificando la clave de API y la clave secreta como encabezados personalizados en el siguiente formato:

    X-goog-api-key: API_KEY
    X-Webhook-Access-Key: SECRET
    
    • Te recomendamos que especifiques la clave de API como un encabezado en lugar de especificarla en la URL.

      curl --location 'ENDPOINT_URL' \
          --header 'Content-Type: application/json' \
          --header 'X-goog-api-key: API_KEY' \
          --header 'X-Webhook-Access-Key: SECRET' \
          --data '{"principal": {"asset_id": "asset 123"}, "metadata": {"event_type": "GENERIC_EVENT", "product_name": "Product Acme"}}' \
          --fail
      
    • 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
      

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