Utiliser les fonctionnalités reCAPTCHA après la migration

Cette page explique comment modifier une intégration reCAPTCHA existante pour utiliser des fonctionnalités reCAPTCHA, telles que l'authentification multifacteur (MFA) et la détection des fuites de mots de passe, après avoir migré depuis une version non-Enterprise de reCAPTCHA. La modification d'une intégration reCAPTCHA existante implique l'instrumentation des pages Web et la migration des appels de backend.

Avant de commencer

Migrez vers reCAPTCHA.

Instrumenter les pages Web

Pour instrumenter les pages Web avec les scripts et les appels reCAPTCHA, procédez comme suit:

  1. Vérifiez que le script suivant est inclus dans vos pages : https://www.google.com/recaptcha/api.js.

  2. Dans vos pages Web, remplacez https://www.google.com/recaptcha/api.js par https://www.google.com/recaptcha/enterprise.js.

  3. Si vous appelez l'API par programmation, remplacez les appels suivants :

    • 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()

(Facultatif) Pour améliorer les performances de chargement de reCAPTCHA, procédez comme suit:

  1. Vérifiez que vous chargez enterprise.js de manière asynchrone. Pour en savoir plus, consultez la section Charger reCAPTCHA de manière asynchrone.

  2. Ajoutez les optimisations de ressources suivantes dans la balise <head> des pages qui chargent enterprise.js :

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

Migrer les appels de backend

Pour utiliser les fonctionnalités reCAPTCHA, vous devez migrer vos appels backend vers les nouveaux points de terminaison et configurer l'authentification:

  1. Remplacez les appels du backend à https://www.google.com/recaptcha/api/siteverify par des appels équivalents à recaptchaenterprise.googleapis.com. Pour obtenir l'URL complète et le format de données POST, consultez la page Créer une évaluation pour votre site Web.

  2. Configurez l'authentification auprès de reCAPTCHA.

    La méthode d'authentification que vous choisissez dépend de l'environnement dans lequel reCAPTCHA est configuré. Le tableau suivant vous aide à choisir la méthode d'authentification appropriée et l'interface compatible pour configurer l'authentification:

    Environnement Interface Méthode d'authentification
    Accès IAP
    • REST
    • Bibliothèques clientes
    		 Utilisez les comptes de service associés.
    Sur site ou via un autre fournisseur de services cloud REST Utilisez des clés API ou la fédération d'identité de charge de travail.

    Si vous souhaitez utiliser des clés API, nous vous recommandons de les sécuriser en appliquant des restrictions de clés API.
    Bibliothèques clientes

    Utilisez les ressources suivantes :

Étapes suivantes