Guide de démarrage rapide : configurer reCAPTCHA Enterprise sur des environnements autres que Google Cloud à l'aide de clés API

Ce guide de démarrage rapide vous explique comment configurer reCAPTCHA Enterprise dans un environnement autre que Google Cloud à l'aide de clés API pour l'authentification dans les scénarios suivants :

  • Vous utilisez reCAPTCHA Enterprise dans un environnement autre que Google Cloud,, CRM ou SaaS compatible avec les méthodes d'authentification externes, telles que les comptes de service.
  • Vous devez utiliser le point de terminaison v1beta1 pour répondre aux exigences suivantes de votre environnement :

    • Votre environnement nécessite des fonctionnalités bêta et du programme d'accès anticipé (EAP), telles que l'authentification multifacteur (MFA) ou la détection de fuites de mots de passe.
    • Votre environnement ne nécessite pas le contrôle des accès basé sur les rôles.

Avant de commencer

  1. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  2. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

    reCAPTCHA Enterprise exige que la facturation soit associée et activée sur le projet pour accéder à l'API. Vous pouvez activer la facturation à l'aide d'une carte de crédit ou d'un ID de compte de facturation Google Cloud existant. Si vous avez besoin d'aide pour la facturation, contactez l'assistance Cloud Billing.

Activer l'API reCAPTCHA Enterprise

Console

  1. Dans Cloud Console, accédez à la page API reCAPTCHA Enterprise.

    Accéder à l'API reCAPTCHA Enterprise

  2. Vérifiez que le nom de votre projet s'affiche dans le sélecteur de projet en haut de la page.

    Si le nom de votre nouveau projet n'apparaît pas, cliquez sur le sélecteur de projet, puis sélectionnez votre projet.

  3. Cliquez sur Activer.

gcloud

  1. Pour définir votre projet Google Cloud dans la session gcloud, exécutez la commande gcloud config set project. Remplacez PROJECT_ID par l'ID de votre projet Google Cloud.
           gcloud config set project PROJECT_ID
           
  2. Pour activer l'API reCAPTCHA Enterprise, exécutez la commande gcloud services enable :
             gcloud services enable recaptchaenterprise.googleapis.com
           
  3. Pour vérifier que l'API reCAPTCHA Enterprise est activée, exécutez la commande gcloud services list :
             gcloud services list --enabled
           

    Vérifiez que l'API reCAPTCHA Enterprise est répertoriée dans la liste des API activées.

Créer une clé API

Créez une clé API dans votre projet Google Cloud :

  1. Dans Cloud Console, accédez à la page Identifiants.

    Accéder à "Identifiants"

  2. Cliquez sur  Créer des identifiants, puis sélectionnez Clé API.

  3. Vous pouvez également cliquer sur Restreindre la clé pour restreindre et renommer la clé API.

Utiliser la clé API pour l'authentification de backend

Utilisez la clé API que vous avez créée avec le point de terminaison v1beta1 lors de la création d'une évaluation.

Étape suivante

  1. Déterminez le type de clé reCAPTCHA (site) à utiliser et créez une clé reCAPTCHA.
  2. Installez des clés de site basées sur des scores ou une case à cocher sur des pages Web.

    OU

    Intégrez reCAPTCHA Enterprise aux applications Android ou aux applications iOS.

  3. Créez une évaluation.

  4. Interprétez une évaluation et prenez les mesures appropriées pour votre site en fonction du score.