将 Google Cloud 数据注入 Chronicle

本页面介绍如何启用和停用将 Google Cloud 数据注入 Chronicle 的功能。借助 Chronicle，您可以存储、搜索和检查企业的汇总安全信息，这些信息可追溯至数月或更长时间，具体取决于您的数据保留期限。

概览

您可以通过以下两种方式将 Google Cloud 数据发送到 Chronicle。根据日志类型选择合适的选项。

方法 1：直接提取

您可以在 Google Cloud 中配置特殊的 Cloud Logging 过滤条件，以将特定类型的日志实时发送到 Chronicle。这些日志由 Google Cloud 服务生成。

即使在 Google Cloud 中的项目级别排除这些日志，Chronicle 也会收到这些日志，但日志导出过滤条件和组织级别的 Google Cloud 日志记录都包含这些日志。如需排除 Chronicle 中的日志，您必须在 Google Cloud 中更新 Chronicle 日志导出过滤条件。

可用的日志类型包括：

• Cloud Audit Logs
• Cloud NAT
• Cloud DNS
• Cloud 新一代防火墙
• Cloud Intrusion Detection System
• Cloud Load Balancing
• Cloud SQL
• Windows 事件日志
• Linux 系统日志
• Linux 系统
• 泽克
• Google Kubernetes Engine
• 审核守护程序 (auditd)
• Apigee
• reCAPTCHA Enterprise
• Cloud Run 日志 (GCP_RUN)
• Cloud 新一代防火墙

如需收集 Compute Engine 或 Google Kubernetes Engine (GKE) 应用日志（例如 Apache、Nginx 或 IIS），请使用方案 2。此外，请向 Chronicle 提交支持服务工单，提供反馈，以便我们将来考虑通过选项 1 将支持作为日志类型。

如需了解特定的日志过滤条件和更多提取详情，请参阅将 Google Cloud 日志导出到 Chronicle。

用于扩充内容上下文的其他 Google Cloud 元数据也可以发送到 Chronicle。如需了解详情，请参阅将 Google Cloud Asset 元数据导出到 Chronicle。

注意 ：目前，直接注入方法不支持“命名空间”或“标签”分配。

方案 2：Google Cloud Storage

Cloud Logging 可以将日志路由到 Cloud Storage，以供 Chronicle 按计划提取。

注意 ：此选项会产生您的 Google Cloud 实例因使用 Cloud Storage 而产生的额外费用。

如需详细了解如何为 Chronicle 配置 Cloud Storage，请参阅 Feed 管理：Cloud Storage。

准备工作

您必须先完成以下步骤，然后才能将 Google Cloud 数据注入 Chronicle 实例：

1. 请与您的 Chronicle 代表联系，获取注入 Google Cloud 数据所需的一次性访问代码。

2. 授予您访问 Chronicle 部分所需的以下 IAM 角色：

   • Chronicle Service Admin (roles/chroniclesm.admin)：用于执行所有活动的 IAM 角色。
   • Chronicle Service Viewer (roles/chroniclesm.viewer)：仅查看注入状态的 IAM 角色。
   • 安全中心管理员编辑者 (roles/securitycenter.adminEditor)：启用 Cloud Asset 元数据提取功能所需的必要条件。

3. 如果您计划启用 Cloud Asset Metadata，则还必须启用 Security Command Center 标准层级或 Security Command Center 高级层级 Google Cloud 服务。如需了解详情，请参阅为组织激活 Security Command Center。

授予 IAM 角色

您可以使用 Google Cloud 控制台或使用 gcloud CLI 授予所需的 IAM 角色。

如需使用 Google Cloud Console 授予 IAM 角色，请完成以下步骤：

1. 登录您要连接的 Google Cloud 组织，然后使用产品 > IAM 和管理 > IAM 导航到 IAM 屏幕。

2. 从 IAM 屏幕中，选择用户，然后点击修改成员。

   注意 ：如果您不在 IAM 的组织视图中，修改成员按钮将处于停用状态，您需要转到组织的 IAM 屏幕。

3. 在“修改权限”屏幕中，点击添加其他角色，然后搜索 Chronicle 以查找 IAM 角色。

4. 分配角色后，点击保存。

如需使用 Google Cloud CLI 授予 IAM 角色，请完成以下步骤：

1. 确保您已登录正确的组织。请运行 gcloud init 命令对此进行验证。

2. 如需使用 gcloud 授予 Chronicle Service Admin IAM 角色，请运行以下命令：

   gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
   --member "user:USER_EMAIL" \
   --role roles/chroniclesm.admin
   

   替换以下内容：

   • ORGANIZATION_ID：数字形式的组织 ID。
   • USER_EMAIL：管理员用户的电子邮件地址。

3. 如需使用 gcloud 授予 Chronicle Service Viewer IAM 角色，请运行以下命令：

   gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
   --member "user:USER_EMAIL" \
   --role roles/chroniclesm.viewer
   

4. 如需使用 gcloud 授予 Security Center Admin Editor 角色，请运行以下命令：

    gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
    --member "user:USER_EMAIL" \
    --role roles/securitycenter.adminEditor`
   

启用 Google Cloud 数据注入

Google Cloud 数据使用 Security Command Center 和 Chronicle 之间的私有内部 API 注入。提取永远不会到达外部网络，也不会使用 IP 地址。使用 Chronicle 为 Security Command Center 提供的一次性代码完成的身份验证后，Google 会直接访问 Google Cloud 日志。

如需启用从 Google Cloud 组织将数据注入 Chronicle 实例的功能，请完成以下步骤：

1. 前往 Google Cloud 控制台的 Chronicle 页面。
   转到 Chronicle 页面
   

2. 在 1-time Chronicle 访问代码字段中输入您的一次性访问代码。

3. 如需同意使用 Chronicle，请选中标有我同意 Chronicle 使用我的 Google Cloud 数据的条款及条件的复选框。

4. 点击连接 Chronicle。

您的 Google Cloud 数据现在将发送到 Chronicle。您可以使用 Chronicle 的分析功能调查任何安全相关问题。以下部分介绍了如何调整要发送到 Chronicle 的 Google Cloud 数据类型

将 Google Cloud 日志导出到 Chronicle

您可以将以下类型的 Google Cloud 数据导出到 Chronicle 实例：

注意 ：无论您如何配置导出过滤条件，都只能导出以下 Google Cloud 日志。

• GCP_CLOUDAUDIT：
  • log_id（“cloudaudit.googleapis.com/activity”）（由默认过滤条件导出）
  • log_id（“cloudaudit.googleapis.com/system_event”）（由默认过滤条件导出）
  • log_id("cloudaudit.googleapis.com/policy")
  • log_id("cloudaudit.googleapis.com/access_transparency")
• GCP_CLOUD_NAT：
  • log_id("compute.googleapis.com/nat_flows")
• GCP_DNS：
  • log_id（“dns.googleapis.com/dns_queries”）（由默认过滤条件导出）
• GCP_FIREWALL：
  • log_id("compute.googleapis.com/firewall")
• GCP_IDS：
  • log_id("ids.googleapis.com/threat")
  • log_id("ids.googleapis.com/traffic")
• GCP_LOADBALANCING：
  • log_id("requests")
  • log_id("loadbalancing.googleapis.com/external_regional_requests")
  • log_id("networksecurity.googleapis.com/network_dos_attack_mitigations")
  • log_id("networksecurity.googleapis.com/dos_attack")
  • 这包括来自 Google Cloud Armor 和 Cloud Load Balancing 的日志
• GCP_CLOUDSQL：
  • log_id("cloudsql.googleapis.com/mysql-general.log")
  • log_id("cloudsql.googleapis.com/mysql.err")
  • log_id("cloudsql.googleapis.com/postgres.log")
  • log_id("cloudsql.googleapis.com/sqlagent.out")
  • log_id("cloudsql.googleapis.com/sqlserver.err")
• NIX_SYSTEM：
  • log_id("syslog")
  • log_id("authlog")
  • log_id("securelog")
• LINUX_SYSMON：
  • log_id("sysmon.raw")
• WINEVTLOG：
  • log_id("winevt.raw")
  • log_id("windows_event_log")
• BRO_JSON：
  • log_id("zeek_json_streaming_conn")
  • log_id("zeek_json_streaming_dhcp")
  • log_id("zeek_json_streaming_dns")
  • log_id("zeek_json_streaming_http")
  • log_id("zeek_json_streaming_ssh")
  • log_id("zeek_json_streaming_ssl")
• KUBERNETES_NODE：
  • log_id("events")
  • log_id("stdout")
  • log_id("stderr")
• AUDITD：
  • log_id("audit_log")
• GCP_APIGEE_X：
  • log_id("apigee-logs")
  • logName =~ "^projects/[\w\-]+/logs/apigee\.googleapis\.com[\w\-]*$"
  • 根据需要调整日志过滤条件的正则表达式
• GCP_RECAPTCHA_ENTERPRISE：
  • log_id("recaptchaenterprise.googleapis.com/assessment")
  • log_id("recaptchaenterprise.googleapis.com/annotation")
• GCP_RUN：
  • log_id("run.googleapis.com/stderr")
  • log_id("run.googleapis.com/stdout")
  • log_id("run.googleapis.com/requests")
  • log_id("run.googleapis.com/varlog/system")
• GCP_NGFW_ENTERPRISE：
  • log_id("networksecurity.googleapis.com/firewall_threat")

如需将 Google Cloud 日志导出到 Chronicle，请将 Google Cloud 日志切换开关设为启用。上面列出的所有 Google Cloud 日志类型都将导出到您的 Chronicle 实例。

如需了解使用哪种日志过滤条件的最佳实践，请参阅 Google Cloud 中的安全日志分析。

导出过滤条件设置

默认情况下，您的 Cloud Audit Logs（管理员活动和系统事件）以及 Cloud DNS 日志会发送到您的 Chronicle 帐号。但是，您可以自定义导出过滤条件以包含或排除特定类型的日志。导出过滤条件基于 Google 日志记录查询语言。

如需为日志定义自定义过滤条件，请完成以下步骤：

1. 使用日志记录查询语言为日志创建自定义过滤条件，以定义过滤条件。以下文档介绍了如何定义此类过滤条件：/logging/docs/view/logging-query-language

2. 使用 Export Filter Settings 标签页上提供的链接导航到 Logs Explorer，将新查询复制到 Query 字段，然后点击 Run Query 对其进行测试。

   验证日志浏览器中显示的匹配日志正是您要导出到 Chronicle 的日志。

在导出过滤条件设置标签页中完成以下步骤：

1. 过滤器准备就绪后，点击修改图标，并将过滤器粘贴到导出过滤器字段中。

2. 点击保存自定义过滤器。新的自定义过滤条件适用于导出到 Chronicle 帐号的所有新日志。

3. 您可以将导出过滤条件重置为默认版本，只需点击重置为默认值即可。 请务必先保存您的自定义过滤条件的副本。

调整 Cloud Audit Logs 过滤条件

Cloud Audit Data Access 日志可以生成大量日志，但威胁检测价值不高。如果您选择将这些日志发送到 Chronicle，则应过滤掉日常活动生成的日志。

以下导出过滤条件可捕获数据访问日志，并排除大量事件，例如 Cloud Storage 和 Cloud SQL 的“读取”和“列出”操作：

  ( `log_id("cloudaudit.googleapis.com/data_access")`
  AND NOT protoPayload.methodName =~ "^storage\.(buckets|objects)\.(get|list)$"
  AND NOT protoPayload.request.cmd = "select" )

如需详细了解如何调整 Cloud Audit 数据访问日志，请点击此处。

导出过滤条件示例

以下导出过滤条件示例说明了如何包含或排除特定类型的日志，使其不导出到 Chronicle 帐号。

注意 ：无论您如何配置导出过滤条件，都只能导出此处列出的 Google Cloud 日志。

导出过滤条件示例 1：包含其他日志类型

除了默认日志之外，以下导出过滤条件还会导出 Access Transparency 日志：

log_id("dns.googleapis.com/dns_queries") OR
log_id("cloudaudit.googleapis.com/activity") OR
log_id("cloudaudit.googleapis.com/system_event") OR
log_id("cloudaudit.googleapis.com/access_transparency")

导出过滤条件示例 2：包含特定项目中的其他日志

除了默认日志之外，以下导出过滤条件还可以导出特定项目的 Access Transparency 日志：

log_id("dns.googleapis.com/dns_queries") OR
log_id("cloudaudit.googleapis.com/activity") OR
log_id("cloudaudit.googleapis.com/system_event") OR
logName = "projects/my-project-id/logs/cloudaudit.googleapis.com%2Faccess_transparency"

导出过滤条件示例 3：包含特定文件夹中的其他日志

除了默认日志之外，以下导出过滤条件还可以导出特定文件夹中的 Access Transparency 日志：

log_id("dns.googleapis.com/dns_queries") OR
log_id("cloudaudit.googleapis.com/activity") OR
log_id("cloudaudit.googleapis.com/system_event") OR
logName = "folders/my-folder-id/logs/cloudaudit.googleapis.com%2Faccess_transparency"

导出过滤条件示例 4：排除特定项目中的日志

以下导出过滤条件会导出整个 Google Cloud 组织（特定项目除外）中的默认日志：

(log_id("dns.googleapis.com/dns_queries") OR
log_id("cloudaudit.googleapis.com/activity") OR
log_id("cloudaudit.googleapis.com/system_event")) AND
(NOT logName =~ "^projects/my-project-id/logs/.*$")

将 Google Cloud 资产元数据导出到 Chronicle

您可以将 Google Cloud Asset 元数据导出到 Chronicle。此资产元数据提取自您的 Google Cloud Asset Inventory，包含有关您的资产、资源和身份的信息，其中包括：

• 环境
• 位置
• 可用区
• 硬件型号
• 资源和身份之间的访问权限控制关系

以下是将导出到 Chronicle 帐号的特定类型的 Google Cloud Asset 元数据：

• GCP_BIGQUERY_CONTEXT
• GCP_CLOUD_FUNCTIONS_CONTEXT
• GCP_COMPUTE_CONTEXT
• GCP_IAM_CONTEXT
• GCP_IAM_ANALYSIS
• GCP_KUBERNETES_CONTEXT
• GCP_NETWORK_CONNECTIVITY_CONTEXT
• GCP_RESOURCE_MANAGER_CONTEXT
• GCP_SQL_CONTEXT
• GCP_STORAGE_CONTEXT

以下是 Google Cloud 资产元数据的一些示例：

• 应用名称—Google-iamSample/0.1
• 项目名称—projects/my-project

Resource Manager 上下文日志字段的示例包括 assetType、resource.data.name 和 resource.version。

如需详细了解资源类型，请参阅 Cloud Asset Inventory 支持的资源类型。

注意 ：您必须启用 Security Command Center 标准层级或 Security Command Center 高级层级，才能将 Google Cloud Asset 元数据导出到 Chronicle。

如需将 Google Cloud Asset 元数据导出到 Chronicle，请将 Cloud Asset Metadata 切换开关设置为“已启用”。

字段映射引用和支持的资源类型

下表列出了 Chronicle 支持的上下文解析器、相应的提取标签和支持的资源类型。

如需查看上下文解析器的映射参考文档，请点击表格中相应的上下文解析器名称。

服务名称	提取标签	支持的资源类型
BigQuery	GCP_BIGQUERY_CONTEXT	bigquery.googleapis.com/Dataset bigquery.googleapis.com/Model bigquery.googleapis.com/Table
Resource Manager	GCP_RESOURCE_MANAGER_CONTEXT	cloudresourcemanager.googleapis.com/Folder cloudresourcemanager.googleapis.com/Organization cloudresourcemanager.googleapis.com/Project cloudresourcemanager.googleapis.com/TagBinding cloudresourcemanager.googleapis.com/TagKey cloudresourcemanager.googleapis.com/TagValue
Cloud SQL	GCP_SQL_CONTEXT	sqladmin.googleapis.com/BackupRun sqladmin.googleapis.com/Instance
Cloud Functions	GCP_CLOUD_FUNCTIONS_CONTEXT	cloudfunctions.googleapis.com/CloudFunction cloudfunctions.googleapis.com/Function
Identity and Access Management	GCP_IAM_CONTEXT	iam.googleapis.com/ServiceAccount iam.googleapis.com/Role iam.googleapis.com/ServiceAccountKey
Network Connectivity Center	GCP_NETWORK_CONNECTIVITY_CONTEXT	networkconnectivity.googleapis.com/Hub networkconnectivity.googleapis.com/PolicyBasedRoutes networkconnectivity.googleapis.com/Spoke
Google Kubernetes Engine	GCP_KUBERNETES_CONTEXT	apps.k8s.io/Deployment apps.k8s.io/ReplicaSet batch.k8s.io/Job container.googleapis.com/Cluster container.googleapis.com/NodePool extensions.k8s.io/Ingress k8s.io/Namespace k8s.io/Node k8s.io/Pod k8s.io/Service networking.k8s.io/Ingress networking.k8s.io/NetworkPolicy rbac.authorization.k8s.io/ClusterRole rbac.authorization.k8s.io/ClusterRoleBinding rbac.authorization.k8s.io/Role rbac.authorization.k8s.io/RoleBinding
Compute Engine	GCP_COMPUTE_CONTEXT	compute.googleapis.com/Autoscaler compute.googleapis.com/Address compute.googleapis.com/BackendBucket compute.googleapis.com/BackendService compute.googleapis.com/Commitment compute.googleapis.com/Disk compute.googleapis.com/ExternalVpnGateway compute.googleapis.com/Firewall compute.googleapis.com/FirewallPolicy compute.googleapis.com/ForwardingRule compute.googleapis.com/GlobalAddress compute.googleapis.com/GlobalForwardingRule compute.googleapis.com/HealthCheck compute.googleapis.com/HttpHealthCheck compute.googleapis.com/HttpsHealthCheck compute.googleapis.com/Image compute.googleapis.com/Instance compute.googleapis.com/InstanceGroup compute.googleapis.com/InstanceGroupManager compute.googleapis.com/InstanceTemplate compute.googleapis.com/Interconnect compute.googleapis.com/InterconnectAttachment compute.googleapis.com/License compute.googleapis.com/MachineImage compute.googleapis.com/Network compute.googleapis.com/NetworkEndpointGroup compute.googleapis.com/NodeGroup compute.googleapis.com/NodeTemplate compute.googleapis.com/PacketMirroring compute.googleapis.com/Project compute.googleapis.com/PublicDelegatedPrefix compute.googleapis.com/RegionBackendService compute.googleapis.com/RegionDisk compute.googleapis.com/Reservation compute.googleapis.com/ResourcePolicy compute.googleapis.com/Route compute.googleapis.com/Router compute.googleapis.com/SecurityPolicy compute.googleapis.com/Snapshot compute.googleapis.com/SslCertificate compute.googleapis.com/SslPolicy compute.googleapis.com/Subnetwork compute.googleapis.com/ServiceAttachment compute.googleapis.com/TargetHttpProxy compute.googleapis.com/TargetHttpsProxy compute.googleapis.com/TargetInstance compute.googleapis.com/TargetPool compute.googleapis.com/TargetTcpProxy compute.googleapis.com/TargetSslProxy compute.googleapis.com/TargetVpnGateway compute.googleapis.com/UrlMap compute.googleapis.com/VpnGateway compute.googleapis.com/VpnTunnel

将 Security Command Center 发现结果导出到 Chronicle

您可以将 Security Command Center 高级事件威胁检测 (ETD) 发现结果和所有其他发现结果导出到 Chronicle。

如需详细了解 Event Threat Detection 发现，请参阅 Security Command Center 概览。

注意 ：您必须启用 Security Command Center 专业版层级，才能将高级层级发现结果导出到 Chronicle。

如需将 Security Command Center 高级方案发现结果导出到 Chronicle，请将 Security Command Center 高级方案发现结果切换开关设置为启用。

将 Sensitive Data Protection 数据导出到 Chronicle

如需注入敏感数据保护资产元数据 (DLP_CONTEXT)，请执行以下操作：

1. 完成本文档中的上一部分，以启用 Google Cloud 数据注入。
2. 配置敏感数据保护以分析数据。
3. 配置扫描配置以将数据分析文件发布到 Chronicle。

如需详细了解如何为 BigQuery 数据创建数据分析文件，请参阅敏感数据保护文档。

停用 Google Cloud 数据注入

注意 ：完成这些步骤后，您需要从 Chronicle 代表处获取新的一次性访问代码，并再次完成启用 Google Cloud 数据注入流程，以重启 Google Cloud 日志提取。

1. 勾选标有我想要断开 Chronicle 连接并停止将 Google Cloud 日志发送到 Chronicle 的复选框。

2. 点击断开 Chronicle 连接。

   

问题排查

• 如果您的 Chronicle 系统中缺少资源与身份之间的关系，请将将 Cloud 日志导出到 Chronicle 切换开关设置为停用，然后再次启用。
• 资产元数据会定期提取到 Chronicle 中。更改要过几个小时才会显示在 Chronicle 界面和 API 中。

后续步骤

• 使用 Chronicle 代表提供的客户专用网址打开您的 Chronicle 帐号。
• 详细了解 Chronicle。