Interpretare i test per le applicazioni mobile

Questa pagina spiega come interpretare un punteggio per comprendere il livello di rischio delle interazioni degli utenti e intraprendere le azioni appropriate per la tua applicazione mobile.

reCAPTCHA restituisce un punteggio per ogni richiesta in base alle interazioni con la tua applicazione mobile. Dopo aver ricevuto il punteggio da reCAPTCHA, devi interpretarlo e intraprendere le azioni appropriate per la tua applicazione mobile.

Prima di iniziare

Crea un test per la tua applicazione mobile.

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: 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.

  • 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"
 },
 "tokenProperties":{
   "action":"USER_INTERACTION",
   "androidPackageName":"ANDROID_PACKAGE_NAME",
   "createTime":"TIMESTAMP",
   "invalidReason":"(ENUM)",
   "iosBundleId":"IOS_BUNDLE_ID",
   "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.

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

Poiché le chiavi reCAPTCHA per le applicazioni mobile non interrompono il flusso utente, 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 della tua applicazione mobile. Per proteggere meglio la tua applicazione mobile, 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
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. 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à.

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.