Utiliser les fonctionnalités reCAPTCHA Enterprise après la migration

Cette page explique comment modifier une intégration reCAPTCHA existante afin d'utiliser les fonctionnalités reCAPTCHA Enterprise, telles que l'authentification multifacteur (MFA) et la détection de fuite de mots de passe, après la migration depuis une version non professionnelle de reCAPTCHA. La modification d'une intégration reCAPTCHA existante instrumente les pages Web et migre les appels backend.

Avant de commencer

Migrez vers reCAPTCHA Enterprise.

Instrumenter les pages Web

Pour instrumenter les pages Web à l'aide des scripts et des appels reCAPTCHA Enterprise, procédez comme suit:

  1. Vérifiez que le script suivant est inclus dans vos pages : https://www.google.com/recaptcha/api.js.
  2. Définissez le composant api.js sur enterprise.js.
  3. Remplacez les appels vers grecaptcha.execute() par des appels vers grecaptcha.enterprise.execute().

Migrer les appels backend

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

  1. Remplacez les appels backend par https://www.google.com/recaptcha/api/siteverify par https://recaptchaenterprise.googleapis.com.

  2. Choisissez le point de terminaison et la méthode d'authentification à utiliser pour créer des évaluations:

    Point de terminaison Méthode d'authentification Remarques
    v1beta1 Clé API

    Il s'agit de la méthode la plus rapide pour migrer l'appel du backend.

    Bien que cette méthode soit plus rapide, nous vous recommandons d'utiliser l'API v1 dans la mesure du possible, car certaines fonctionnalités, telles que l'API Annotation, ne sont disponibles que pour v1.

    v1 Compte de service Cette méthode est recommandée, mais la migration des appels backend prend plus de temps.
  3. Selon le point de terminaison que vous avez choisi, créez une clé API ou créez et configurez un compte de service.

Étape suivante