Riconciliare la terminologia della console di amministrazione e della console Google Cloud

Questo documento descrive come identificare la versione della chiave reCAPTCHA (v2 o v3), mappare la terminologia della Console di amministrazione reCAPTCHA legacy alla consoleGoogle Cloud e recuperare le chiavi sito e le chiavi segrete richieste dalle piattaforme dei sistemi di gestione dei contenuti (CMS) e dai plug-in di terze parti, come le integrazioni di WordPress o Shopify.

Mappa la terminologia precedente alla console Google Cloud

Se gestisci le chiavi solo nella console di amministrazione reCAPTCHA, utilizzi reCAPTCHA Classic. Se gestisci le chiavi nella pagina Google Cloud Fraud Defense della console Google Cloud , utilizzi Fraud Defense. Entrambe le console supportano le chiavi di sito v2 e v3.

Molte piattaforme e plug-in CMS fanno riferimento alle chiavi reCAPTCHA utilizzando numeri di versione precedenti, come v2 Checkbox, v2 Invisible e v3. La consoleGoogle Cloud utilizza descrittori basati sulla piattaforma anziché numeri di versione.

La tabella seguente mappa la terminologia del CMS legacy e della Console di amministrazione alla terminologia della consoleGoogle Cloud :

Terminologia del CMS o della Console di amministrazione ConsoleGoogle Cloud (Dettagli piattaforma) Modifica chiave (campo Tipo) Meccanismo di verifica e compatibilità con il CMS
In base al punteggio (v3) Website • score Website • Score Verifica semplice basata sul punteggio. Utilizzala per i plug-in CMS che richiedono reCAPTCHA v3.
Verifica (v2) Website • checkbox Website • Checkbox challenge Richiede all'utente di selezionare la casella di controllo "Non sono un robot". Utilizzala per i plug-in CMS che richiedono la casella di controllo reCAPTCHA v2.
Invisibile (v2) Website • invisible Website • Invisible integration Analizza il rischio in background e potrebbe mostrare una verifica. Utilizzala per i plug-in CMS che richiedono reCAPTCHA v2 Invisible.
N/D Website • policy-based challenge Website • Policy-based challenge Attiva i test in base alla soglia di punteggio configurata. Richiede un'integrazione CreateAssessment personalizzata.
N/D iOS iOS app Chiave mobile iOS senza verifica.
N/D Android Android app Chiave mobile Android senza challenge.

Visualizza la versione della chiave nella console Google Cloud

Per visualizzare la versione della chiave nella console Google Cloud , segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Fraud Defense.

    Vai a Fraud Defense

  2. Seleziona la scheda Chiavi.

  3. Se le chiavi sono in visualizzazione Schede, passa alla visualizzazione Tabella.

  4. Controlla la colonna Dettagli piattaforma per la tua chiave. Ad esempio, Website • score corrisponde a v3 e Website • checkbox corrisponde a v2 Checkbox.

  5. Facoltativo. Nella visualizzazione Schede, fai clic su Dettagli chiave in una scheda chiave, quindi seleziona Modifica chiave. Il campo Tipo mostra la configurazione della chiave, ad esempio Website • Score per v3 o Website • Checkbox challenge per v2 Checkbox.

Trova la chiave del sito e la chiave segreta

I plug-in di terze parti e le piattaforme CMS spesso richiedono una chiave di sito e una chiave segreta per l'integrazione di reCAPTCHA:

  • Chiave di sito: nella console Google Cloud , l'ID chiave corrisponde alla chiave di sito.
  • Chiave segreta: la console Google Cloud non visualizza la chiave segreta per impostazione predefinita perché l'autenticazione Google Cloud in genere utilizza chiavi API o ruoli di Identity and Access Management. Tuttavia, puoi recuperare la chiave secret precedente per i plug-in che la richiedono. Alcune librerie o documentazioni di terze parti potrebbero fare riferimento alla chiave secret legacy come chiave privata.

Recupera la chiave secret nella console Google Cloud

Per recuperare la chiave del sito e la chiave segreta:

  1. Nella console Google Cloud , vai alla pagina Fraud Defense.

    Vai a Fraud Defense

  2. Seleziona la scheda Chiavi.

  3. Nella sezione Chiavi reCAPTCHA, vai alla chiave per cui ti serve la chiave segreta:

    • Se utilizzi la visualizzazione Schede, fai clic su Dettagli chiave nella scheda della chiave. L'ID chiave viene visualizzato nella parte superiore della pagina.
    • Se utilizzi la visualizzazione Tabella, l'ID chiave è visibile nella tabella. Fai clic sulla chiave per andare alla relativa pagina dei dettagli.

  4. Copia l'ID chiave visualizzato nella parte superiore della pagina. Questo valore è la tua chiave sito.

  5. Vai alla scheda Integrazione.

  6. A seconda dello stato della chiave, esegui una delle seguenti operazioni:

    • Se la chiave è configurata per l'utilizzo precedente, fai clic su Usa chiave precedente.
    • Se la chiave non è integrata con un servizio legacy, fai clic su Integra con un servizio o un plug-in di terze parti.

  7. Viene visualizzata una finestra di dialogo con la tua chiave segreta. Copia questo valore in modo sicuro. Tratta questo secret come dati sensibili.

    In alternativa, nella pagina Dettagli chiave, fai clic su Modifica chiave, quindi su Mostra accanto al campo Chiave segreta.

Integrazione con WordPress, Shopify o altre piattaforme CMS

Se utilizzi uno strumento per la creazione di siti web, una piattaforma di e-commerce o un plug-in CMS, la piattaforma o il plug-in carica lo script reCAPTCHA e verifica automaticamente i token utente. Non è necessario installare le librerie client reCAPTCHA o scrivere codice di backend personalizzato.

Per configurare reCAPTCHA in un CMS o in un plug-in di terze parti, segui questi passaggi:

  1. Controlla la versione di reCAPTCHA richiesta dal tuo CMS o plug-in: apri le impostazioni di integrazione di reCAPTCHA nel tuo CMS o plug-in e controlla quale tipo di chiave supporta (in genere reCAPTCHA v3 o reCAPTCHA v2 Checkbox).

  2. Seleziona o crea una chiave di corrispondenza:

    • Se hai già una chiave, visualizza la versione della chiave per verificare che corrisponda alla versione selezionata nel plug-in (Website • score per v3 o Website • checkbox per v2 Checkbox).
    • Se hai bisogno di una nuova chiave, creane una per il tuo sito web che corrisponda alla versione richiesta e aggiungi il dominio del tuo sito web (ad esempio example.com) all'elenco dei domini della chiave.

  3. Copia la chiave di sito e la chiave segreta legacy: segui i passaggi descritti in Recupera la chiave segreta nella consoleGoogle Cloud per ottenere l'ID chiave (chiave di sito) e la chiave segreta.

  4. Inserisci le chiavi nelle impostazioni del CMS o del plug-in:

    • Incolla l'ID chiave nel campo Chiave sito.
    • Incolla la chiave segreta nel campo Chiave segreta (o Chiave privata), quindi salva le impostazioni.

Integrare siti web personalizzati utilizzando i test

Il metodo CreateAssessment fornisce un'analisi dei rischi dettagliata e codici motivo, oltre a consentire l'accesso alle funzionalità avanzate di Fraud Defense. Puoi chiamare il metodo CreateAssessment utilizzando le librerie client reCAPTCHA o l'API REST.

Per saperne di più, consulta Crea un test per il tuo sito web.

Metodo SiteVerify legacy

Sebbene consigliamo il metodo CreateAssessment per le integrazioni nuove e personalizzate, alcuni sistemi esistenti o plug-in di terze parti si basano ancora sul metodo SiteVerify legacy. Questo metodo richiede una chiave secret associata alla chiave reCAPTCHA.

Se devi eseguire l'integrazione con un sistema che richiede l'API SiteVerify legacy, consulta Verifica i token di risposta degli utenti con SiteVerify legacy.

Passaggi successivi