Interpreta i test per i siti web

Questa pagina spiega come interpretare un punteggio per comprendere il livello di rischio delle interazioni degli utenti e intraprendere le azioni appropriate per il tuo sito.

reCAPTCHA restituisce un punteggio per ogni richiesta in base alle interazioni con il tuo sito, indipendentemente dal tipo di chiave. Dopo aver ricevuto il punteggio da reCAPTCHA, devi interpretarlo e intraprendere le azioni appropriate per il tuo sito.

Prima di iniziare

Creare un test per il tuo sito web.

Interpretare la valutazione

Dopo che il backend invia un token di risposta reCAPTCHA di un utente a reCAPTCHA, ricevi una valutazione come risposta JSON, come mostrato nell'esempio seguente.

Per interpretare una valutazione, considera i seguenti parametri:

• valid: indica se il token di risposta dell'utente fornito è valido. Quando valid = false, il motivo è specificato in invalidReason. valid = false può anche indicare che un utente non è riuscito a risolvere una verifica o che si è verificata una mancata corrispondenza siteKey.
• invalidReason: il motivo associato alla risposta quando valid = false.
• action: un'interazione dell'utente che ha attivato la verifica reCAPTCHA.
• expectedAction: l'azione prevista da un utente che hai specificato durante la creazione del test.
• score: il livello di rischio dell'interazione dell'utente.
• reasons: informazioni aggiuntive su come reCAPTCHA ha interpretato l'interazione dell'utente.

• challenge (anteprima): indica la risposta alla sfida per le chiavi della sfida basata sulle norme. Valori possibili: PASS, FAIL o NOCAPTCHA.

  {
   "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":[],
     "score":"SCORE"
     "challenge":"PASS"
   },
   "tokenProperties":{
     "action":"USER_INTERACTION",
     "createTime":"TIMESTAMP",
     "hostname":"HOSTNAME",
     "invalidReason":"(ENUM)",
     "valid":(BOOLEAN)
   }
  }

Verificare le azioni

La risposta JSON contiene il parametro action che hai specificato per un'interazione utente durante la chiamata a execute() e il parametro expectedAction che hai specificato durante la creazione della valutazione.

Verifica che action corrisponda a expectedAction. Ad esempio, un'azione login deve essere restituita nella pagina di accesso. In caso di mancata corrispondenza, ciò indica che un utente malintenzionato sta tentando di falsificare le azioni. Puoi intraprendere azioni contro l'interazione dell'utente, ad esempio aggiungendo verifiche aggiuntive o bloccando l'interazione per impedire qualsiasi attività fraudolenta.

Interpreta i punteggi

Il sistema di punteggio di reCAPTCHA è un'espansione delle versioni precedenti di reCAPTCHA per consentire una maggiore granularità nelle risposte. reCAPTCHA ha 11 livelli per i punteggi con valori compresi tra 0,0 e 1,0. Il punteggio 1,0 indica che l'interazione presenta un rischio basso e molto probabilmente è legittima, mentre 0,0 indica che l'interazione presenta un rischio elevato e potrebbe essere fraudolenta.

Degli 11 livelli, solo i seguenti quattro sono disponibili prima di attivare una revisione della sicurezza automatica aggiungendo un account di fatturazione al progetto: 0,1, 0,3, 0,7 e 0,9.

Per richiedere l'accesso a 11 livelli di punteggio, aggiungi un account di fatturazione al tuo progetto.

Il punteggio di rischio di reCAPTCHA SMS defense funziona in modo inverso rispetto al punteggio globale di reCAPTCHA. Un punteggio di rischio di reCAPTCHA SMS defense pari a 0,0 indica una bassa probabilità che si verifichi una frode tariffaria tramite SMS, mentre un punteggio di rischio pari a 1,0 indica un'alta probabilità che si verifichi una frode tariffaria tramite SMS.

reCAPTCHA apprende monitorando il traffico reale sul tuo sito. Pertanto, i punteggi in un ambiente di staging e nei 7 giorni successivi all'implementazione potrebbero differire dai punteggi di produzione a lungo termine.

Se hai installato chiavi basate sul punteggio, puoi prima eseguire reCAPTCHA senza intraprendere azioni e poi decidere le soglie esaminando il traffico.

In base al punteggio, puoi intraprendere un'azione appropriata nel contesto del tuo sito. Per proteggere meglio il tuo sito, ti consigliamo di eseguire l'azione in background anziché bloccare il traffico.

La tabella seguente elenca alcune delle azioni che potresti intraprendere:

Codici motivo

I codici motivo sono disponibili dopo l'attivazione di un controllo di sicurezza automatico tramite l'aggiunta di un account di fatturazione al progetto. Per richiedere l'accesso ai codici motivo, aggiungi un account di fatturazione al tuo progetto.

Alcuni punteggi potrebbero essere restituiti con codici motivo che forniscono ulteriori informazioni su come reCAPTCHA ha interpretato le interazioni.

La tabella seguente elenca i codici motivo e le relative descrizioni:

Risposta del metodo siteverify

Il metodo siteverify restituisce un oggetto JSON contenente i seguenti campi quando viene utilizzato per creare una valutazione:

{
  "success": true|false,      // whether this request was a valid reCAPTCHA token for your site
  "score": number             // the score for this request (0.0 - 1.0)
  "action": string            // the action name for this request (important to verify)
  "challenge_ts": timestamp,  // timestamp of the challenge load (ISO format yyyy-MM-dd'T'HH:mm:ssZZ)
  "hostname": string,         // the hostname of the site where the reCAPTCHA was solved
  "error-codes": [...]        // optional
}

Passaggi successivi

• Per ottimizzare il modello specifico per il tuo sito, puoi inviare gli ID di valutazione a Google per confermare i veri positivi e i veri negativi o correggere gli errori. Per maggiori dettagli, vedi Annotare le valutazioni.