重要联系人审核日志记录

借助 Essential Contacts 的 Cloud Audit Logs，您可以跟踪对资源的管理员和数据访问操作，从而帮助您监控访问和配置更改。您可以在 Logs Explorer 中查询这些日志，并查看哪些 Essential Contacts API 方法会生成 Cloud Audit Logs。

如需详细了解 Cloud Audit Logs，请参阅以下文档：

服务名称

如需查看重要联系人审核日志，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 Logs Explorer 页面：

    转到日志浏览器

  2. 将以下查询复制并粘贴到Logs Explorer的查询字段中，然后点击运行查询。

        protoPayload.serviceName="essentialcontacts.googleapis.com"

方法（按权限类型）

每个 IAM 权限都有一个 type 属性，该属性的值是一个枚举，可以是以下四个值之一：ADMIN_READ、ADMIN_WRITE、DATA_READ 或 DATA_WRITE。在您调用某个方法时，Essential Contacts 会生成一个审核日志，其类别取决于执行该方法所需权限的 type 属性。需要 IAM 权限且 type 属性值为 DATA_READ、DATA_WRITE 或 ADMIN_READ 的方法会生成数据访问审核日志。需要 IAM 权限且 type 属性值为 ADMIN_WRITE 的方法会生成管理员活动审核日志。

以下列表中标记为 (LRO) 的 API 方法是长时间运行的操作 (LRO)。 这些方法通常会生成两个审核日志条目：一个在操作开始时生成，另一个在操作结束时生成。如需了解详情，请参阅长时间运行的操作的审核日志。
权限类型 方法
DATA_READ google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContacts
google.cloud.essentialcontacts.v1.EssentialContactsService.GetContact
google.cloud.essentialcontacts.v1.EssentialContactsService.ListContacts
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts
DATA_WRITE google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact
google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact
google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage
google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact

API 接口审核日志

如需了解如何针对每种方法评估权限以及评估哪些权限，请参阅 Essential Contacts 的 Identity and Access Management 文档。

google.cloud.essentialcontacts.v1.EssentialContactsService

以下审核日志与属于 google.cloud.essentialcontacts.v1.EssentialContactsService 的方法相关联。

ComputeContacts

  • 方法：google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContacts
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.get - DATA_READ
    • essentialcontacts.contacts.list - DATA_READ
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContacts"

CreateContact

  • 方法：google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.create - DATA_WRITE
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact"

DeleteContact

  • 方法：google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.delete - DATA_WRITE
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact"

GetContact

  • 方法：google.cloud.essentialcontacts.v1.EssentialContactsService.GetContact
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.get - DATA_READ
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.GetContact"

ListContacts

  • 方法：google.cloud.essentialcontacts.v1.EssentialContactsService.ListContacts
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.list - DATA_READ
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.ListContacts"

SendTestMessage

  • 方法：google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.send - DATA_WRITE
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage"

UpdateContact

  • 方法：google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.update - DATA_WRITE
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact"

google.cloud.essentialcontacts.v1alpha1.EssentialContactsService

以下审核日志与属于 google.cloud.essentialcontacts.v1alpha1.EssentialContactsService 的方法相关联。

ComputeContacts

  • 方法：google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.list - DATA_READ
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts"

CreateContact

  • 方法：google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.create - DATA_WRITE
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact"

DeleteContact

  • 方法：google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.delete - DATA_WRITE
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact"

GetContact

  • 方法：google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.get - DATA_READ
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact"

ListContacts

  • 方法：google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.list - DATA_READ
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts"

SendTestMessage

  • 方法：google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.send - DATA_WRITE
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage"

UpdateContact

  • 方法：google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.update - DATA_WRITE
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact"

google.cloud.essentialcontacts.v1beta1.EssentialContactsService

以下审核日志与属于 google.cloud.essentialcontacts.v1beta1.EssentialContactsService 的方法相关联。

ComputeContacts

  • 方法：google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.get - DATA_READ
    • essentialcontacts.contacts.list - DATA_READ
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts"

CreateContact

  • 方法：google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.create - DATA_WRITE
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact"

DeleteContact

  • 方法：google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.delete - DATA_WRITE
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact"

GetContact

  • 方法：google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.get - DATA_READ
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact"

ListContacts

  • 方法：google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.list - DATA_READ
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts"

SendTestMessage

  • 方法：google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.send - DATA_WRITE
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage"

UpdateContact

  • 方法：google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact
  • 审核日志类型：数据访问
  • 权限：
    • essentialcontacts.contacts.update - DATA_WRITE
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact"

不会生成审核日志的方法

由于以下一个或多个原因，方法可能不会生成审核日志：

  • 这是一种会产生大量日志的方法，日志生成和存储的费用高昂。
  • 它的审核价值较低。
  • 其他审核或平台日志已提供方法覆盖功能。

以下方法不会生成审核日志：

  • google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ResendVerification
  • google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.VerifyContact

针对写入操作的管理员活动审计日志

除了数据访问审计日志 (DATA_WRITE) 之外，以下 google.cloud.essentialcontacts.v1.EssentialContactsService 写入方法还会生成管理员活动审计日志 (ADMIN_WRITE)：

  • google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact
  • google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact
  • google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact
  • google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage

管理员活动审计日志默认处于启用状态，不会产生 Cloud Logging 注入费用。

如果您还为 Essential Contacts 启用了数据访问审计日志 (DATA_WRITE)，则调用这四个方法会同时生成管理员活动审核日志条目 (cloudaudit.googleapis.com/activity) 和数据访问审核日志条目 (cloudaudit.googleapis.com/data_access)。如果您将审计日志路由到导出接收器或配置基于日志的提醒，请按日志名称过滤或同时考虑这两个日志条目，以避免重复提醒或意外导出量。

查询示例

您可以在 Logs Explorer 中运行以下示例查询，以查看 Essential Contacts 写操作的管理活动审计日志：

查询说明 表达式
重要联系人写操作的管理员活动审计日志 
log_id("cloudaudit.googleapis.com/activity")
protoPayload.serviceName="essentialcontacts.googleapis.com"