Verifica della risposta dell'utente

Questa pagina spiega come verificare la risposta di un utente a un test reCAPTCHA dalla tua applicazione di un backend cloud.

Per gli utenti web, puoi ottenere il token di risposta dell'utente in uno dei tre modi seguenti:

• g-recaptcha-response Parametro POST quando l'utente invia il modulo sul tuo sito
• grecaptcha.getResponse(opt_widget_id) dopo che l'utente ha completato la verifica reCAPTCHA
• Come argomento stringa per la funzione di callback se data-callback è specificato nell'attributo del tag g-recaptcha o nel parametro di callback nel metodo grecaptcha.render

Gli utenti della libreria Android possono chiamare il metodo SafetyNetApi.RecaptchaTokenResult.getTokenResult() per ottenere il token di risposta se lo stato restituisce un valore positivo.

Restrizioni relative ai token

Ogni token di risposta dell'utente reCAPTCHA è valido per due minuti e può essere verificato solo una volta per difendersi dagli attacchi di replay. Se hai bisogno di un nuovo token, puoi eseguire di nuovo la verifica reCAPTCHA.

Dopo aver ricevuto il token di risposta, devi verificarlo entro due minuti con reCAPTCHA utilizzando il metodo seguente per garantire che il token sia valido.

Richiesta API

URL: https://www.google.com/recaptcha/api/siteverify

METODO: POST

Parametro POST	Descrizione
secret	Obbligatorio. La chiave condivisa tra il tuo sito e reCAPTCHA.
response	Obbligatorio. Il token di risposta dell'utente fornito dall'integrazione lato client di reCAPTCHA sul tuo sito.
remoteip	(Facoltativo) L'indirizzo IP dell'utente.

Risposta dell'API

La risposta è un oggetto JSON:

{
  "success": true|false,
  "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
}

Per reCAPTCHA per Android:

{
  "success": true|false,
  "challenge_ts": timestamp,  // timestamp of the challenge load (ISO format yyyy-MM-dd'T'HH:mm:ssZZ)
  "apk_package_name": string, // the package name of the app where the reCAPTCHA was solved
  "error-codes": [...]        // optional
}

Messaggio del codice di errore

Codice di errore	Descrizione
missing-input-secret	Manca il parametro secret.
invalid-input-secret	Il parametro segreto non è valido o ha un formato non corretto.
missing-input-response	Parametro di risposta mancante.
invalid-input-response	Il parametro di risposta non è valido o ha un formato non corretto.
bad-request	La richiesta non è valida o è in un formato non corretto.
timeout-or-duplicate	La risposta non è più valida: è troppo vecchia o è stata utilizzata in precedenza.