Identity-Aware Proxy 稽核記錄

重要事項：

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

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，則會產生管理員活動稽核記錄。

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