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:
- Verifica che nelle tue pagine web sia incluso il seguente script:
https://www.google.com/recaptcha/api.js
. Nelle tue pagine web, sostituisci
https://www.google.com/recaptcha/api.js
conhttps://www.google.com/recaptcha/enterprise.js
.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:
Verifica di caricare
enterprise.js
in modo asincrono. Per ulteriori informazioni, consulta Caricamento di reCAPTCHA in modo asincrono.Aggiungi i seguenti suggerimenti sulle risorse nel tag
<head>
delle pagine che caricanoenterprise.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:
Sostituisci le chiamate di backend a
https://www.google.com/recaptcha/api/siteverify
con chiamate equivalenti arecaptchaenterprise.googleapis.com
. Per l'URL completo e il formato dei dati POST, consulta Creare una valutazione per il tuo sito web.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:
- Per Python o Java, 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.
- Per le altre lingue, utilizza la Federazione delle identità per i carichi di lavoro.