Risolvere i problemi di integrazione di reCAPTCHA

Questo documento elenca i problemi comuni di integrazione di reCAPTCHA che gli sviluppatori potrebbero riscontrare quando utilizzano reCAPTCHA nel loro ambiente.

Chiave del sito non valida

Se visualizzi l'errore Invalid site key, la chiave del sito reCAPTCHA non è più valida. Crea una nuova chiave e installala nelle tue pagine web.

Errore di migrazione delle chiavi

La migrazione delle chiavi del sito potrebbe non riuscire in uno dei seguenti scenari:

SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "&ltyour domain&gt"

In genere, questo si verifica se l'elemento HTML del widget reCAPTCHA viene rimosso a livello di programmazione qualche tempo dopo che l'utente finale ha fatto clic sulla casella di controllo. Ti consigliamo di utilizzare la funzione JavaScript grecaptcha.enterprise.reset() per reimpostare il widget reCAPTCHA.

Localhost non è incluso nell'elenco dei domini supportati

I domini localhost non sono supportati per impostazione predefinita. Se vuoi continuare a supportarli per lo sviluppo, puoi aggiungerli all'elenco dei domini supportati per la chiave del sito. Vai alla console Google Cloud per aggiornare l'elenco dei domini supportati. Ti consigliamo di utilizzare chiavi separate per lo sviluppo e la produzione e di consentire solo localhost nella chiave del sito di sviluppo.

reCAPTCHA ha restituito BROWSER_ERROR durante la creazione di una valutazione

I token BROWSER_ERROR si verificano quando lo script reCAPTCHA non può eseguire un'operazione execute. Nella maggior parte dei casi, questo problema è dovuto a un errore o a un timeout della rete lato client. Devi riprovare execute() utilizzando JavaScript.