Recopila registros del proxy web seguro

Compatible con:

En este documento, se explica cómo exportar e ingerir el proxy web seguro en Google Security Operations con Cloud Storage. El analizador extrae campos de los registros JSON y los transforma en el modelo de datos unificado (UDM). Inicializa los campos del UDM, analiza la carga útil de JSON, extrae información de la red, detalles de seguridad y atributos de recursos, y establece el tipo de evento según la presencia de información del principal y del objetivo.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

  • Instancia de Google SecOps.
  • El proxy web seguro está activo y configurado en tu entorno de Google Cloud .
  • Acceso privilegiado a Google Cloud y permisos adecuados para acceder a los registros del proxy web seguro

Cree un bucket de Cloud Storage

  1. Accede a la consola deGoogle Cloud .

  2. Ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  3. Haz clic en Crear.

  4. En la página Crear un bucket, ingresa la información de tu bucket. Después de cada uno de los siguientes pasos, haz clic en Continuar para avanzar al siguiente paso:

    1. En la sección Primeros pasos, haz lo siguiente:

      1. Ingresa un nombre único que cumpla con los requisitos de nombres de bucket, por ejemplo, gcp-swp-logs.

      2. Para habilitar el espacio de nombres jerárquico, haz clic en la flecha de expansión para expandir la sección Optimizar las cargas de trabajo orientadas a archivos y con uso intensivo de datos y, luego, selecciona Habilitar el espacio de nombres jerárquico en este bucket.

      3. Para agregar una etiqueta de bucket, haz clic en la flecha de expansión para expandir la sección Etiquetas.

      4. Haz clic en Agregar etiqueta y especifica una clave y un valor para tu etiqueta.

    2. En la sección Eligir dónde almacenar tus datos, haz lo siguiente:

      1. Selecciona un tipo de ubicación

      2. Usa el menú de tipo de ubicación para seleccionar una Ubicación en la que se almacenarán de forma permanente los datos de objetos de tu bucket.

      3. Para configurar la replicación entre bucket, expande la sección Configura la bucket entre buckets.

    3. En la sección Elige una clase de almacenamiento para tus datos, selecciona una clase de almacenamiento predeterminada para el bucket o selecciona Autoclass para la administración automática de clases de almacenamiento de los datos de tu bucket.

    4. En la sección Elige cómo controlar el acceso a los objetos, selecciona no para aplicar la prevención del acceso público y selecciona un modelo de control de acceso para los objetos del bucket.

    5. En la sección Elige cómo proteger los datos de objetos, haz lo siguiente:

      1. Selecciona cualquiera de las opciones de Protección de datos que desees configurar para tu bucket.
      2. Para elegir cómo se encriptarán los datos de tus objetos, haz clic en la flecha desplegable etiquetada como Encriptación de datos y selecciona un método de encriptación de datos.

  5. Haz clic en Crear.

Configura la exportación de registros del Proxy web seguro

  1. Accede a la consola deGoogle Cloud .
  2. Ve a Logging > Enrutador de registros.
  3. Haz clic en Crear receptor.

  4. Proporciona los siguientes parámetros de configuración:

    • Nombre del receptor: Ingresa un nombre significativo, por ejemplo, SWP-Export-Sink.
    • Destino del receptor: Selecciona Cloud Storage y, luego, ingresa el URI de tu bucket, por ejemplo, gs://gcp-swp-logs.
    • Filtro de registro:
    logName="projects/<your-project-id>/logs/networkservices.googleapis.com/gateway_requests"

  5. Haz clic en Crear.

Configura los permisos de Cloud Storage

  1. Ve a IAM y administración > IAM.
  2. Busca la cuenta de servicio de Cloud Logging.
  3. Otorga el rol roles/storage.admin en el bucket.

Configura feeds

Existen dos puntos de entrada diferentes para configurar feeds en la plataforma de Google SecOps:

  • Configuración de SIEM > Feeds
  • Centro de contenido > Paquetes de contenido

Configura feeds en Configuración del SIEM > Feeds

Para configurar un feed, sigue estos pasos:

  1. Ve a Configuración del SIEM > Feeds.
  2. Haz clic en Agregar feed nuevo.
  3. En la siguiente página, haz clic en Configurar un solo feed.
  4. En el campo Nombre del feed, ingresa un nombre para el feed, por ejemplo, Google Cloud Registros de SWP.
  5. Selecciona Google Cloud Storage como el Tipo de fuente.
  6. Selecciona Proxy web seguro de GCP como el Tipo de registro.
  7. Haz clic en Obtener cuenta de servicio junto al campo Cuenta de servicio de Chronicle.
  8. Haz clic en Siguiente.

  9. Especifica valores para los siguientes parámetros de entrada:

    • URI del bucket de almacenamiento: Es la URL del bucket de Cloud Storage, por ejemplo, gs://gcp-swp-logs.
    • URI Is A: Selecciona Directory which includes subdirectories.

    • Opciones de borrado de la fuente: Selecciona la opción de borrado según tu preferencia.

  10. Haz clic en Siguiente.

  11. Revisa la nueva configuración del feed en la pantalla Finalizar y, luego, haz clic en Enviar.

Configura feeds desde el Centro de contenido

Especifica valores para los siguientes campos:

  • URI del bucket de almacenamiento: Es la URL del bucket de Cloud Storage, por ejemplo, gs://gcp-swp-logs.
  • URI Is A: Selecciona Directory which includes subdirectories.
  • Opciones de borrado de la fuente: Selecciona la opción de borrado según tu preferencia.

Opciones avanzadas

  • Nombre del feed: Es un valor completado previamente que identifica el feed.
  • Tipo de fuente: Es el método que se usa para recopilar registros en Google SecOps.
  • Espacio de nombres del activo: Es el espacio de nombres asociado con el feed.
  • Etiquetas de transferencia: Son las etiquetas que se aplican a todos los eventos de este feed.

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
httpRequest.latency additional.fields[].key: HTTPRequest Latency
additional.fields[].value.string_value: 0.124462s		 Se asigna directamente desde el campo de registro sin procesar.
httpRequest.protocol network.application_protocol: HTTP
network.application_protocol_version: 2		 El protocolo y la versión se extraen del campo httpRequest.protocol con un patrón de grok.
httpRequest.remoteIp target.asset.ip: 1.1.0.1
target.ip: 1.1.0.1		 La dirección IP se extrae del campo httpRequest.remoteIp con un patrón de Grok.
httpRequest.requestMethod network.http.method: GET Se asigna directamente desde el campo de registro sin procesar.
httpRequest.requestSize network.sent_bytes: 144 Se asigna directamente desde el campo de registro sin procesar y se convierte en un número entero.
httpRequest.requestUrl target.url: https://github.com/tempuslabs/tempusutils/info/refs?service=git-upload-pack Se asigna directamente desde el campo de registro sin procesar.
httpRequest.responseSize network.received_bytes: 225 Se asigna directamente desde el campo de registro sin procesar y se convierte en un número entero.
httpRequest.serverIp principal.asset.ip: 1.8.1.4
principal.ip: 1.8.1.4		 La dirección IP se extrae del campo httpRequest.serverIp con un patrón de Grok.
httpRequest.status network.http.response_code: 401 Se asigna directamente desde el campo de registro sin procesar y se convierte en un número entero.
httpRequest.userAgent network.http.user_agent: git/2.34.1
network.http.parsed_user_agent: {
family: USER_DEFINED,
device: git,
device_version: 2.34.1
}		 Se asigna directamente desde el campo de registro sin procesar. El campo parsed_user_agent se deriva del análisis del campo httpRequest.userAgent.
insertId metadata.product_log_id: 1yh8wczer5o8n Se asigna directamente desde el campo de registro sin procesar.
jsonPayload.@type additional.fields[].key: Log Type
additional.fields[].value.string_value: type.googleapis.com/google.cloud.loadbalancing.type.LoadBalancerLogEntry		 Se asigna directamente desde el campo de registro sin procesar.
jsonPayload.enforcedGatewaySecurityPolicy.hostname target.asset.hostname: github.com
target.hostname: github.com		 Se asigna directamente desde el campo de registro sin procesar.
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules[].action security_result.action: ALLOW
security_result.action_details: ALLOWED		 El valor de security_result.action se deriva en función del valor de jsonPayload.enforcedGatewaySecurityPolicy.matchedRules[].action. Si la acción es ALLOWED, el campo del UDM se establece en ALLOW. Si la acción es DENIED, el campo del UDM se establece en BLOCK.
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules[].name security_result.rule_name: projects/671807354785/locations/us-central1/gatewaySecurityPolicies/github-access-gateway-security-policy-5cec30cd/rules/github-access-gateway-security-policy-rule-5cec30cd Se asigna directamente desde el campo de registro sin procesar.
jsonPayload.enforcedGatewaySecurityPolicy.requestWasTlsIntercepted security_result.detection_fields[].key: requestWasTlsIntercepted
security_result.detection_fields[].value: true		 Se asigna directamente desde el campo de registro sin procesar.
logName additional.fields[].key: Log Name
additional.fields[].value.string_value: projects/rws-w6uza3pn5jzzh6z3hc3d/logs/networkservices.googleapis.com%2Fgateway_requests		 Se asigna directamente desde el campo de registro sin procesar.
receiveTimestamp metadata.collected_timestamp: {
seconds: 1710189647,
nanos: 661101224
}		 Se analizó a partir del campo de registro sin procesar con el formato de fecha RFC 3339.
resource.labels.gateway_name security_result.detection_fields[].key: gateway-name
security_result.detection_fields[].value: github-access-gateway-5cec30cd		 Se asigna directamente desde el campo de registro sin procesar.
resource.labels.gateway_type security_result.detection_fields[].key: gateway-type
security_result.detection_fields[].value: SECURE_WEB_GATEWAY		 Se asigna directamente desde el campo de registro sin procesar.
resource.labels.location target.resource.attribute.cloud.availability_zone: us-central1 Se asigna directamente desde el campo de registro sin procesar.
resource.labels.network_name target.resource.attribute.labels[].key: rc_network_name
target.resource.attribute.labels[].value: projects/rws-w6uza3pn5jzzh6z3hc3d/global/networks/rws-tr-pilot-workspace		 Se asigna directamente desde el campo de registro sin procesar.
resource.type target.resource.attribute.labels[].key: Resource Type
target.resource.attribute.labels[].value: networkservices.googleapis.com/Gateway		 Se asigna directamente desde el campo de registro sin procesar.
severity security_result.severity: MEDIUM Se asigna desde el campo de registro sin procesar. El valor se traduce en un nivel de gravedad del UDM. En este caso, WARNING se asigna a MEDIUM.
timestamp metadata.event_timestamp: {
seconds: 1710189639,
nanos: 952848000
}		 Se analizó a partir del campo de registro sin procesar con el formato de fecha RFC 3339.
(Lógica del analizador) metadata.event_type: NETWORK_HTTP La lógica del analizador determina la presencia de has_principal, has_target y un protocolo que coincida con http.
(Lógica del analizador) metadata.log_type: GCP_SWP Es un valor codificado que se basa en el producto.

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