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

Crea una valutazione per il tuo sito web.

Interpreta la valutazione

Dopo che il tuo backend ha inviato un token di risposta reCAPTCHA di un utente a reCAPTCHA, ricevi un test 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 esiste una mancata corrispondenza di 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. Un punteggio più alto indica un rischio inferiore.
  • reasons: informazioni aggiuntive su come reCAPTCHA ha interpretato l'interazione dell'utente.
  • challenge: indica la risposta alla verifica per le chiavi di verifica basata su policy. Valori possibili: PASSED, FAILED o NOCAPTCHA.

  • extendedVerdictReasons: ragionamento avanzato che ha contribuito al verdetto dell'analisi dei rischi.

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

    Le valutazioni dei progetti con un abbonamento Enterprise ricevono anche i codici motivo avanzati. Contatta il tuo rappresentante dell'account o il team di vendita diGoogle Cloud per l'elenco completo dei motivi di ragionamento avanzato e per sapere come interpretarli.

    {
 "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)
 }
}

Verifica le azioni

La risposta JSON contiene il parametro action specificato per un'interazione utente quando chiami execute() e il parametro expectedAction 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 in base all'interazione dell'utente, ad esempio aggiungere ulteriori verifiche o bloccare l'interazione per impedire eventuali attività fraudolente.

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 livelli di punteggio sono disponibili prima di attivare un controllo di sicurezza automatico 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 SMS defense funziona in modo inverso rispetto al punteggio globale di reCAPTCHA. Un punteggio di rischio di SMS defense pari a 0,0 indica una bassa probabilità che si verifichi una frode tariffaria tramite SMS; un punteggio di rischio pari a 1,0 indica un'alta probabilità che si verifichi una frode tariffaria tramite SMS.

reCAPTCHA impara monitorando il traffico reale sul tuo sito. Pertanto, i punteggi in un ambiente di gestione temporanea ed entro 7 giorni dall'implementazione potrebbero differire dai punteggi di produzione a lungo termine.

Se hai installato chiavi basate su 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:

Caso d'uso Azione
home page Visualizza una panoramica coerente del tuo traffico nella Console di amministrazione filtrando gli scraper.
accedi Con punteggi bassi, richiedi l'MFA o la verifica email per impedire attacchi di credential stuffing.
social Limita le richieste di amicizia senza risposta da parte di utenti molesti e invia i commenti rischiosi alla moderazione.
e-commerce Dai la priorità alle vendite reali rispetto ai bot e identifica le transazioni rischiose.

Codici motivo

I codici motivo sono disponibili dopo aver attivato un controllo di sicurezza automatico aggiungendo 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:

Codice motivo Descrizione
AUTOMAZIONE L'interazione corrisponde al comportamento di un agente automatico.
UNEXPECTED_ENVIRONMENT L'evento ha avuto origine da un ambiente non legittimo.
TOO_MUCH_TRAFFIC Il volume di traffico proveniente dall'origine evento è superiore al normale.
UNEXPECTED_USAGE_PATTERNS L'interazione con il tuo sito è stata significativamente diversa dai pattern previsti.
LOW_CONFIDENCE_SCORE Il traffico ricevuto da questo sito è troppo scarso per generare un'analisi del rischio di qualità.

Risposta del metodo siteverify

Per i dettagli su richiesta, risposta e codice di errore per il metodo siteverify, consulta Verifica i token di risposta dell'utente con SiteVerify legacy.

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, consulta Annota le valutazioni.