解讀網站的評估結果

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

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

事前準備

為網站建立評估。

解讀評估結果

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

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

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

  • extendedVerdictReasons：判定風險分析結果的進階推論。

    在專案中新增帳單帳戶，觸發自動安全性審查後，即可查看原因代碼。如要申請原因代碼存取權，請在專案中新增帳單帳戶。

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

    {
 "event":{
    "expectedAction":"EXPECTED_ACTION",
    "userInfo":{
      "accountId":"ACCOUNT_ID"
    },
    "siteKey":"KEY_ID",
    "token":"TOKEN",
    "userAgent":"(USER-PROVIDED STRING)",
    "userIpAddress":"USER_PROVIDED_IP_ADDRESS"
 },
 "name":"ASSESSMENT_ID",
 "riskAnalysis":{
   "reasons":[],
   "extendedVerdictReasons":[],
   "score":"SCORE",
   "challenge":"PASSED"
 },
 "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 分則代表互動的風險高，可能是詐欺行為。

在 11 個等級中，只有下列四個分數等級可用，之後必須在專案中新增帳單帳戶，觸發自動安全性審查：0.1、0.3、0.7 和 0.9。

如要申請 11 個分數級別的存取權，請在專案中新增帳單帳戶。

SMS Defense 風險評分與 reCAPTCHA 全域分數相反。如果 SMS Defense 風險分數為 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，確認真陽性和真陰性，或修正錯誤。詳情請參閱「為評量加上註解」。