Domande frequenti (FAQ)

Devo utilizzare reCAPTCHA Enterprise?

reCAPTCHA Enterprise offre un milione di valutazioni al mese senza costi e funzionalità aggiuntive. Altre funzionalità, come l'analisi in tempo reale, rappresentano il punto di partenza ideale per la maggior parte degli sviluppatori. Inizia qui senza costi.

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 2 o 3?

Il 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 proprio traffico. Per ulteriori informazioni, consulta la guida per gli sviluppatori reCAPTCHA v3.

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

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

Posso eseguire reCAPTCHA v2 e v3 sulla stessa pagina?

Per farlo, carica la chiave di sito v3 come documentata, quindi esegui il rendering esplicito della versione v2 utilizzando grecaptcha.render.

<html>
  <head>
    <title>reCAPTCHA demo: Running both v2 and v3</title>
    <script src="https://www.google.com/recaptcha/api.js?render=v3_site_key"></script>
    <script>
      grecaptcha.ready(() => {
        grecaptcha.render('html_element', {
           'sitekey' : 'v2_site_key'
        });
      });
    </script>
    <script>
      function onSubmit() {
        grecaptcha.ready(() => {
            grecaptcha.execute('v3_site_key', {action: 'homepage'}).then((token) => {
               ...
            });
        });
      }
    </script>
  </head>
</html>

reCAPTCHA utilizza i cookie?

Quando viene eseguito, reCAPTCHA imposta un cookie necessario (_GRECAPTCHA) allo scopo di fornire la sua analisi del rischio. Se preferisci non utilizzare il dominio www.google.com per cui potrebbero essere impostati altri cookie, puoi utilizzare www.recaptcha.net.

Esistono limiti giornalieri o di QPS relativi al mio utilizzo di reCAPTCHA?

Se vuoi effettuare più di 1000 chiamate al secondo o 1000.000 chiamate al mese, devi utilizzare reCAPTCHA Enterprise o compilare questo modulo e attendere 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 sua quota mensile, l'apertura di site_verify potrebbe non riuscire a restituire un punteggio statico pari a 0,9 e un messaggio di errore "Oltre la quota senza costi" 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 propria quota mensile, il seguente messaggio o un messaggio simile potrebbe essere visualizzato nel widget reCAPTCHA per il resto del mese: "Questo sito supera la quota reCAPTCHA". Prima dell'applicazione della quota, i proprietari dei siti riceveranno una notifica via email tre volte e avranno almeno 90 giorni di tempo per eseguire la migrazione a reCAPTCHA Enterprise. Le chiavi del sito vengono considerate oltre la quota se più di 1000000 chiamate al mese vengono utilizzate per qualsiasi dominio. Questo include il caso in cui il volume è distribuito su più chiavi nello stesso dominio.

Vorrei nascondere il badge reCAPTCHA. Che cosa è consentito?

Puoi nascondere il badge a condizione di includere il branding reCAPTCHA in modo visibile 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: per 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 perché reCAPTCHA v3 si basa sulla visualizzazione del traffico reale.

Per reCAPTCHA v2, utilizza le seguenti chiavi di test. In questo modo, riceverai sempre nessun 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 assicurarsi che non sia utilizzato per il traffico di produzione.

Come faccio a visualizzare ulteriori 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 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>.
  • Successivamente, applica la stessa procedura a tutti gli altri siti che utilizzano "www.google.com/recaptcha/" sul tuo sito.

Posso personalizzare il badge o il widget reCAPTCHA?

Sì. reCAPTCHA offre due temi, chiaro e scuro, come mostrato di seguito. Per scegliere un tema, è sufficiente impostare 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 3. Utilizza semplicemente l'API JavaScript per eseguire il rendering esplicito di reCAPTCHA con una chiave di sito v3 per accedere a opzioni come il riposizionamento del badge o la modifica del tema.

Durante il rendering di reCAPTCHA v3 con questo metodo, ricordati di impostare il parametro size su 'invisible' e utilizzare l'ID client restituito da grecaptcha.render durante la chiamata a grecaptcha.execute anziché la chiave di sito.

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

Se visualizzi questo errore, la chiave di sito reCAPTCHA non è più valida. Per attivarlo, registra un nuovo codice e segui le instructions riportate nella pagina indicata.

Mi viene segnalato un errore SecurityError non rilevato: l'accesso a un frame con origine "&lttuo dominio &gt" da un frame con origine"https://www.google.com" è stato bloccato. Che cosa devo fare?

Ciò si verifica in genere se l'elemento HTML del widget reCAPTCHA viene rimosso in modo programmatico un po' di tempo 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 CSP (Content-Security-Policy) sul mio sito web. Come faccio a configurarlo in modo che funzioni con reCAPTCHA?

Ti consigliamo di utilizzare l'approccio basato su nonce documentato con CSP3. Assicurati di includere il nonce nel tag script reCAPTCHA api.js 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/

Ricevo 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 localhost solo nella chiave del sito di sviluppo.

Solo su iOS 10, la pagina scorre fino in fondo quando l'utente completa la sfida?

Questo è un bug incentrato sul lato di Apple che abbiamo segnalato loro. Il problema riguarda solo gli utenti di iOS 10 e solo su 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 automatizzate?

Se fossi stato indirizzato a questa pagina dal widget reCAPTCHA, avresti visualizzato il messaggio "Siamo spiacenti, ma il tuo computer o la tua rete potrebbero inviare query automatizzate. Per proteggere i nostri utenti, al momento non possiamo elaborare la tua richiesta."

Purtroppo questo può accadere a utenti buoni per una serie di motivi:

  • Potresti essere su una rete condivisa usata in modo illecito
  • 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 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.