Utilizza le funzionalità di reCAPTCHA Enterprise dopo la migrazione

Questa pagina spiega come modificare un'integrazione reCAPTCHA esistente per utilizzare le funzionalità di reCAPTCHA Enterprise, come l'autenticazione a più fattori (MFA) e il rilevamento della perdita di password dopo la migrazione da una versione non Enterprise di reCAPTCHA. La modifica di un'integrazione reCAPTCHA esistente prevede l'implementazione delle pagine web e la migrazione delle chiamate di backend.

Prima di iniziare

Esegui la migrazione a reCAPTCHA Enterprise.

Strumenti per le pagine web

Per implementare le pagine web con gli script e le chiamate di reCAPTCHA Enterprise, segui questi passaggi:

  1. Verifica che nelle tue pagine web sia incluso il seguente script: https://www.google.com/recaptcha/api.js.

  2. Nelle tue pagine web, sostituisci https://www.google.com/recaptcha/api.js con https://www.google.com/recaptcha/enterprise.js.

  3. Se richiami l'API in modo programmatico, sostituisci le chiamate seguenti:

    • grecaptcha.execute() -> grecaptcha.enterprise.execute()
    • grecaptcha.getResponse() -> grecaptcha.enterprise.getResponse()
    • grecaptcha.ready() -> grecaptcha.enterprise.ready()
    • grecaptcha.render() -> grecaptcha.enterprise.render()
    • grecaptcha.reset() -> grecaptcha.enterprise.reset()

(Facoltativo) Per migliorare le prestazioni di caricamento di reCAPTCHA Enterprise, segui questi passaggi:

  1. Verifica di caricare enterprise.js in modo asincrono. Per ulteriori informazioni, consulta Caricamento di reCAPTCHA in modo asincrono.

  2. Aggiungi i seguenti suggerimenti sulle risorse nel tag <head> delle pagine che caricano enterprise.js:

    • <link rel="preconnect" href="https://www.google.com">
    • <link rel="preconnect" href="https://www.gstatic.com" crossorigin>

Esegui la migrazione delle chiamate di backend

Per utilizzare le funzionalità di reCAPTCHA Enterprise, devi eseguire la migrazione delle chiamate di backend ai nuovi endpoint e configurare l'autenticazione:

  1. Sostituisci le chiamate di backend a https://www.google.com/recaptcha/api/siteverify con chiamate equivalenti a recaptchaenterprise.googleapis.com. Per l'URL completo e il formato dei dati POST, consulta Creare una valutazione per il tuo sito web.

  2. Configura l'autenticazione a reCAPTCHA Enterprise.

    Il metodo di autenticazione che scegli dipende dall'ambiente in cui è configurato reCAPTCHA Enterprise. La tabella seguente ti aiuta a scegliere il metodo di autenticazione appropriato e l'interfaccia supportata per configurare l'autenticazione:

    Ambiente Interfaccia Metodo di autenticazione
    Google Cloud
    • REST
    • Librerie client
    		 Utilizza gli account di servizio collegati.
    On-premise o un cloud provider diverso REST Utilizza le chiavi API o la federazione delle identità per i carichi di lavoro.

    Se vuoi utilizzare le chiavi API, ti consigliamo di proteggerle applicando limitazioni alle chiavi API.
    Librerie client

    Usa quanto segue:

Passaggi successivi