Recopila registros de contexto de Google Cloud Identity
Versión del analizador: 1.0
En este documento, se explica cómo transferir registros de contexto de Google Cloud Identity a Google Security Operations con Cloud Storage V2.
El contexto de Cloud Identity proporciona información sobre el usuario y el dispositivo para tomar decisiones de acceso adaptado a la identidad, incluida la postura del dispositivo, los atributos del usuario y las membresías de grupos que se usan para enriquecer el contexto de seguridad.
Antes de comenzar
Asegúrate de cumplir con los siguientes requisitos previos:
- Una instancia de Google SecOps
- Un proyecto de Google Cloud con la API de Cloud Storage habilitada
- Permisos para crear y administrar buckets de Cloud Storage
- Permisos para administrar las políticas de Identity and Access Management (IAM) en los buckets de Cloud Storage
- Un entorno de Google Workspace o Cloud Identity con usuarios y dispositivos
- Permisos de IAM para crear receptores de registros en el proyecto de Google Cloud
- Un rol de administrador de Logging (
roles/logging.admin) o permisos equivalentes
Cree un bucket de Cloud Storage
Usa la consola de Google Cloud
- Ve a la consola deGoogle Cloud .
- Selecciona tu proyecto o crea uno nuevo.
- En el menú de navegación, ve a Cloud Storage > Buckets.
- Haz clic en Crear bucket.
Proporciona los siguientes detalles de configuración:
Parámetro de configuración Valor Asigna un nombre a tu bucket Ingresa un nombre único a nivel global (por ejemplo, cloud-identity-context-logs).Tipo de ubicación Elige una en función de tus necesidades (región, birregional o multirregional). Ubicación Selecciona la ubicación (por ejemplo, us-central1).Clase de almacenamiento Estándar (recomendado para los registros a los que se accede con frecuencia) Control de acceso Uniforme (recomendado) Herramientas de protección Opcional: Habilita el control de versiones de objetos o la política de retención Haz clic en Crear.
Usa la herramienta de línea de comandos de gcloud
Como alternativa, crea un bucket con el comando
gcloud:gcloud storage buckets create gs://cloud-identity-context-logs \ --location=us-central1 \ --default-storage-class=STANDARD- Reemplaza
cloud-identity-context-logspor el nombre de tu bucket (único a nivel global). - Reemplaza
us-central1por tu región preferida (p.ej.,us-central1,europe-west1).
- Reemplaza
Exporta los registros de contexto de Cloud Identity a Cloud Storage
Los registros de contexto de Cloud Identity se recopilan en Cloud Logging. Para exportarlos a Cloud Storage, crea un receptor de registros de Logging:
- Ve a la consola deGoogle Cloud .
- Elige tu proyecto.
- Ve a Logging > Enrutador de registros.
- Haz clic en Crear un receptor.
Ingresa los siguientes detalles:
- Nombre del receptor:
cloud-identity-context-sink - Descripción del receptor: Descripción opcional
- Haz clic en Siguiente.
- Nombre del receptor:
En la sección Selecciona el servicio de receptor, haz lo siguiente:
- Elige Bucket de Cloud Storage como el servicio del receptor.
- Selecciona el bucket que creaste antes.
- Haz clic en Siguiente.
En la sección Elige registros para incluirlos en el receptor, usa el siguiente filtro:
resource.type="audited_resource" protoPayload.serviceName="cloudidentity.googleapis.com"Haz clic en Siguiente.
Revisa la configuración del receptor y haz clic en Crear receptor.
Copia la cuenta de servicio que se muestra en el mensaje de confirmación (p.ej.,
service-PROJECT_NUMBER@gcp-sa-logging.iam.gserviceaccount.com).Ve a Cloud Storage > Buckets.
Selecciona tu bucket.
Ve a la pestaña Permisos.
Haz clic en Otorgar acceso.
Pega el correo electrónico de la cuenta de servicio del paso 9.
Asigna el rol Creador de objetos de Storage.
Haz clic en Guardar.
Recupera la cuenta de servicio de Google SecOps
- Ve a Configuración > Administración de datos > Feeds. Si estás en una plataforma solo de SIEM, ve a Configuración > Feeds.
- Haz clic en Agregar feed nuevo.
- Selecciona Google Cloud Storage V2 como el Tipo de fuente.
- Haz clic en Obtener cuenta de servicio.
Se mostrará un correo electrónico único de la cuenta de servicio, por ejemplo:
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.comCopia esta dirección de correo electrónico. la usarás en el próximo paso.
Otorga permisos de IAM a la cuenta de servicio de Google SecOps
Usa la consola de Google Cloud
- Ve a Cloud Storage > Buckets.
- Haz clic en el nombre del bucket.
- Ve a la pestaña Permisos.
- Haz clic en Otorgar acceso.
- Proporciona los siguientes detalles de configuración:
- Agregar entidades: Pega el correo electrónico de la cuenta de servicio de Google SecOps.
- Asigna roles: Selecciona Visualizador de objetos de Storage.
- Haz clic en Guardar.
Usa la herramienta de línea de comandos de gcloud
Usa el siguiente comando:
gcloud storage buckets add-iam-policy-binding gs://cloud-identity-context-logs \ --member="serviceAccount:<SECOPS_SERVICE_ACCOUNT_EMAIL>" \ --role="roles/storage.objectViewer"Reemplaza lo siguiente:
cloud-identity-context-logs: Es el nombre de tu bucket.<SECOPS_SERVICE_ACCOUNT_EMAIL>: Con el correo electrónico de la cuenta de servicio de Google SecOps.
Configura un feed en Google SecOps para transferir registros de contexto de Cloud Identity
- Ve a Configuración > Administración de datos > Feeds. Si estás en una plataforma solo de SIEM, ve a Configuración > Feeds.
- Haz clic en Agregar feed nuevo.
- En la página siguiente, haz clic en Configurar un solo feed.
- En el campo Nombre del feed, ingresa un nombre para el feed (por ejemplo,
Cloud Identity Context Logs). - Selecciona Google Cloud Storage V2 como el Tipo de fuente.
- Selecciona Contexto de Google Cloud Identity como el Tipo de registro.
- Haz clic en Siguiente.
Especifica valores para los siguientes parámetros de entrada:
URI del bucket de almacenamiento: Ingresa el URI del bucket de Cloud Storage:
gs://cloud-identity-context-logs/Opción de eliminación del código fuente: Selecciona la opción de eliminación según tu preferencia:
- No borrar archivos nunca: Nunca borra ningún archivo después de la transferencia.
- Borrar los archivos transferidos y los directorios vacíos: Borra los archivos y los directorios vacíos después de que se transfirieron correctamente.
Antigüedad máxima del archivo (días): Incluye los archivos modificados en la última cantidad de días. El valor predeterminado es 180.
Espacio de nombres del recurso: Es el espacio de nombres del recurso.
Etiquetas de transferencia: Son las etiquetas que se aplican a todos los eventos de este feed.
Haz clic en Siguiente.
Revisa la configuración de tu feed de noticias nuevo en la pantalla Finalizar y, luego, haz clic en Enviar.
Para obtener más información sobre los feeds de Google SecOps, consulta la documentación de feeds de Google SecOps. Para obtener información sobre los requisitos de cada tipo de feed, consulta Configuración de feeds por tipo.
Si tienes problemas para crear feeds, comunícate con el equipo de asistencia de Google SecOps.
Referencia de asignación de campos
El analizador de contexto de Cloud Identity extrae información de identidad de usuarios y dispositivos de Cloud Identity, incluidos los atributos de los usuarios, las direcciones de correo electrónico, las membresías de grupos, las rutas de unidades organizativas y los datos de postura de los dispositivos. Asigna estos campos al modelo de UDM entity con el tipo de entidad USER.
Tabla de asignación de UDM
| Campo de registro | Asignación de UDM | Lógica |
|---|---|---|
product_object_id |
entity.asset.product_object_id |
Asignada directamente |
data.protoPayload.requestMetadata.callerIp |
entity.ip |
Combinado |
authorizationInfodata_granted_label |
entity.labels |
Combinado |
authorizationInfodata_permission_label |
entity.labels |
Combinado |
authorizationInfodata_resource_label |
entity.labels |
Combinado |
data_logname_label |
entity.labels |
Combinado |
field_ |
entity.labels |
Combinado |
referencedTables_datasetId_label |
entity.labels |
Combinado |
referencedTables_projectId_label |
entity.labels |
Combinado |
referencedTables_tableId_label |
entity.labels |
Combinado |
referencedViews_datasetId_label |
entity.labels |
Combinado |
referencedViews_projectId_label |
entity.labels |
Combinado |
referencedViews_tableId_label |
entity.labels |
Combinado |
value |
entity.location.country_or_region |
Asignada directamente |
data.protoPayload.resourceName |
entity.resource.name |
Asignada directamente |
company_name |
entity.user.company_name |
Se cambió el nombre o se asignó |
depart |
entity.user.department |
Combinado |
organisation |
entity.user.department |
Combinado |
alias |
entity.user.email_addresses |
Combinado |
data.protoPayload.authenticationInfo.principalEmail |
entity.user.email_addresses |
Combinado |
email |
entity.user.email_addresses |
Combinado |
emails |
entity.user.email_addresses |
Combinado |
primaryEmail |
entity.user.email_addresses |
Combinado |
employeeId |
entity.user.employee_id |
Asignada directamente |
employee_id |
entity.user.employee_id |
Asignada directamente |
ext.value |
entity.user.employee_id |
Asignada directamente |
first_name |
entity.user.first_name |
Asignada directamente |
givenName |
entity.user.first_name |
Asignada directamente |
name.givenName |
entity.user.first_name |
Asignada directamente |
orgUnitPath |
entity.user.group_identifiers |
Combinado |
familyName |
entity.user.last_name |
Asignada directamente |
last_name |
entity.user.last_name |
Asignada directamente |
name.familyName |
entity.user.last_name |
Asignada directamente |
office_address.country_or_region |
entity.user.office_address.country_or_region |
Asignada directamente |
office_address.state |
entity.user.office_address.state |
Asignada directamente |
number |
entity.user.phone_numbers |
Combinado |
data.insertId |
entity.user.product_object_id |
Asignada directamente |
id |
entity.user.product_object_id |
Asignada directamente |
title |
entity.user.title |
Asignada directamente |
familyName |
entity.user.user_display_name |
Asignada directamente |
givenName |
entity.user.user_display_name |
Asignada directamente |
name.fullName |
entity.user.user_display_name |
Asignada directamente |
user_display_name |
entity.user.user_display_name |
Asignada directamente |
data.insertId |
entity.user.userid |
Asignada directamente |
userid |
entity.user.userid |
Asignada directamente |
windows_sid |
entity.user.windows_sid |
Asignada directamente |
value |
metadata.event_timestamp |
Analizado como ISO8601 |
| N/A | metadata.description |
Constante: From BigQuery |
| N/A | metadata.entity_type |
Constante: USER |
| N/A | metadata.product_entity_id |
Constante: unknown |
| N/A | metadata.product_name |
Constante: Cloud Identity |
| N/A | metadata.vendor_name |
Constante: Google |
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.