Domande frequenti
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
-
Dovrei utilizzare reCAPTCHA Enterprise?
-
reCAPTCHA Enterprise offre fino a 10.000 valutazioni al mese senza costi
e fornisce anche funzionalità aggiuntive.
Altre funzionalità
come l'analisi in tempo reale,
rappresentano il punto di partenza migliore per la maggior parte degli sviluppatori.
Inizia da qui.
-
Posso utilizzare reCAPTCHA con soluzioni di terze parti?
-
Sì, puoi utilizzare sia reCAPTCHA (versione non Enterprise) sia reCAPTCHA
Aziende. In genere la soluzione di terze parti richiede la chiave pubblica
e la tua chiave segreta o API. Assicurati di fornire solo i tuoi
chiave segreta e chiave API a terze parti attendibili.
-
Come eseguire la migrazione a reCAPTCHA Enterprise dalla versione 2 o v3?
-
Lo
processo di migrazione
richiede 5-10 minuti e non richiede modifiche al codice.
-
Devo utilizzare reCAPTCHA v2 o v3?
-
reCAPTCHA v3 è destinato ai proprietari di siti che vogliono più 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 di reCAPTCHA v2 e v3, consulta il confronto delle versioni.
-
reCAPTCHA utilizza i cookie?
-
reCAPTCHA imposta un cookie necessario (_GRECAPTCHA) quando viene eseguito per fornire la propria analisi del rischio.
Se preferisci non utilizzare il dominio www.google.com, dove potrebbero essere impostati altri cookie, puoi utilizzare www.recaptcha.net.
-
Sono previsti QPS o limiti giornalieri per l'utilizzo di reCAPTCHA?
-
Se vuoi effettuare più di 1000 chiamate al secondo o 1000.000 al mese, devi utilizzare
reCAPTCHA Enterprise o compila
questo modulo e attendi l'approvazione di un'eccezione.
Se una chiave di sito supera 1000 QPS, alcune richieste potrebbero non essere elaborate.
Se una chiave di sito v3 supera la quota mensile, è possibile che l'apertura di site_verify potrebbe non riuscire.
restituendo un punteggio statico pari a 0,9 e un messaggio di errore "Quota senza costi".
per il resto del mese. Non ci sono indicazioni visibili all'utente quando
I siti della versione 3 superano la quota.
Se una chiave di sito v2 supera la quota mensile, quanto segue o un codice simile
il messaggio potrebbe essere mostrato agli utenti nel widget reCAPTCHA per il resto
del mese: "Questo sito supera la quota reCAPTCHA."
Prima dell'applicazione forzata della quota, i proprietari dei siti riceveranno tre notifiche via email
e sono stati concessi almeno 90 giorni per eseguire la migrazione a reCAPTCHA Enterprise.
Le chiavi sito sono considerate oltre la quota se vengono effettuate più di 1000.000 chiamate al mese
utilizzato per qualsiasi dominio. Ciò include se questo volume è distribuito su più
nello stesso dominio.
-
Vorrei nascondere il badge reCAPTCHA. Che cosa è consentito?
-
Puoi nascondere il badge purché includi il branding reCAPTCHA visibilmente nel flusso utente. Includi il seguente testo:
This site is protected by reCAPTCHA and the Google
<a href="https://policies.google.com/privacy">Privacy Policy</a> and
<a href="https://policies.google.com/terms">Terms of Service</a> apply.
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 precisi in quanto reCAPTCHA v3 si basa sulla visualizzazione del traffico reale.
Per reCAPTCHA v2, utilizza le seguenti chiavi di test. Riceverai sempre Nessun CAPTCHA e tutte le richieste di verifica andranno a buon fine.
- 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 posso evitare di accedere al codice reCAPTCHA durante il debug del mio sito?
-
Per evitare di accedere al codice reCAPTCHA durante il debug di altro JavaScript sul tuo sito, aggiungi lo script reCAPTCHA /recaptcha__.+\.js$ all'elenco degli elementi da ignorare del browser. Per istruzioni relative a Chrome, consulta Ignorare un elenco personalizzato di script. Funzionalità simili sono disponibili in altri browser.
-
Come faccio a visualizzare altre informazioni sul traffico del mio sito web?
-
reCAPTCHA segnala le statistiche giornaliere nella Console di amministrazione.
-
Posso utilizzare reCAPTCHA a livello globale?
-
Sì, utilizza "www.recaptcha.net" nel tuo codice nei casi in cui "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>
- Applica la stessa operazione a tutti gli altri dispositivi che utilizzano "www.google.com/recaptcha/" sul tuo sito.
-
-
Sì. reCAPTCHA offre due temi, chiaro e scuro, come mostrato di seguito. Per scegliere un tema, è sufficiente
Imposta l'attributo data-theme in grecaptcha.render
parametro.
Tema chiaro:
Tema scuro:
-
Come posso personalizzare reCAPTCHA v3?
-
L'API JavaScript disponibile per Invisible reCAPTCHA funziona anche per la versione 3. È sufficiente utilizzare l'API JavaScript per eseguire il rendering esplicito di reCAPTCHA con una chiave di sito v3 per accedere a opzioni quali il riposizionamento del badge o la modifica del tema.
Quando esegui il rendering di reCAPTCHA v3 con questo metodo, ricordati di impostare il parametro size su 'invisible' e di utilizzare l'ID client restituito da grecaptcha.render durante la chiamata a grecaptcha.execute anziché alla chiave di sito.
-
-
Se visualizzi questo errore, la chiave di sito reCAPTCHA non è più valida. Per attivare,
registra una nuova chiave e segui le istruzioni riportate nella pagina.
-
Ricevo un SecurityError non rilevato: ho bloccato un frame con origine "https://www.google.com" di accedere a un frame con origine "<tuo dominio>". Che cosa devo fare?
-
In genere questo si verifica se l'elemento HTML del widget reCAPTCHA viene rimosso in modo programmatico dopo che l'utente finale fa clic sulla casella di controllo. Ti consigliamo di utilizzare la funzione JavaScript grecaptcha.reset() per reimpostare il widget reCAPTCHA.
-
Utilizzo il criterio di sicurezza del contenuto (CSP) sul mio sito web. Come faccio a configurarlo affinché funzioni con reCAPTCHA?
-
Consigliamo di utilizzare l'approccio basato su nonce documentato con CSP3.
Assicurati di includere il tuo nonce nel tag script api.js di reCAPTCHA. 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/
-
Ricevo il messaggio di 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
puoi aggiungerli all'elenco dei domini supportati per la chiave di sito. Vai alla sezione
Console reCAPTCHA Enterprise
o alla console reCAPTCHA, a seconda dei casi,
per aggiornare l'elenco dei domini supportati. Consigliamo di usare chiavi separate per lo sviluppo e
produzione e per consentire solo localhost per la chiave del sito di sviluppo.
-
Solo su iOS 10, la pagina scorre fino in fondo quando l'utente completa la sfida?
-
Si tratta di un bug da parte di Apple che abbiamo segnalato. Il problema riguarda solo gli utenti che utilizzano iOS 10 e solo alcuni siti. Se il problema ti riguarda, una soluzione alternativa consiste nello 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 fossi stato indirizzato a questa pagina dal widget reCAPTCHA, avresti visualizzato il messaggio "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, ciò può accadere ai buoni utenti per una serie di motivi:
- Potresti trovarti su una rete condivisa utilizzata in modo illecito.
- Il tuo provider di servizi internet potrebbe averti recentemente assegnato un indirizzo IP sospetto
- Il sito a cui stai tentando di accedere potrebbe essere attualmente sottoposto a un attacco pesante
Per risolvere questi problemi, consulta la pagina di assistenza sul traffico insolito o riprova più tardi.
-
Quali nomi di azioni sono validi?
-
Le azioni possono contenere solo caratteri alfanumerici, barre e trattini bassi.
Le azioni non devono essere specifiche dell'utente.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003ereCAPTCHA Enterprise offers a free tier with 10,000 assessments per month and advanced features like real-time analytics.\u003c/p\u003e\n"],["\u003cp\u003eYou can migrate to reCAPTCHA Enterprise from v2 or v3 in 5-10 minutes without code changes.\u003c/p\u003e\n"],["\u003cp\u003ereCAPTCHA v3 provides website traffic insights while v2 focuses on security and usability.\u003c/p\u003e\n"],["\u003cp\u003ereCAPTCHA sets a necessary cookie but you can use www.recaptcha.net instead of www.google.com to avoid other potential Google cookies.\u003c/p\u003e\n"],["\u003cp\u003eTo hide the reCAPTCHA badge, ensure the reCAPTCHA branding is visible in the user flow with the provided text snippet.\u003c/p\u003e\n"]]],["reCAPTCHA offers Enterprise and non-Enterprise versions, with the former providing 10,000 free assessments monthly and features like real-time analytics. Migration to Enterprise is quick and doesn't require code changes. reCAPTCHA v3 provides more traffic data than v2. Both versions are compatible with third-party solutions, using public and secret/API keys. reCAPTCHA sets a necessary cookie, but an alternative domain is available. There are rate and volume limits; exceeding them may cause errors. You can hide the badge with specific text included, set testing keys, and use multiple ways to customize its behaviour.\n"],null,["# Frequently Asked Questions\n\n### Should I use reCAPTCHA Enterprise?\n\n\n:\n reCAPTCHA Enterprise offers up to 10,000 assessments per month at no cost\n and also provides additional features.\n [Other features](https://cloud.google.com/recaptcha-enterprise/docs/compare-versions)\n such as real time analytics provide the best place to start for most developers.\n [Get started here.](https://www.google.com/recaptcha/admin/enterprise)\n\n\n### Can I use reCAPTCHA with third party solutions?\n\n\n:\n Yes, you can use both reCAPTCHA (non-Enterprise version) and reCAPTCHA\n Enterprise. Typically the third party solution asks for your public key\n and either your secret key or your API key. Make sure to only provide your\n secret key and API key to trusted third parties.\n\n\n### How to migrate to reCAPTCHA Enterprise from v2 or v3?\n\n\n:\n The [migration process](http://cloud.google.com/recaptcha-enterprise/docs/migrate-recaptcha)\n takes 5-10 minutes to complete and requires no code changes.\n\n\n### Should I use reCAPTCHA v2 or v3?\n\n\n:\n reCAPTCHA v3 is for site owners who want more data about their traffic.\n For more information, see the [reCAPTCHA v3 developer guide](/recaptcha/docs/v3).\n\n We support security and usability for v2.\n\n\n For more information about reCAPTCHA v2 and v3 differences, see [versions comparison](/recaptcha/docs/versions).\n\n\n### Does reCAPTCHA use cookies?\n\n\n:\n reCAPTCHA sets a necessary cookie (_GRECAPTCHA) when executed for the purpose of providing its risk analysis.\n If you prefer to not use the www.google.com domain which may have other cookies set, you can use www.recaptcha.net instead.\n\n\n### Are there any QPS or daily limits on my use of reCAPTCHA?\n\n\n:\n If you wish to make more than 1000 calls per second or 1000000 calls per month, you must use\n [reCAPTCHA Enterprise](https://cloud.google.com/recaptcha-enterprise) or fill out\n [this form](https://forms.gle/caCX5Sgkz2N1maGa9) and wait for an exception approval.\n If a site key exceeds 1000 QPS, then some requests may not be processed.\n If a v3 site key exceeds its monthly quota, then site_verify may fail open\n by returning a static score 0.9 and an error message \\`\"Over free quota.\"\\`\n for the remainder of the month. There are no user-visible indications when\n v3 sites are over quota.\n If a v2 site key exceeds its monthly quota, then the following or a similar\n message may be displayed to users in the reCAPTCHA widget for the remainder\n of the month: \\`This site is exceeding reCAPTCHA quota.\\`\n Before quota is enforced, site owners will be notified by email three times\n and given at least 90 days to migrate to reCAPTCHA Enterprise.\n Site keys are considered over quota if more than 1000000 calls per month are\n used for any domain. This includes if this volume is spread across multiple\n keys on the same domain.\n\n\n### I'd like to hide the reCAPTCHA badge. What is allowed?\n\n\n: You are allowed to hide the badge as long as you include the reCAPTCHA branding visibly in the user flow. Please include the following text:\n\n ```html\n This site is protected by reCAPTCHA and the Google\n \u003ca href=\"https://policies.google.com/privacy\"\u003ePrivacy Policy\u003c/a\u003e and\n \u003ca href=\"https://policies.google.com/terms\"\u003eTerms of Service\u003c/a\u003e apply.\n ```\n\n For example:\n\n **Note:** if you choose to hide the badge, please use \n\n ```css\n .grecaptcha-badge { visibility: hidden; }\n ```\n\n \u003cbr /\u003e\n\n\n### I'd like to run automated tests with reCAPTCHA. What should I do?\n\n\n: For reCAPTCHA v3, create a separate key for testing environments. Scores may not be accurate as reCAPTCHA v3 relies on seeing real traffic.\n\n For reCAPTCHA v2, use the following test keys. You will always get No CAPTCHA and all verification requests will pass.\n\n - Site key: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI\n - Secret key: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe\n\n The reCAPTCHA widget will show a warning message to ensure it's not used for production traffic.\n\n\n### How can I avoid stepping into reCAPTCHA code when debugging my site?\n\n\n: To avoid stepping into the reCAPTCHA code while debugging other JavaScript on your site, add the reCAPTCHA script `/recaptcha__.+\\.js$` to your browser's ignore list. For instructions for Chrome, refer to [Ignore a custom list of scripts](https://developer.chrome.com/docs/devtools/settings/ignore-list). Similar features are available in other browsers.\n\n\n### How can I see more about my website's traffic?\n\n\n: reCAPTCHA reports daily stats in the [admin console](https://www.google.com/recaptcha/admin).\n\n\n### Can I use reCAPTCHA globally?\n\n\n: Yes, please use \"www.recaptcha.net\" in your code in circumstances when \"www.google.com\" is not accessible.\n\n - First, replace \\\u003cscript src=\"https://**www.google.com** /recaptcha/api.js\"\\\u003e\\\u003c/script\\\u003e with \\\u003cscript src=\"https://**www.recaptcha.net**/recaptcha/api.js\"\\\u003e\\\u003c/script\\\u003e\n - After that, apply the same to everywhere else that uses \"www.google.com/recaptcha/\" on your site.\n\n\n### Can I customize the reCAPTCHA widget or badge?\n\n\n: Yes. reCAPTCHA offers two themes, light and dark, as shown below. To choose a theme, simply\n set the data-theme attribute in the [grecaptcha.render\n parameter](/recaptcha/docs/display#render_param).\n\n Light theme:\n\n Dark theme:\n\n\n### How can I customize reCAPTCHA v3?\n\n\n: The [JavaScript API](/recaptcha/docs/invisible#js_api) available for Invisible reCAPTCHA also works for v3. Simply use the JavaScript API to explicitly render reCAPTCHA with a v3 site key to access options such as repositioning the badge or changing the theme.\n\n When rendering reCAPTCHA v3 with this method, remember to set the `size` parameter to `'invisible'` and use the client ID returned by `grecaptcha.render` when calling `grecaptcha.execute` instead of the site key.\n\n\n### Recently my reCAPTCHA widget started displaying \"Invalid site key\". What's happening?\n\n\n:\n\n If you are seeing this error, your reCAPTCHA site key is no longer valid. To activate, please\n [register a new key](https://www.google.com/recaptcha/admin) and follow the [instructions](/recaptcha/intro) on that page.\n\n\n### I'm getting an uncaught SecurityError: blocked a frame with origin \"https://www.google.com\" from accessing a frame with origin \"\\<your domain\\>\". What should I do?\n\n\n: This typically occurs if the reCAPTCHA widget HTML element is programmatically removed sometime after the end user clicks on the checkbox. We recommend using the [grecaptcha.reset()](/recaptcha/docs/display#js_api) javascript function to reset the reCAPTCHA widget.\n\n\n### I'm using Content-Security-Policy (CSP) on my website. How can I configure it to work with reCAPTCHA?\n\n\n: We recommend using the nonce-based approach documented with [CSP3](https://w3c.github.io/webappsec-csp/#framework-directive-source-list).\n Make sure to include your nonce in the reCAPTCHA [api.js](/recaptcha/docs/display#auto_render) script tag, and we'll handle the rest.\n\n Note: reCAPTCHA also works with ['strict-dynamic'](https://w3c.github.io/webappsec-csp/#strict-dynamic-usage) on browsers that support it.\n\n Alternatively, please add the following values to the directives:\n\n - **script-src** https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/\n - **frame-src** https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/\n\n\n### I'm getting an error \"Localhost is not in the list of supported domains\". What should I do?\n\n\n: localhost domains are not supported by default. If you wish to continue supporting them for\n development you can add them to the list of supported domains for your site key. Go to the\n [reCAPTCHA Enterprise console](https://console.cloud.google.com/security/recaptcha)\n or to the [reCAPTCHA console](https://www.google.com/recaptcha/admin), as appropriate,\n to update your list of supported domains. We advise to use separate keys for development and\n production, and to only allow localhost on your development site key.\n\n\n### Only on iOS 10, the page scrolls to the bottom when the user completes the challenge?\n\n\n: This is a focusing bug on Apple's side that we've reported to them. It affects users only on iOS 10 and only on some sites. If you are affected, a workaround is to move the reCAPTCHA widget higher or lower on the page, or use [reCAPTCHA v3](/recaptcha/docs/v3).\n\n\n### My computer or network may be sending automated queries?\n\n\n: If you were directed to this page from the reCAPTCHA widget, you would have seen a message that said \"We're sorry, but your computer or network may be sending automated queries. To protect our users, we can't process your request right now.\"\n\n This can unfortunately happen to good users for a few reasons:\n\n - You may be on a shared network that is being used abusively\n - Your internet service provider may have recently assigned you a suspicious IP address\n - The site you are trying to access may be currently under heavy attack\n\n To troubleshoot these issues, please look at the [unusual traffic help page](https://support.google.com/websearch/answer/86640), or try again later.\n\n\n### What action names are valid?\n\n\n: Actions might contain only alphanumeric characters, slashes, and underscores.\n Actions must not be user-specific."]]
