監控 reCAPTCHA 指標
本文說明 Identity Platform 與 reCAPTCHA Enterprise API 整合後,Identity Platform 產生的 reCAPTCHA 指標,以及如何透過 Cloud Monitoring 查看這些指標。
reCAPTCHA 指標
設定 Identity Platform 與 reCAPTCHA Enterprise API 的整合,並視需要啟用 reCAPTCHA SMS defense 後,即可監控專案發出的 reCAPTCHA 指標,確保驗證流程受到保護。如果 reCAPTCHA 金鑰佈建失敗,或未建立必要的服務帳戶,reCAPTCHA 驗證會失敗並開放存取。
如果您已在稽核模式下,為電子郵件/密碼驗證流程啟用 reCAPTCHA 機器人防護功能,監控 reCAPTCHA 指標有助於判斷是否可以啟用強制執行。啟用強制執行前,請考量下列事項:
- 如果近期要求大多具有有效權杖,且
PASSED與FAILED_AUDIT或FAILED_ENFORCE判定結果的比率符合業務需求,建議啟用強制執行功能。 - 如果近期要求大多來自過時的用戶端,建議您等更多使用者更新應用程式後,再啟用強制執行。強制將 Identity Platform 與 reCAPTCHA Enterprise API 整合,會導致未與 reCAPTCHA 整合的舊版應用程式中斷。
為確保整合功能正常運作,您可以檢查專案傳送至 Cloud Monitoring 的下列指標。
identitytoolkit.googleapis.com/recaptcha/verdict_count
這項指標會追蹤 reCAPTCHA 傳回的不同判定結果。如果權杖存在,系統就會產生判定結果。您可以根據下列判定結果進行篩選:
PASSED:表示啟用強制執行時,允許特定要求。FAILED_AUDIT:表示啟用 reCAPTCHA 稽核模式時,系統會拒絕指定的電子郵件密碼驗證要求。FAILED_ENFORCE:表示啟用 reCAPTCHA 強制執行時,特定要求遭到拒絕。CLIENT_TYPE_MISSING:表示啟用 reCAPTCHA 強制執行時,特定要求缺少用戶端類型。如果傳送要求時使用的用戶端 SDK 版本過舊,不支援 reCAPTCHA,通常就會發生這項錯誤。KEYS_MISSING:表示無法驗證特定要求,因為啟用 reCAPTCHA 強制執行功能時,Identity Platform 無法擷取有效的 reCAPTCHA 金鑰。
如要修改分數範圍,變更通過與失敗判定的比例,請參閱「啟用 reCAPTCHA 機器人防護功能」。
identitytoolkit.googleapis.com/recaptcha/token_count
這項指標會追蹤 Identity Platform 後端收到的 reCAPTCHA 權杖數量和狀態。您可以篩選下列狀態:
VALID:表示傳入的 reCAPTCHA 權杖有效。EXPIRED:表示傳入的 reCAPTCHA 權杖已過期。權杖過期可能表示用戶端網路發生問題或遭到濫用。DUPLICATE:表示傳入的 reCAPTCHA 權杖重複。重複的權杖可能表示用戶端網路問題或濫用行為。INVALID:表示傳入的 reCAPTCHA 權杖無效。無效的權杖可能代表有濫用行為。MISSING:表示指定要求中沒有 reCAPTCHA 權杖。如果缺少權杖,可能表示用戶端應用程式版本過舊。UNCHECKED:表示因CLIENT_TYPE_MISSING或KEYS_MISSING判定結果,而未檢查 reCAPTCHA 權杖。
如果應用程式已成功向使用者推出,您會看到含有有效權杖的流量。有效權杖的數量可能與使用更新版應用程式的使用者人數成正比。
identitytoolkit.googleapis.com/recaptcha/risk_scores
這項指標會追蹤 reCAPTCHA 分數分布情形。這有助於您定義機器人防護設定的最佳分數範圍。
identitytoolkit.googleapis.com/recaptcha/sms_tf_risk_scores
這項指標會追蹤特定 Identity Platform 專案的 reCAPTCHA SMS Defense 風險評分分布情形。這有助於您定義 reCAPTCHA SMS Defense 設定的最佳分數範圍。
查看 reCAPTCHA 指標
如要透過 Cloud Monitoring 查看 reCAPTCHA 指標,請按照下列步驟操作:
前往 Google Cloud 控制台的「Metrics Explorer」頁面。
在「選取指標」中,輸入「Identity Toolkit Tenant」。如果您使用多租戶功能,只要將
tenant_name留空,即可查看各個租戶和上層專案的指標。
後續步驟
- 瞭解如何排解 reCAPTCHA 整合的常見問題。