Identity-Aware Proxy 稽核記錄

本文說明 Identity-Aware Proxy 的稽核記錄。 Google Cloud 服務會產生稽核記錄，記錄 Google Cloud 資源中的管理和存取活動。如要進一步瞭解 Cloud 稽核記錄，請參閱以下資源：

附註

「欄位」部分會說明稽核記錄中部分欄位的詳細資訊。

服務名稱

Identity-Aware Proxy 稽核記錄會使用服務名稱 iap.googleapis.com。這項服務的篩選器：

    protoPayload.serviceName="iap.googleapis.com"

依權限類型劃分的方法

每個 IAM 權限都有一個 type 屬性，其值是枚舉，可為四個值之一：ADMIN_READ、ADMIN_WRITE、DATA_READ 或 DATA_WRITE。當您呼叫方法時，Identity-Aware Proxy 會產生稽核記錄，其類別取決於執行方法所需權限的 type 屬性。需要 DATA_READ、DATA_WRITE 或 ADMIN_READ 的 type 屬性值的 IAM 權限的程式會產生資料存取稽核記錄。需要 IAM 權限，且 type 屬性值為 ADMIN_WRITE 的方法會產生管理員活動稽核記錄。

權限類型 方法
ADMIN_READ google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy
google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings
google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy
ADMIN_WRITE google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy
google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy
DATA_READ google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup
google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups
DATA_WRITE google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup
google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup
google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings
google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup
google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression

API 介面稽核記錄

如要瞭解每種方法的權限評估方式和權限，請參閱 Identity-Aware Proxy 的 Identity and Access Management 說明文件。

google.cloud.iap.v1.IdentityAwareProxyAdminService

下列稽核記錄與屬於 google.cloud.iap.v1.IdentityAwareProxyAdminService 的方法相關聯。

CreateTunnelDestGroup

  • 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup
  • 稽核記錄類型：資料存取
  • 權限：
    • iap.tunnelDestGroups.create - DATA_WRITE
  • 方法是長時間執行或串流作業：否。
  • 適用於此方法的篩選器： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup"

DeleteTunnelDestGroup

  • 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup
  • 稽核記錄類型：資料存取
  • 權限：
    • iap.tunnelDestGroups.delete - DATA_WRITE
  • 方法是長時間執行或串流作業：否。
  • 適用於此方法的篩選器： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup"

GetIamPolicy

  • 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy
  • 稽核記錄類型：資料存取
  • 權限：
    • iap.web.getIamPolicy - ADMIN_READ
    • iap.webServiceVersions.getIamPolicy - ADMIN_READ
    • iap.webServices.getIamPolicy - ADMIN_READ
    • iap.webTypes.getIamPolicy - ADMIN_READ
  • 方法是長時間執行或串流作業：否。
  • 適用於此方法的篩選器： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy"

GetIapSettings

  • 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings
  • 稽核記錄類型：資料存取
  • 權限：
    • iap.projects.getSettings - ADMIN_READ
    • iap.web.getSettings - ADMIN_READ
    • iap.webServiceVersions.getSettings - ADMIN_READ
    • iap.webServices.getSettings - ADMIN_READ
    • iap.webTypes.getSettings - ADMIN_READ
  • 方法是長時間執行或串流作業：否。
  • 適用於此方法的篩選器： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings"

GetTunnelDestGroup

  • 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup
  • 稽核記錄類型：資料存取
  • 權限：
    • iap.tunnelDestGroups.get - DATA_READ
  • 方法是長時間執行或串流作業：否。
  • 適用於此方法的篩選器： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup"

ListTunnelDestGroups

  • 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups
  • 稽核記錄類型：資料存取
  • 權限：
    • iap.tunnelDestGroups.list - DATA_READ
  • 方法是長時間執行或串流作業：否。
  • 適用於此方法的篩選器： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups"

SetIamPolicy

  • 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy
  • 稽核記錄類型：管理員活動
  • 權限：
    • iap.web.setIamPolicy - ADMIN_WRITE
    • iap.webServiceVersions.setIamPolicy - ADMIN_WRITE
    • iap.webServices.setIamPolicy - ADMIN_WRITE
    • iap.webTypes.setIamPolicy - ADMIN_WRITE
  • 方法是長時間執行或串流作業：否。
  • 適用於此方法的篩選器： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy"

UpdateIapSettings

  • 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings
  • 稽核記錄類型：資料存取
  • 權限：
    • iap.projects.updateSettings - DATA_WRITE
    • iap.web.updateSettings - DATA_WRITE
    • iap.webServiceVersions.updateSettings - DATA_WRITE
    • iap.webServices.updateSettings - DATA_WRITE
    • iap.webTypes.updateSettings - DATA_WRITE
  • 方法是長時間執行或串流作業：否。
  • 適用於此方法的篩選器： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings"

UpdateTunnelDestGroup

  • 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup
  • 稽核記錄類型：資料存取
  • 權限：
    • iap.tunnelDestGroups.update - DATA_WRITE
  • 方法是長時間執行或串流作業：否。
  • 適用於此方法的篩選器： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup"

ValidateIapAttributeExpression

  • 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression
  • 稽核記錄類型：資料存取
  • 權限：
    • iap.projects.updateSettings - DATA_WRITE
    • iap.web.updateSettings - DATA_WRITE
  • 方法是長時間執行或串流作業：否。
  • 適用於此方法的篩選器： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression"

google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1

下列稽核記錄與屬於 google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1 的方法相關聯。

GetIamPolicy

  • 方法：google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy
  • 稽核記錄類型：資料存取
  • 權限：
    • iap.web.getIamPolicy - ADMIN_READ
    • iap.webServiceVersions.getIamPolicy - ADMIN_READ
    • iap.webServices.getIamPolicy - ADMIN_READ
    • iap.webTypes.getIamPolicy - ADMIN_READ
  • 方法是長時間執行或串流作業：否。
  • 適用於此方法的篩選器： protoPayload.methodName="google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy"

SetIamPolicy

  • 方法：google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy
  • 稽核記錄類型：管理員活動
  • 權限：
    • iap.webServiceVersions.setIamPolicy - ADMIN_WRITE
    • iap.webServices.setIamPolicy - ADMIN_WRITE
    • iap.webTypes.setIamPolicy - ADMIN_WRITE
  • 方法是長時間執行或串流作業：否。
  • 適用於此方法的篩選器： protoPayload.methodName="google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy"

不會產生稽核記錄的方法

方法可能不會產生稽核記錄，原因如下：

  • 這是一種高用量方法，會產生大量記錄並產生儲存費用。
  • 審查價值偏低。
  • 其他稽核或平台記錄已提供方法涵蓋率。

下列方法不會產生稽核記錄：

  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.CreateBrand
  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.CreateIdentityAwareProxyClient
  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.DeleteIdentityAwareProxyClient
  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.GetBrand
  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.GetIdentityAwareProxyClient
  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.ListBrands
  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.ListIdentityAwareProxyClients
  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.ResetIdentityAwareProxyClientSecret
  • google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.TestIamPermissions

欄位

記錄中只包含使用者符合的存取層級相關資訊。記錄項目中不會列出封鎖未經授權要求的存取層級。如要判斷提出特定資源要求時需要符合哪些條件，請查看該資源的存取層級。

以下是記錄中部分欄位的重要詳細資料：

欄位 值
authenticationInfo 嘗試存取資源做為 principalEmail 的使用者電子郵件。未經認證的要求記錄檔中不會顯示這項資訊。
requestMetadata.callerIp 產生要求的 IP 位址。
requestMetadata.requestAttributes 要求方法與網址。
authorizationInfo.resource 正在存取的資源。
authorizationInfo.granted 表示 IAP 是否允許所要求存取權的布林值。