API 金鑰稽核記錄

本文列出 API 金鑰的稽核方法。 Cloud de Confiance by S3NS 服務會產生稽核記錄，用以記錄 Cloud de Confiance by S3NS 資源中的管理和存取活動。如要進一步瞭解 Cloud 稽核記錄，請參閱以下內容：

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

服務名稱

如要查看 API 金鑰稽核記錄，請按照下列步驟操作：

1. 前往 Cloud de Confiance 控制台的「Logs Explorer」頁面：

   前往 Logs Explorer

2. 複製下列查詢並貼到「Logs Explorer」的「Query」欄位，然後點選「Run query」。

       protoPayload.serviceName="apikeys.googleapis.com"
     

依權限類型區分的方法

每個 IAM 權限都具有 type 屬性，其值為以下四個列舉值之一：ADMIN_READ、ADMIN_WRITE、DATA_READ 或 DATA_WRITE。呼叫方法時，API 金鑰會產生一筆稽核記錄，類別取決於執行該方法所需權限的 type 屬性。若方法需要的 IAM 權限，type 屬性值為 DATA_READ、DATA_WRITE 或 ADMIN_READ，就會產生資料存取稽核記錄；若所需 IAM 權限的 type 屬性值為 ADMIN_WRITE，則會產生管理員活動稽核記錄。

下表列出的 API 方法中，如標有 (LRO) 字樣，表示為長時間執行的作業。這類方法通常會產生兩個稽核記錄項目，作業開始和結束時各一個。詳情請參閱「長時間執行的作業稽核記錄」。

權限類型	方法
ADMIN_READ	google.api.apikeys.v2.ApiKeys.GetKeyString
ADMIN_WRITE	google.api.apikeys.v2.ApiKeys.CreateKey (LRO) google.api.apikeys.v2.ApiKeys.DeleteKey (LRO) google.api.apikeys.v2.ApiKeys.UndeleteKey (LRO) google.api.apikeys.v2.ApiKeys.UpdateKey (LRO) google.longrunning.Operations.GetOperation

API 介面稽核記錄

如要瞭解各方法所需的權限及評估方式，請參閱 API 金鑰的 Identity and Access Management 說明文件。

google.api.apikeys.v2.ApiKeys

屬於 google.api.apikeys.v2.ApiKeys 的方法會產生以下稽核記錄。

CreateKey

• 方法：google.api.apikeys.v2.ApiKeys.CreateKey
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • serviceusage.apiKeys.create - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.api.apikeys.v2.ApiKeys.CreateKey"
  

DeleteKey

• 方法：google.api.apikeys.v2.ApiKeys.DeleteKey
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • serviceusage.apiKeys.delete - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.api.apikeys.v2.ApiKeys.DeleteKey"
  

GetKeyString

• 方法：google.api.apikeys.v2.ApiKeys.GetKeyString
  
• 稽核記錄類型：資料存取
  
• 權限：
  • apikeys.keys.getKeyString - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.api.apikeys.v2.ApiKeys.GetKeyString"
  

UndeleteKey

• 方法：google.api.apikeys.v2.ApiKeys.UndeleteKey
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • apikeys.keys.undelete - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.api.apikeys.v2.ApiKeys.UndeleteKey"
  

UpdateKey

• 方法：google.api.apikeys.v2.ApiKeys.UpdateKey
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • serviceusage.apiKeys.update - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.api.apikeys.v2.ApiKeys.UpdateKey"
  

google.longrunning.Operations

屬於 google.longrunning.Operations 的方法會產生以下稽核記錄。

GetOperation

• 方法：google.longrunning.Operations.GetOperation
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • apikeys.keys.create - ADMIN_WRITE
  • apikeys.keys.delete - ADMIN_WRITE
  • serviceusage.operations.get - DATA_READ
  • serviceusage.services.enable - ADMIN_WRITE
  • serviceusage.services.get - DATA_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.longrunning.Operations.GetOperation"
  

不會產生稽核記錄的方法

某些方法可能不會產生稽核記錄，原因包括以下一或多項：

• 該方法的流量使用量高，若產生稽核記錄，會導致記錄與儲存成本過高。
• 稽核價值低。
• 其他稽核記錄或平台記錄已涵蓋該方法的活動。

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

• google.api.apikeys.v2.ApiKeys.GetKey
• google.api.apikeys.v2.ApiKeys.ListKeys
• google.api.apikeys.v2.ApiKeys.LookupKey