此页面由 Cloud Translation API 翻译。

收集 Cloud Identity 设备日志

支持的语言：

Google SecOps SIEM

本指南将介绍如何使用 Cloud Storage 将 Cloud Identity 设备日志导出到 Google Security Operations。解析器从 JSON 日志中提取字段，转换 deviceType 和日期等特定字段，并将它们映射到 UDM，从而创建一个表示设备的 asset_entity 并使用硬件和元数据信息对其进行扩充。

准备工作

确保您满足以下前提条件：

您的 Google Cloud 项目中已启用 Google Cloud Identity。
Google SecOps 实例。
对 Google Cloud Identity 和 Cloud Logging 的特权访问权限。

创建 Cloud Storage 存储桶

登录 Google Cloud 控制台。
前往 Cloud Storage 存储分区页面。

进入“存储桶”
点击创建。
在创建存储桶页面上，输入您的存储桶信息。完成以下每一步后，点击继续以继续执行后续步骤：
1. 在开始使用部分中，执行以下操作：
  1. 输入符合存储桶名称要求的唯一名称，例如 gcp-cloudidentity-devices-logs。
  2. 如需启用分层命名空间，请点击展开箭头以展开优化文件导向型和数据密集型工作负载部分，然后选择在此存储桶上启用分层命名空间。
    
    注意：您无法在现有存储桶中启用分层命名空间。
  3. 如需添加存储桶标签，请点击展开箭头以展开标签部分。
  4. 点击添加标签，然后为标签指定键和值。
2. 在选择数据存储位置部分中，执行以下操作：
  1. 选择位置类型。
  2. 使用位置类型菜单选择一个位置，用于永久存储存储桶中的对象数据。
    
    注意：如果您选择双区域位置类型，还可以使用相关复选框选择启用增强型复制。
  3. 如需设置跨存储桶复制，请展开设置跨存储桶复制部分。
3. 在为数据选择一个存储类别部分中，为存储桶选择默认存储类别，或者选择 Autoclass 对存储桶数据进行自动存储类别管理。
4. 在选择如何控制对对象的访问权限部分中，清除强制执行禁止公开访问，然后为存储桶对象选择访问权限控制模型。
  
  注意：如果项目的组织政策已强制执行禁止公开访问，则禁止公开访问此存储桶复选框处于锁定状态。
5. 在选择如何保护对象数据部分中，执行以下操作：
  1. 在数据保护下，选择您要为存储桶设置的任何选项。
  2. 如需选择对象数据的加密方式，请点击标有数据加密的展开箭头，然后选择数据加密方法。
点击创建。

配置 Cloud Identity 设备日志导出

登录 Google Cloud 控制台。
前往日志记录 > 日志路由器。
点击创建接收器。
提供以下配置参数：
- 接收器名称：输入一个有意义的名称，例如 cloud-identity-devices-logs-sink。
- 接收器目标位置：选择 Cloud Storage 存储空间，然后输入存储桶的 URI，例如 gs://gcp-cloudidentity-devices-logs。
- 日志过滤条件：
```
logName="projects/<your-project-id>/logs/cloudaudit.googleapis.com%2Factivity"
resource.type="cloud_identity_device"
```
- 设置导出选项：包含所有日志条目。
点击创建。

配置 Cloud Storage 权限

前往 IAM 和管理> IAM。
找到 Cloud Logging 服务账号。
授予对相应存储桶的 roles/storage.admin。

设置 Feed

您可以通过两种不同的入口点在 Google SecOps 平台中设置 Feed：

SIEM 设置 > Feed
内容中心 > 内容包

通过“SIEM 设置”>“Feed”设置 Feed

如需配置 Feed，请按以下步骤操作：

依次前往 SIEM 设置 > Feed。
点击添加新 Feed。
在下一页上，点击配置单个 Feed。
在 Feed name 字段中，输入 Feed 的名称，例如 GCP Cloud Identity Devices Logs。
选择第三方 API 作为来源类型。
选择 GCP Cloud Identity 设备作为日志类型。
点击下一步。
为以下输入参数指定值：
- OAuth JWT 端点：用于检索 OAuth JSON Web 令牌的端点。
- JWT 声明颁发者：通常是客户端 ID。
- JWT 声明主题：通常是电子邮件地址。
- JWT 声明目标对象：JWT 声明目标对象。
- RSA 私钥：以 PEM 格式输入。
- API 版本：用于提取设备信息的 API 版本。值应为 v1、v1beta1 或 vx 之一。如果未指定版本，则使用 v1。
点击下一步。
在最终确定界面中查看新的 Feed 配置，然后点击提交。

设置来自内容中心的 Feed

为以下字段指定值：

存储分区 URI：Cloud Storage 存储桶网址；例如 gs://gcp-cloudidentity-devices-logs。
URI Is A：选择目录（包括子目录）。
来源删除选项：根据您的偏好设置选择删除选项。

注意：如果您选择 Delete transferred files 或 Delete transferred files and empty directories 选项，请确保您已向服务账号授予适当的权限。

高级选项

Feed 名称：用于标识 Feed 的预填充值。
来源类型：用于将日志收集到 Google SecOps 中的方法。
资源命名空间：与 Feed 关联的命名空间。
提取标签：应用于相应 Feed 中所有事件的标签。

UDM 映射表

日志字段	UDM 映射	逻辑
`createTime`	`entity.metadata.creation_timestamp`	`createTime` 的值会被解析为时间戳并进行映射。
`deviceId`	`entity.entity.asset.asset_id`	直接映射。
`deviceType`	`entity.entity.asset.platform_software.platform`	如果原始值为 `MAC_OS` 或 `IOS`，则映射到 `MAC`。如果原始值匹配，则映射到 `WINDOWS`、`MAC` 或 `LINUX`。否则，请将其设置为 `UNKNOWN_PLATFORM`。
`encryptionState`	`entity.entity.asset.attribute.labels.key`	值设置为 `encryptionState`。用作标签的一部分。
`encryptionState`	`entity.entity.asset.attribute.labels.value`	直接映射。用作标签的一部分。
`lastSyncTime`	`entity.entity.asset.system_last_update_time`	`lastSyncTime` 的值会被解析为时间戳并进行映射。
`managementState`	`entity.entity.asset.attribute.labels.key`	值设置为 `managementState`。用作标签的一部分。
`managementState`	`entity.entity.asset.attribute.labels.value`	直接映射。用作标签的一部分。
`model`	`entity.entity.asset.hardware.model`	直接映射。
`name`	`entity.entity.asset.product_object_id`	提取 `devices/` 之后的部分并进行映射。
`name`	`entity.entity.resource.name`	直接映射。
`osVersion`	`entity.entity.asset.platform_software.platform_version`	直接映射。
`securityPatchTime`	`entity.entity.asset.attribute.labels.key`	值设置为 `securityPatchTime`。用作标签的一部分。
`securityPatchTime`	`entity.entity.asset.attribute.labels.value`	直接映射。用作标签的一部分。
`serialNumber`	`entity.entity.asset.hardware.serial_number`	直接映射。从原始日志中的顶级 `create_time` 字段复制。值设置为 `ASSET`。值设置为 `GCP Cloud Identity Devices`。值设置为 `Google Cloud Platform`。从原始日志中的顶级 `create_time` 字段复制。