活動記錄

本文件說明如何使用 Cloud Logging 記錄 Identity Platform 的活動。

啟用活動記錄功能

活動記錄功能預設為停用。您可以透過 Google Cloud 控制台或 REST API 啟用活動記錄：

主控台

  1. 前往 Google Cloud 控制台的「設定」頁面。
    前往「設定」

  2. 在「使用者活動記錄」下方，選取「啟用」。

  3. 按一下 [儲存]。

REST 

curl -d "{'monitoring':{'requestLogging':{'enabled':true}}}" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -X PATCH -H 'Content-Type: application/json' \
  https://identitytoolkit.googleapis.com/admin/v2/projects/PROJECT_ID/config?updateMask=monitoring.requestLogging.enabled

將 PROJECT_ID 替換為專案 ID。

啟用活動記錄功能可能會影響帳單費用。詳情請參閱 Google Cloud Observability 定價。

為租用戶專案啟用活動記錄功能

根據預設，系統會停用用戶群專案的活動記錄功能。您可以使用 REST API 為租用戶專案啟用活動記錄功能，方法是執行下列指令：

curl -d "{'monitoring':{'requestLogging':{'enabled':true}}}" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -X PATCH -H 'Content-Type: application/json' \
  https://identitytoolkit.googleapis.com/v2/projects/PROJECT_ID/tenants/TENANT_ID?updateMask=monitoring.requestLogging.enabled

更改下列內容：

  • PROJECT_ID：專案 ID。
  • TENANT_ID：租戶 ID。

啟用活動記錄功能可能會影響帳單費用。詳情請參閱「Google Cloud Observability 定價」。

查看活動記錄

啟用記錄功能後，系統會為每個使用者要求產生一則記錄項目。每個記錄項目都包含下列欄位：

欄位 說明
logName projects/PROJECT_ID/logs/identitytoolkit.googleapis.com/requests
resource identitytoolkit_project or identitytoolkit_tenant
serviceName identitytoolkit.googleapis.com
protoPayload 記錄的要求或回應。

您可以使用記錄檔探索器查看專案或租用戶的活動記錄，如要查看記錄：

  1. 前往 Google Cloud 控制台的「Logs Explorer」頁面。

    前往「Logs Explorer」頁面

  2. 從「資源」下拉式選單中選取「Identity Toolkit 專案」或「Identity Toolkit 用戶群」。如果您使用多租戶，可以顯示所有租戶，或篩選特定租戶。

已記錄的作業

下表列出可產生活動記錄的 API 作業：

服務 方法
google.cloud.identitytoolkit.v1.AccountManagementService DeleteAccount
GetAccountInfo
GetOobCode
ResetPassword
SetAccountInfo
google.cloud.identitytoolkit.v1.AuthenticationService CreateAuthUri
GetRecaptchaParam
SendVerificationCode
SignInWithCustomToken
SignInWithEmailLink
SignInWithGameCenter
SignInWithIdp
SignInWithPassword
SignInWithPhoneNumber
SignUp
VerifyIosClient
google.cloud.identitytoolkit.v1.ProjectConfigService GetProjectConfig

排除作業

Logging 提供工具，可讓您停用記錄檔擷取作業，或排除不必要的記錄項目。如要進一步瞭解如何排除特定記錄檔，請參閱「記錄檔排除項目」。

以下範例說明如何排除唯讀 GetAccountInfo() 和 GetProjectConfig() 方法的記錄：

resource.type="identitytoolkit_project"
(
 jsonPayload.methodName="google.cloud.identitytoolkit.v1.AccountManagementService.GetAccountInfo"
 OR
 jsonPayload.methodName="google.cloud.identitytoolkit.v1.ProjectConfigService.GetProjectConfig"
)