Recopila registros de GitLab

Versión del analizador: 9.0

Compatible con:

Este analizador extrae campos de los registros JSON de GitLab, los normaliza en el modelo de datos unificado (UDM) y enriquece los datos con contexto adicional. Controla varios tipos de eventos de GitLab, se enfoca en las acciones de los usuarios, el acceso a los recursos y los resultados de seguridad, y, al mismo tiempo, procesa la información relacionada con la red y las aplicaciones. El analizador también ejecuta lógica basada en roles y acciones dentro de GitLab, categoriza eventos y asigna niveles de gravedad adecuados.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

  • Instancia de Google SecOps.
  • Acceso con privilegios a GitLab

Configura 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 GitLab).
  5. Selecciona Webhook como el Tipo de origen.
  6. Selecciona GitLab 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 de Google 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. 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 Security Operations.
  • SECRET: Es la clave secreta que generaste para autenticar el feed.

Configura un webhook en GitLab para Google SecOps

  1. Abre tu navegador web y ve al proyecto de GitLab para el que quieres configurar el webhook.
  2. En tu proyecto, ve a Configuración > Webhooks.
  3. Haz clic en Agregar webhook nuevo.
  4. En el campo URL, pega la URL del extremo de Google SecOps.
  5. Haz clic en Agregar encabezado personalizado.
  6. Escribe X-Webhook-Access-Key en el campo Nombre del encabezado.
  7. En el campo Valor del encabezado, copia la clave secreta generada durante la configuración del feed de Google SecOps.
  8. Haz clic en Agregar encabezado personalizado.
  9. Escribe X-goog-api-key en el campo Header Name.
  10. En el campo Valor del encabezado, copia la clave de API generada durante la configuración del feed de Google SecOps. Nota: Para mejorar la seguridad, genera un token secreto y agrégalo a la configuración del webhook de GitLab y a la configuración del feed de Google SecOps correspondiente. Esto ayuda a verificar la autenticidad de los webhooks entrantes.
  11. Elige los eventos de GitLab que deberían activar el webhook. Por ejemplo, puedes seleccionar Eventos de envío para enviar datos a Google SecOps cada vez que se envíe código al repositorio. Considera con atención qué eventos son relevantes para tus necesidades de supervisión de seguridad. Demasiados eventos pueden generar una carga innecesaria.
  12. Para comprender mejor el propósito de los webhooks, asígnale un nombre significativo, como Webhook de Google SecOps.
  13. Asegúrate de que la casilla de verificación Habilitar la verificación de SSL esté seleccionada. Esto es fundamental para una comunicación segura.
  14. Haz clic en Agregar webhook para guardar la configuración.

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
author_id principal.user.userid Se convirtió en cadena.
author_name principal.user.email_addresses Si el valor coincide con una regex de dirección de correo electrónico
author_name principal.user.user_display_name Si el valor no coincide con una regex de dirección de correo electrónico
details.as principal.resource.attribute.labels Se agrega como una etiqueta con la clave "as".
details.add principal.resource.attribute.labels Se agregó como una etiqueta con la clave "add".
details.as principal.user.role_name Es el valor del campo de registro sin procesar.
details.as principal.user.attribute.roles.type Se establece en "ADMINISTRATOR" si details.as es "propietario", "SERVICE_ACCOUNT" si details.as es "Developer", "Maintainer" o "Reporter", y "TYPE_UNSPECIFIED" si details.as es "Guest".
details.custom_message security_result.description Es el valor del campo de registro sin procesar.
details.custom_message.action security_result.summary Es el valor del campo de registro sin procesar.
details.entity_path target.file.full_path Es el valor del campo de registro sin procesar.
details.target_id target.resource.id Se convirtió en cadena.
entity_path target.file.full_path Es el valor del campo de registro sin procesar.
entity_type target.resource.attribute.labels Se agrega como una etiqueta con la clave "Entity Type".
event_type metadata.product_event_type Es el valor del campo de registro sin procesar.
insertId metadata.product_log_id Es el valor del campo de registro sin procesar.
ip_address principal.ip, principal.asset.ip Es el valor del campo de registro sin procesar.
jsonPayload.action additional.fields Se agrega como un campo con la clave "action" y un valor de cadena.
jsonPayload.controller additional.fields Se agrega como un campo con la clave "controller" y un valor de cadena.
jsonPayload.correlation_id principal.asset_id Tiene el prefijo "id: ".
jsonPayload.cpu_s additional.fields Se agrega como un campo con la clave "cpu_s" y el valor de cadena.
jsonPayload.details.custom_message.protocol network.application_protocol Se establece en "UNKNOWN_APPLICATION_PROTOCOL" si el valor es "web"; de lo contrario, se convierte en mayúsculas. También se agrega como un campo adicional con la clave "Application Protocol" si el valor es "web".
jsonPayload.mem_total_bytes additional.fields Se agrega como un campo con la clave "mem_total_bytes" y el valor de cadena.
jsonPayload.meta_caller_id additional.fields Se agrega como un campo con la clave "Caller Id" y un valor de cadena.
jsonPayload.meta_client_id target.user.userid Es el valor del campo de registro sin procesar.
jsonPayload.meta_feature_category additional.fields Se agrega como un campo con la clave "Feature Category" y un valor de cadena.
jsonPayload.meta_remote_ip principal.ip, principal.asset.ip Es el valor del campo de registro sin procesar, analizado como un array JSON y combinado en los campos de IP.
jsonPayload.meta_user principal.user.userid Se usa como resguardo si jsonPayload.username está vacío.
jsonPayload.method network.http.method Es el valor del campo de registro sin procesar.
jsonPayload.path target.process.file.full_path Es el valor del campo de registro sin procesar.
jsonPayload.pid target.process.pid Se convirtió en cadena.
jsonPayload.remote_ip principal.ip, principal.asset.ip Es el valor del campo de registro sin procesar.
jsonPayload.request_urgency additional.fields Se agrega como un campo con la clave "Urgencia de la solicitud" y un valor de cadena.
jsonPayload.severity security_result.severity Se establece en "INFORMATIONAL" si el valor es "INFO", "ERROR" si el valor es "ERROR" y "MEDIUM" si el valor es "NOTICE".
jsonPayload.status network.http.response_code Se convierte en un número entero si no es "ACTIVE".
jsonPayload.ua network.http.user_agent Es el valor del campo de registro sin procesar.
jsonPayload.username principal.user.userid Es el valor del campo de registro sin procesar.
jsonPayload.worker_id principal.application Es el valor del campo de registro sin procesar.
labels.instance_name principal.hostname, principal.asset.hostname Es el valor del campo de registro sin procesar, que se usa si el mensaje contiene "Removing user".
logName security_result.category_details Es el valor del campo de registro sin procesar.
message security_result.summary Es el valor del campo de registro sin procesar, que se usa si jsonPayload.severity es "ERROR".
protoPayload.@type additional.fields Se agrega como un campo con la clave "protoPayload type" y el valor de cadena.
protoPayload.authenticationInfo.principalEmail principal.user.email_addresses, principal.user.userid Es el valor del campo de registro sin procesar.
protoPayload.authenticationInfo.principalSubject additional.fields Se agrega como un campo con la clave "authenticationInfo principalSubject" y el valor de cadena.
protoPayload.authenticationInfo.serviceAccountKeyName additional.fields Se agrega como un campo con la clave "authenticationInfo serviceAccountKeyName" y el valor de cadena.
protoPayload.authorizationInfo target.resource.attribute.labels, security_result.action Los valores de este campo se agregan como etiquetas con claves que tienen el prefijo "authenticationInfo". El security_result.action se establece en "ALLOW" si un valor dentro de granted es verdadero y en "BLOCK" si es falso. Los campos anidados, como resourceAttributes, también se agregan como etiquetas con claves que tienen el prefijo "authenticationInfo_resourceAttributes".
protoPayload.methodName additional.fields Se agrega como un campo con la clave "protoPayload methodName" y el valor de cadena.
protoPayload.request.@type additional.fields Se agrega como un campo con la clave "Request Type" y un valor de cadena.
protoPayload.request.resource target.resource.attribute.labels Se agregó como una etiqueta con la clave "Request resource".
protoPayload.requestMetadata.callerIp additional.fields Se agrega como un campo con la clave "requestMetadata callerIp" y un valor de cadena.
protoPayload.requestMetadata.callerSuppliedUserAgent additional.fields Se agrega como un campo con la clave "requestMetadata callerSuppliedUserAgent" y un valor de cadena.
protoPayload.serviceName additional.fields Se agrega como un campo con la clave "serviceName" y un valor de cadena.
protoPayload.status.code additional.fields Se agrega como un campo con la clave "protoPayload status code" y un valor de cadena.
protoPayload.status.message additional.fields, target.user.email_addresses, target.user.userid Se agrega como un campo con la clave "protoPayload status message" y el valor de cadena. Si se puede extraer una dirección de correo electrónico del mensaje, se agrega a target.user.email_addresses y target.user.userid.
receiveTimestamp metadata.event_timestamp, timestamp Se analiza como la marca de tiempo del evento.
resource.labels.project_id target.resource.attribute.labels Se agregó como una etiqueta con la clave "ID del proyecto".
resource.labels.zone target.cloud.availability_zone Es el valor del campo de registro sin procesar.
resource.type target.cloud.environment Establece en "GOOGLE_CLOUD_PLATFORM" si el valor coincide con "gce".
security_result.action security_result.action Derivado de protoPayload.authorizationInfo.granted.
security_result.category_details security_result.category_details Se combinó con logName.
security_result.description security_result.description Derivado de jsonPayload.details.custom_message.
security_result.severity security_result.severity Se deriva de severity o jsonPayload.severity.
security_result.summary security_result.summary Se deriva de jsonPayload.details.custom_message.action o jsonPayload.message.
severity security_result.severity Se establece en "INFORMATIONAL" si el valor es "INFO", "ERROR" si el valor es "ERROR" y "MEDIUM" si el valor es "NOTICE".
sourceLocation principal.resource.attribute.labels Los valores de este campo se agregan como etiquetas.
target_details target.resource.attribute.labels Se agregó como una etiqueta con la clave "Target Details".
target_type target.resource.attribute.labels Se agrega como una etiqueta con la clave "tipo de segmentación".
timestamp timestamp Es el valor del campo de registro sin procesar. Se establece en función de la presencia de los campos principal y de destino. Se establece de forma predeterminada en "GENERIC_EVENT" si no se cumple ninguna condición específica. Los valores posibles son "USER_RESOURCE_UPDATE_CONTENT", "USER_RESOURCE_ACCESS" y "USER_UNCATEGORIZED". Establece el valor en "GITLAB". Establece el valor en "GITLAB".

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.