Créer des clés reCAPTCHA pour des sites Web

Console d'administration

1. Accédez à la console d'administration reCAPTCHA.

   Accéder à la console d'administration reCAPTCHA

2. Dans le champ Libellé, saisissez un nom permettant d'identifier votre site.
3. Si vous souhaitez créer une clé basée sur un score, sélectionnez Sur la base d'un score (v3). Si vous souhaitez créer une clé de case à cocher, sélectionnez Défi (v2).
4. Pour ajouter un domaine, saisissez son nom, puis cliquez sur  add .

   Pour ajouter un autre domaine, vous pouvez répéter cette étape. Vous pouvez ajouter jusqu'à 250 domaines.

5. Si vous n'avez jamais utilisé la console Google Cloud , lisez les conditions d'utilisation, puis cochez la case.
6. Cliquez sur Envoyer.

Si vous n'avez jamais utilisé la console Google Cloud , un projet Google Cloud est créé et les API nécessaires sont activées pour vous permettre de commencer. Si vous disposez déjà d'un projet Google Cloud , les API nécessaires sont activées pour que vous puissiez commencer.

Cloud Console

1. Dans la console Google Cloud , accédez à la page reCAPTCHA.

   Accéder à reCAPTCHA

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 Créer une clé.
4. Dans le champ Nom à afficher, saisissez un nom à afficher pour la clé.
5. Pour le type d'application, sélectionnez Web.

   La section Liste de domaines s'affiche.

6. Saisissez le nom de domaine de votre site Web :

   1. Dans la section Liste de domaines, cliquez sur Ajouter un domaine.
   2. Dans le champ Domaine, saisissez le nom de votre domaine.

   3. Facultatif : pour ajouter un domaine supplémentaire, cliquez sur Ajouter un domaine et saisissez le nom d'un autre domaine dans le champ Domaine. Vous pouvez ajouter jusqu'à 250 domaines.

      Pour les sites Web, la clé reCAPTCHA est unique aux domaines et aux sous-domaines que vous spécifiez. Vous pouvez spécifier plusieurs domaines si vous diffusez votre site Web à partir de plusieurs domaines. Si vous spécifiez un domaine (par exemple, examplepetstore.com), vous n'avez pas besoin de spécifier ses sous-domaines (par exemple, subdomain.examplepetstore.com).

      Pour utiliser une clé sur plus de 250 domaines, cliquez sur le bouton Désactiver la validation du domaine. reCAPTCHA ignorera alors la liste des domaines. Vous devez valider vous-même le domaine en examinant le champ tokenProperties.hostname dans les évaluations que vous créez.

7. Selon le type de clé reCAPTCHA que vous souhaitez créer pour votre site Web, effectuez l'action appropriée :

Créer des clés reCAPTCHA basées sur des scores

1. Pour protéger la clé reCAPTCHA pour votre domaine et vos sous-domaines, assurez-vous que l'option Désactiver la validation du domaine est désactivée.

   La désactivation de la validation de domaine est un risque pour la sécurité, car il n'existe aucune restriction sur le site. Par conséquent, votre clé reCAPTCHA est accessible et utilisée par n'importe quel utilisateur.

2. Si vous souhaitez autoriser la clé basée sur des scores à fonctionner avec les pages AMP (Accelerated Mobile Pages), activez le bouton Autoriser cette clé à utiliser les pages AMP.

3. Pour votre environnement hors production, si vous souhaitez spécifier un score que la clé doit renvoyer lorsque des évaluations sont créées pour celui-ci, procédez comme suit :

   1. Cliquez sur Étape suivante (facultatif).
   2. À l'étape "Paramètres supplémentaires", cliquez sur le bouton Créez-vous cette clé à des fins de test uniquement ?.
   3. Utilisez le curseur Définir le score pour spécifier un score compris entre 0 et 1.
4. Cliquez sur Créer une clé.

La nouvelle clé est répertoriée sur la page Clés reCAPTCHA.

Créer des clés reCAPTCHA avec case à cocher

1. Pour protéger la clé reCAPTCHA pour votre domaine et vos sous-domaines, assurez-vous que l'option Désactiver la validation du domaine est désactivée.

   La désactivation de la validation de domaine est un risque pour la sécurité, car il n'existe aucune restriction sur le site. Par conséquent, votre clé reCAPTCHA est accessible et utilisée par n'importe quel utilisateur.

2. Cliquez sur Étape suivante (facultatif).
3. À l'étape "Paramètres supplémentaires", activez l'option Allez-vous utiliser des tests ?. activer/désactiver.
4. Sélectionnez l'option Test de sécurité appropriée.

   L'option "Test de sécurité" contrôle la probabilité qu'un utilisateur soit invité à effectuer un test secondaire dans lequel il doit sélectionner des images d'une catégorie identifiée (par exemple, des images de motos ou d'escaliers).

   Pour renforcer la protection contre les fraudes, sélectionnez l'option Difficile.

   Si vous sélectionnez Facile, les utilisateurs seront moins susceptibles d'être soumis au test visuel.

5. Pour votre environnement hors production, si vous souhaitez spécifier un score que la clé doit renvoyer lorsque des évaluations sont créées pour celui-ci, procédez comme suit :

   1. Cliquez sur le bouton d'activation Créez-vous cette clé à des fins de test uniquement ?.
   2. Utilisez le curseur Définir le score pour spécifier un score compris entre 0 et 1.
   3. Sélectionnez l'option Type de validation appropriée.
      • L'option Auto affiche parfois le défi.
      • Aucun CAPTCHA n'affiche pas de test.
      • Test insoluble : les images s'affichent, mais le test n'est pas réussi.
   4. Cliquez sur Créer une clé.

   La nouvelle clé est répertoriée sur la page Clés reCAPTCHA.

gcloud

Pour créer des clés reCAPTCHA, utilisez la commande gcloud recaptcha keys create.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

• DISPLAY_NAME : nom de la clé. Généralement un nom de site.
• INTEGRATION_TYPE : type d'intégration. Selon le type de clés, spécifiez les valeurs suivantes :
  • score pour les clés basées sur des scores.
  • checkbox pour les clés de cases à cocher.
• DOMAIN_NAME : domaines ou sous-domaines de sites Web autorisés à utiliser la clé.

  Spécifiez plusieurs domaines sous la forme d'une liste d'éléments séparés par une virgule.

  Pour utiliser une clé sur plus de 250 domaines, spécifiez --allow-all-domains pour désactiver la validation du domaine. reCAPTCHA ignorera alors la liste des domaines. Vous devez valider vous-même le domaine en examinant le champ tokenProperties.hostname dans les évaluations que vous créez.

  La désactivation de la validation de domaine est un risque pour la sécurité, car il n'existe aucune restriction sur le site. Par conséquent, votre clé reCAPTCHA est accessible et utilisée par n'importe quel utilisateur.

Exécutez la commande gcloud recaptcha keys create :

gcloud recaptcha keys create \
        --web \
        --display-name=DISPLAY_NAME  \
        --integration-type=INTEGRATION_TYPE \
        --domains=DOMAIN_NAME

gcloud recaptcha keys create `
        --web `
        --display-name=DISPLAY_NAME  `
        --integration-type=INTEGRATION_TYPE `
        --domains=DOMAIN_NAME

gcloud recaptcha keys create ^
        --web ^
        --display-name=DISPLAY_NAME  ^
        --integration-type=INTEGRATION_TYPE ^
        --domains=DOMAIN_NAME

La réponse contient la clé reCAPTCHA nouvellement créée.

REST

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• DISPLAY_NAME : nom de la clé. Généralement un nom de site.
• INTEGRATION_TYPE : type d'intégration. Selon le type de clés, spécifiez les valeurs suivantes :
  • score pour les clés basées sur des scores.
  • checkbox pour les clés de cases à cocher.
• DOMAIN_NAME : domaines ou sous-domaines de sites Web autorisés à utiliser la clé.

  Spécifiez plusieurs domaines sous la forme d'une liste d'éléments séparés par une virgule.

  Pour utiliser une clé sur plus de 250 domaines, spécifiez --allow-all-domains pour désactiver la validation du domaine. reCAPTCHA ignorera alors la liste des domaines. Vous devez valider vous-même le domaine en examinant le champ tokenProperties.hostname dans les évaluations que vous créez.

  La désactivation de la validation de domaine est un risque pour la sécurité, car il n'existe aucune restriction sur le site. Par conséquent, votre clé reCAPTCHA est accessible et utilisée par n'importe quel utilisateur.

Méthode HTTP et URL :

POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys

Corps JSON de la requête :

{
  "displayName": "DISPLAY_NAME",
  "webSettings": {
    "allowedDomains": "DOMAINS",
    "integrationType": "TYPE_OF_INTEGRATION"
  }
}

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/project-id/keys/6Ldqgs0UAAAAAIn4k7YxEB-LwEh5S9-Gv6IIWB8m",
  "displayName": "DISPLAY_NAME",
  "webSettings": {
    "allowAllDomains": false,
    "allowedDomains": [
      DOMAINS
    ],
    "allowAmpTraffic": false,
    "integrationType": "SCORE",
    "challengeSecurityPreference": "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED"
  }
}