Identity-Aware Proxy 稽核記錄

重要事項：

2024 年 2 月 14 日，Cloud 稽核記錄 (CAL) 類型不慎從「DATA_ACCESS」變更為「ADMIN_ACTIVITY」。這項變更會導致 UpdateIapSettings 和 ValidateIapAttributeExpression 方法的記錄名稱和記錄值區位置發生變化。

CAL 類型已改回 DATA_ACCESS。

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

• 稽核記錄類型
• 稽核記錄項目結構
• 儲存及轉送稽核記錄
• Cloud Logging 定價摘要
• 啟用資料存取稽核記錄

附註

「欄位」部分說明稽核記錄中部分欄位的重要詳細資料。

服務名稱

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 屬性。如果方法需要 IAM 權限，且 type 屬性值為 DATA_READ、DATA_WRITE 或 ADMIN_READ，就會產生「資料存取」稽核記錄。需要 IAM 權限且 type 屬性值為 ADMIN_WRITE 的方法，會產生管理員活動稽核記錄。

下列清單中標示 (LRO) 的 API 方法，都是長時間執行的作業 (LRO)。這些方法通常會產生兩筆稽核記錄項目：一筆是在作業開始時產生，另一筆則是在作業結束時產生。詳情請參閱長時間執行的作業的稽核記錄。

權限類型	方法
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 的身分與存取權管理說明文件。

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 是否允許所要求存取權的布林值。