Domande frequenti

Devo utilizzare reCAPTCHA Enterprise?

reCAPTCHA Enterprise offre fino a 10.000 valutazioni al mese senza costi e fornisce anche funzionalità aggiuntive. Altre funzionalità come Analisi in tempo reale rappresentano il punto di partenza migliore per la maggior parte degli sviluppatori. Inizia qui.

Posso utilizzare reCAPTCHA con soluzioni di terze parti?

Sì, puoi utilizzare sia reCAPTCHA (versione non Enterprise) sia reCAPTCHA Enterprise. In genere, la soluzione di terze parti richiede la chiave pubblica e la chiave segreta o la chiave API. Assicurati di fornire la chiave segreta e la chiave API solo a terze parti attendibili.

Come eseguire la migrazione a reCAPTCHA Enterprise dalla versione v2 o v3?

Il processo di migrazione richiede 5-10 minuti per essere completato e non richiede modifiche al codice.

Devo utilizzare reCAPTCHA v2 o v3?

reCAPTCHA v3 è destinato ai proprietari di siti che vogliono maggiori dati sul loro traffico. Per ulteriori informazioni, consulta la guida per gli sviluppatori di reCAPTCHA v3.

Supportiamo la sicurezza e l'usabilità per la versione 2.

Per ulteriori informazioni sulle differenze tra reCAPTCHA v2 e v3, consulta il confronto tra le versioni.

reCAPTCHA utilizza i cookie?

reCAPTCHA imposta un cookie necessario (_GRECAPTCHA) quando viene eseguito per fornire la sua analisi dei rischi. Se preferisci non utilizzare il dominio www.google.com, che potrebbe avere altri cookie impostati, puoi utilizzare www.recaptcha.net.

Esistono limiti di QPS o giornalieri per l'utilizzo di reCAPTCHA?

Se vuoi effettuare più di 1000 chiamate al secondo o 1.000.000 di chiamate al mese, devi utilizzare reCAPTCHA Enterprise o compilare questo modulo e attendere l'approvazione di un'eccezione. Se una chiave di sito supera le 1000 QPS, alcune richieste potrebbero non essere elaborate. Se una chiave di sito v3 supera la quota mensile, "site_verify" potrebbe non riuscire ad aprirsi restituendo un punteggio statico di 0,9 e un messaggio di errore "Quota senza costi superata" per il resto del mese. Non ci sono indicazioni visibili agli utenti quando i siti v3 superano la quota. Se una chiave di sito v2 supera la quota mensile, agli utenti potrebbe essere visualizzato il seguente messaggio o un messaggio simile nel widget reCAPTCHA per il resto del mese: "Questo sito sta superando la quota di reCAPTCHA". Prima dell'applicazione della quota, i proprietari dei siti riceveranno tre notifiche via email e avranno almeno 90 giorni di tempo per eseguire la migrazione a reCAPTCHA Enterprise. Le chiavi sito sono considerate oltre la quota se vengono utilizzate più di 1.000.000 di chiamate al mese per un dominio. Ciò include il caso in cui questo volume sia distribuito su più chiavi nello stesso dominio.

Vorrei nascondere il badge reCAPTCHA. Che cosa è consentito?

Puoi nascondere il badge, a condizione che la visibilità del brand reCAPTCHA sia visibile nel flusso utente. Includi il seguente testo:

This site is protected by reCAPTCHA.

Ad esempio:

Nota: se scegli di nascondere il badge, utilizza

.grecaptcha-badge { visibility: hidden; }

Vorrei eseguire test automatici con reCAPTCHA. Che cosa devo fare?

Per reCAPTCHA v3, crea una chiave separata per gli ambienti di test. I punteggi potrebbero non essere accurati, poiché reCAPTCHA v3 si basa sull'analisi del traffico reale.

Per reCAPTCHA v2, utilizza le seguenti chiavi di test. Non riceverai mai un CAPTCHA e tutte le richieste di verifica verranno superate.

• Chiave del sito: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
• Chiave segreta: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

Il widget reCAPTCHA mostrerà un messaggio di avviso per garantire che non venga utilizzato per il traffico di produzione.

Come faccio a evitare di entrare nel codice reCAPTCHA durante il debug del mio sito?

Per evitare di entrare nel codice reCAPTCHA durante il debug di altri JavaScript sul tuo sito, aggiungi lo script reCAPTCHA /recaptcha__.+\.js$ all'elenco di elementi da ignorare del browser. Per istruzioni su Chrome, consulta Ignora un elenco personalizzato di script. Funzionalità simili sono disponibili in altri browser.

Come faccio a visualizzare ulteriori informazioni sul traffico del mio sito web?

reCAPTCHA genera report sulle statistiche giornaliere nella Console di amministrazione.

Posso utilizzare reCAPTCHA a livello globale?

Sì, utilizza "www.recaptcha.net" nel codice se "www.google.com" non è accessibile.

• Innanzitutto, sostituisci <script src="https://www.google.com/recaptcha/api.js"></script> con <script src="https://www.recaptcha.net/recaptcha/api.js"></script>
• Dopodiché, applica la stessa modifica a tutti gli altri elementi che utilizzano "www.google.com/recaptcha/" sul tuo sito.

Posso personalizzare il widget o il badge reCAPTCHA?

Sì. reCAPTCHA offre due temi, chiaro e scuro, come mostrato di seguito. Per scegliere un tema, imposta l'attributo data-theme nel parametro grecaptcha.render.

Tema chiaro:

Tema scuro:

Come faccio a personalizzare reCAPTCHA v3?

L'API JavaScript disponibile per reCAPTCHA invisibile funziona anche per la versione v3. Basta utilizzare l'API JavaScript per eseguire esplicitamente il rendering di reCAPTCHA con una chiave di sito v3 per accedere a opzioni come il riposizionamento del badge o la modifica del tema.

Quando esegui il rendering di reCAPTCHA v3 con questo metodo, ricorda di impostare il parametro size su 'invisible' e di utilizzare l'ID cliente restituito da grecaptcha.render quando chiami grecaptcha.execute anziché la chiave di sito.

Di recente, il mio widget reCAPTCHA ha iniziato a mostrare il messaggio "Chiave di sito non valida". Cosa succede?

Se visualizzi questo errore, la chiave di sito reCAPTCHA non è più valida. Per l'attivazione, registra una nuova chiave e segui le istruzioni riportate nella pagina.

Ricevo un errore SecurityError non rilevato: è stato bloccato l'accesso di un frame con origine "https://www.google.com" a un frame con origine "<your domain>". Che cosa devo fare?

In genere, questo accade se l'elemento HTML del widget reCAPTCHA viene rimosso in modo programmatico dopo che l'utente finale ha fatto clic sulla casella di controllo. Ti consigliamo di utilizzare la funzione JavaScript grecaptcha.reset() per reimpostare il widget reCAPTCHA.

Utilizzo Content Security Policy (CSP) sul mio sito web. Come posso configurarlo per l'utilizzo con reCAPTCHA?

Ti consigliamo di utilizzare l'approccio basato su nonce documentato con CSP3. Assicurati di includere il nonce nel tag di script api.js di reCAPTCHA e noi ci occuperemo del resto.

Nota: reCAPTCHA funziona anche con "strict-dynamic" sui browser che lo supportano.

In alternativa, aggiungi i seguenti valori alle istruzioni:

• script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
• frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/
• connect-src https://www.google.com/recaptcha/

Visualizzo l'errore "Localhost non è nell'elenco dei domini supportati". Che cosa devo fare?

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 tua chiave di sito. Vai alla console reCAPTCHA Enterprise o alla console reCAPTCHA, a seconda dei casi, per aggiornare l'elenco dei domini supportati. Ti consigliamo di utilizzare chiavi separate per lo sviluppo e la produzione e di consentire solo localhost sulla chiave del sito di sviluppo.

Solo su iOS 10, la pagina scorre verso il basso quando l'utente completa la verifica?

Si tratta di un bug di messa a fuoco di Apple che abbiamo segnalato all'azienda. Riguarda solo gli utenti su iOS 10 e solo su alcuni siti. Se il problema ti riguarda, una soluzione alternativa è spostare il widget reCAPTCHA più in alto o più in basso nella pagina oppure utilizzare reCAPTCHA v3.

Il mio computer o la mia rete potrebbero inviare query automatiche?

Se hai raggiunto questa pagina dal widget reCAPTCHA, avrai visto un messaggio che diceva "Siamo spiacenti, ma il tuo computer o la tua rete potrebbero inviare query automatiche. Per proteggere i nostri utenti, al momento non possiamo elaborare la tua richiesta."

Purtroppo, questo può accadere anche agli utenti corretti per alcuni motivi:

• Potresti essere su una rete condivisa che viene utilizzata in modo improprio
• Il tuo provider di servizi internet potrebbe averti assegnato di recente un indirizzo IP sospetto
• Il sito a cui stai tentando di accedere potrebbe essere attualmente sotto un pesante attacco

Per risolvere questi problemi, consulta la pagina di assistenza relativa al traffico anomalo o riprova più tardi.

Quali nomi delle azioni sono validi?

Le azioni possono contenere solo caratteri alfanumerici, barre e trattini bassi. Le azioni non devono essere specifiche per l'utente.