Utiliser les fonctionnalités reCAPTCHA après la migration

Cette page explique comment modifier une intégration reCAPTCHA existante pour utiliser les fonctionnalités de reCAPTCHA, telles que l'authentification multifacteur (MFA) et la détection de fuite de mots de passe après la migration à partir de reCAPTCHA Classic. 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 de reCAPTCHA, vous devez migrer vos appels de backend vers les nouveaux points de terminaison et configurer l'authentification:

  1. Remplacez les appels de 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 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
    Google Cloud
    • REST
    • Bibliothèques clientes
    		 Utilisez des comptes de service associés.
    Sur site ou chez un autre fournisseur 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é API.
    Bibliothèques clientes

    Utilisez les ressources suivantes :

Étape suivante