Recoger registros de Atlassian Bitbucket

Información general

Este analizador extrae campos de los registros JSON de Atlassian Bitbucket y los asigna al UDM. Gestiona varios formatos de registro y rellena las entidades principales o de destino en función de los campos disponibles, como las direcciones IP, los IDs de usuario y la información de los recursos. También clasifica los eventos en función de la actividad de la red y de los usuarios, y enriquece los datos con resultados de seguridad, si los hay. El analizador da prioridad a agentRealtimeInfo sobre agentDetectionInfo al rellenar los campos.

Antes de empezar

Asegúrate de que cumples los siguientes requisitos previos:

• Instancia de Google SecOps.
• Acceso privilegiado a un repositorio.

Configurar feeds

Para configurar un feed, sigue estos pasos:

1. Ve a Configuración de SIEM > Feeds.
2. Haz clic en Añadir feed.
3. En la página siguiente, haga clic en Configurar un solo feed.
4. En el campo Nombre del feed, introduzca un nombre para el feed (por ejemplo, Registros de Atlassian Bitbucket).
5. Selecciona Webhook como Tipo de fuente.
6. Seleccione Atlassian Bitbucket como Tipo de registro.
7. Haz clic en Siguiente.
8. Opcional: especifica los valores de los siguientes parámetros de entrada:
   • Delimitador de división: el delimitador que se usa para separar las líneas de registro, como \n.
   • Espacio de nombres de recursos: el espacio de nombres de recursos.
   • Etiquetas de ingestión: la etiqueta aplicada a los eventos de este feed.
9. Haz clic en Siguiente.
10. Revise la configuración del feed en la pantalla Finalizar y, a continuación, haga clic en Enviar.
11. Haz clic en Generar clave secreta para generar una clave secreta que autentique este feed.
12. Copia y guarda la clave secreta. No podrás volver a ver esta clave secreta. Si es necesario, puedes volver a generar una clave secreta, pero esta acción hará que la clave secreta anterior quede obsoleta.
13. En la pestaña Detalles, copie la URL del endpoint del feed del campo Información del endpoint. Debes especificar esta URL de endpoint en tu aplicación cliente.
14. Haz clic en Listo.

Crear una clave de API para la feed de webhook

1. Ve a la Google Cloud consola > Credenciales.

   Ir a Credenciales

2. Haz clic en Crear credenciales y, a continuación, selecciona Clave de API.

3. Restringe el acceso de la clave de API a la API Google Security Operations.

Especificar la URL del endpoint

1. En tu aplicación cliente, especifica la URL del endpoint HTTPS proporcionada 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 con el siguiente formato:

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

   Recomendación: Especifica la clave de API como encabezado en lugar de hacerlo en la URL. Si tu cliente de webhook no admite encabezados personalizados, puedes especificar la clave de API y la clave secreta mediante parámetros de consulta con el siguiente formato:

   ENDPOINT_URL?key=API_KEY&secret=SECRET
   

Haz los cambios siguientes:

• ENDPOINT_URL: URL del endpoint del feed.
• API_KEY: la clave de API para autenticarte en Google Security Operations.
• SECRET: la clave secreta que has generado para autenticar el feed.

Crear un webhook en Atlassian Bitbucket

1. En Bitbucket, ve a los ajustes del repositorio.
2. En Flujo de trabajo, haz clic en Webhooks.
3. Haz clic en Añadir webhook.
4. Configure los siguientes campos:
   • Título: proporciona un nombre descriptivo (por ejemplo, Google SecOps).
   • URL: introduce la URL del endpoint de la API de Google SecOps.
   • Estado: Activo.
   • Activadores: selecciona los eventos pertinentes.
5. Haz clic en Guardar.

Tabla de asignación de UDM

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.