解讀網站的評估結果

本頁面說明如何解讀分數，瞭解使用者互動行為產生的風險等級，並為網站採取適當行動。

無論金鑰類型為何，reCAPTCHA 都會根據與您網站的互動，傳回各項要求的分數。收到 reCAPTCHA 提供的分數後，您必須解讀分數，並為網站採取適當行動。

事前準備

為網站建立評估。

解讀評估結果

後端將使用者的 reCAPTCHA 回應權杖提交至 reCAPTCHA 後，您會收到評估結果，格式為 JSON 回應，如下列範例所示。

如要解讀評估結果，請考量下列參數：

  • valid：指出所提供的使用者回應權杖是否有效。如果是 valid = false，原因會指定在 invalidReason 中。valid = false 也可以指出使用者未通過驗證問題，或存在 siteKey 不符的情況。
  • invalidReason：與 valid = false 時的回應相關聯的原因。
  • action：觸發 reCAPTCHA 驗證的使用者互動。
  • expectedAction：您在建立評估時指定的使用者預期動作。
  • score：使用者互動帶來的風險等級。分數越高，風險越低。
  • reasons：reCAPTCHA 如何解讀使用者互動的其他資訊。
  • challenge：指出以政策為準的驗證問題金鑰的驗證問題回應。可能的值：PASS、FAIL 或 NOCAPTCHA。

  • extended_verdict_reasons：判定風險分析結果的進階理由。

    在專案中新增帳單帳戶後，系統會自動觸發安全性審查，審查完成後您就能查看原因代碼。如要要求存取原因代碼，請為專案新增帳單帳戶。

    訂閱 Enterprise 方案的專案評估也會收到進階原因代碼。如需完整進階原因清單和解讀方式，請洽詢帳戶代表或Google Cloud 銷售團隊。

    {
 "event":{
    "expectedAction":"EXPECTED_ACTION",
    "hashedAccountId":"ACCOUNT_ID",
    "siteKey":"KEY_ID",
    "token":"TOKEN",
    "userAgent":"(USER-PROVIDED STRING)",
    "userIpAddress":"USER_PROVIDED_IP_ADDRESS"
 },
 "name":"ASSESSMENT_ID",
 "riskAnalysis":{
   "reasons":[],
   "extended_verdict_reasons":[],
   "score":"SCORE",
   "challenge":"PASS"
 },
 "tokenProperties":{
   "action":"USER_INTERACTION",
   "createTime":"TIMESTAMP",
   "hostname":"HOSTNAME",
   "invalidReason":"(ENUM)",
   "valid":(BOOLEAN)
 }
}

驗證動作

JSON 回應包含您在呼叫 execute() 時為使用者互動指定的 action 參數，以及您在建立評估時指定的 expectedAction 參數。

確認 action 與 expectedAction 相符。 舉例來說，系統應在登入頁面傳回 login 動作。 如果不相符，代表有攻擊者企圖假冒正常操作。您可以針對使用者互動採取行動，例如新增額外驗證或封鎖互動，防止任何詐欺活動。

解讀分數

reCAPTCHA 的評分系統是先前 reCAPTCHA 版本的擴充功能，可提供更精細的回應。reCAPTCHA 的分數有 11 個等級，值介於 0.0 到 1.0 之間。1.0 分代表互動的風險低，很可能是正當活動；0.0 分則代表互動的風險高，可能是詐欺行為。

在將帳單帳戶新增至專案，觸發自動安全審查之前，您只能取得下列四種分數等級：0.1、0.3、0.7 和 0.9。

如要取得全部 11 個分數級別，請將帳單帳戶新增至專案。

簡訊防護風險分數與 reCAPTCHA 全域分數的運作方式相反。簡訊防護風險分數為 0.0，表示簡訊費用詐欺發生的可能性低；風險分數為 1.0，表示簡訊費用詐欺發生的可能性高。

reCAPTCHA 會監控網站上的實際流量，藉此學習。因此，在測試環境中，以及實作後 7 天內的分數，可能會與長期正式版分數不同。

如果您安裝了以分數為準的金鑰，可以先執行 reCAPTCHA，然後再查看流量以決定門檻值。

您可以根據分數，視網站情況採取適當行動。為進一步保護網站，建議您在背景採取行動，而非封鎖流量。

下表列出一些可能執行的動作：

用途 動作
首頁 在篩選擷取時，可在管理控制台上查看流量的整合檢視。
login 如果分數偏低，請要求使用者執行多重驗證或電子郵件驗證，防範憑證填塞攻擊。
社交 針對濫用使用者所發出的未回應交友請求，提供限制措施；並將可疑的評論送交審核。
電子商務 將您的實際銷售置於機器人之前並識別風險交易。

原因代碼

在專案中新增帳單帳戶後，系統會自動觸發安全性審查，審查完成後您就能查看原因代碼。如要要求存取原因代碼，請為專案新增帳單帳戶。

系統可能會傳回附有原因代碼的分數，提供 reCAPTCHA 解讀互動方式的額外資訊。

下表列出原因代碼和說明：

原因代碼 說明
AUTOMATION 互動符合自動代理程式的行為。
UNEXPECTED_ENVIRONMENT 事件源自於非法環境。
TOO_MUCH_TRAFFIC 事件來源的流量高於正常值。
UNEXPECTED_USAGE_PATTERNS 使用者與您網站的互動方式與預期模式大相逕庭。
LOW_CONFIDENCE_SCORE 這個網站的流量不足，無法產生品質風險分析。

siteverify 方法的回應

如要瞭解 siteverify 方法的要求、回應和錯誤代碼詳細資料，請參閱「使用舊版 SiteVerify 驗證使用者回應權杖」。

後續步驟

  • 如要調整網站專用模型，您可以將評估 ID 傳回 Google，確認真陽性和真陰性，或修正錯誤。詳情請參閱「為評估內容加上註解」。