DocumentationAEM as a Cloud ServiceGuide de l’utilisateur

Connexion de votre environnement AEM Forms à Turnstile connect-your-forms-environment-with-turnstile-service

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Utilisateur ou utilisatrice
  • Développeur

Cette fonctionnalité est disponible dans le cadre du Programme Adopteur Anticipé. Vous pouvez écrire à aem-forms-ea@adobe.com à partir de votre adresse e-mail officielle pour rejoindre le programme d’adoption précoce et demander l’accès à la fonctionnalité.

CAPTCHA (Completely Automated Public Turing test to tell Computers and Humans Apart, Test public de Turing complètement automatisé ayant pour but de différencier les personnes humaines des ordinateurs) est un programme couramment utilisé dans les transactions en ligne pour différencier les personnes humaines des programmes automatisés ou des robots. Il présente un test et évalue la réponse de l’utilisateur ou de l’utilisatrice pour déterminer s’il s’agit d’une personne humaine ou d’un robot qui interagit avec le site. Cela empêche l’utilisateur ou l’utilisatrice de continuer si le test échoue et permet de sécuriser les transactions en ligne en empêchant les robots d’envoyer du spam ou des éléments malveillants.

AEM Forms as a Cloud Service prend en charge les solutions CAPTCHA suivantes :

Intégration de l’environnement AEM Forms à Turnstile Captcha

Le captcha de Cloudflare est une mesure de sécurité visant à protéger les formulaires et les sites contre les robots automatisés, les attaques malveillantes, les spams et le trafic automatisé indésirable. Il affiche une case à cocher lors de l’envoi du formulaire pour vérifier qu’il est humain, avant de lui permettre d’envoyer le formulaire. AEM Forms as a Cloud Service prend en charge le captcha de Turnstile dans les composants principaux de Forms adaptatif.

Conditions préalables pour intégrer l’environnement AEM Forms avec Turnstile Captcha prerequisite

Pour configurer Turnstile pour les composants principaux AEM Forms, vous devez obtenir la clé de site Turnstile et la clé secrète à partir du site Web Turnstile.

Configuration de Turnstile steps-to-configure-hcaptcha

Pour intégrer AEM Forms avec le service Turnstile, procédez comme suit :

  1. Créez un conteneur de configuration sur votre environnement as a Cloud Service AEM Forms. Un conteneur de configuration contient les configurations cloud utilisées pour se connecter AEM aux services externes. Pour créer et configurer un conteneur de configuration afin de connecter votre environnement AEM Forms à Turnstile :

    1. Ouvrez votre instance AEM Forms as a Cloud Service.

    2. Accédez à Outils > Général > Navigateur de configuration.

    3. Dans l’explorateur de configurations, vous pouvez sélectionner un dossier existant ou créer un dossier. Vous pouvez créer un dossier et activer l’option Configurations du cloud pour celui-ci ou Activer l’option Configurations du cloud pour un dossier existant :

      • Pour créer un dossier et activer l’option Configurations du cloud :

        1. Dans l’explorateur de configurations, cliquez sur Créer.
        2. Dans la boîte de dialogue Créer une configuration, indiquez un nom et un titre, puis sélectionnez l’option Configurations cloud .
        3. Cliquez sur Créer.

      • Pour activer l’option Configurations du cloud pour un dossier existant :

        1. Dans l’explorateur de configurations, sélectionnez le dossier, puis Propriétés.
        2. Dans la boîte de dialogue Propriétés de configuration, activez Configurations cloud.
        3. Sélectionnez Enregistrer et fermer pour enregistrer la configuration et fermer la boîte de dialogue.

  2. Configurez le Cloud Service :

    1. Sur votre instance d’auteur AEM, accédez à tools-1 > Cloud Service et sélectionnez Turnstile.

      Turnstile dans ui

    2. Sélectionnez un conteneur de configuration, créé ou mis à jour, comme décrit dans la section précédente. Sélectionnez Créer.

      Turnstile de configuration

    3. Spécifiez le type de widget comme géré, le titre, le nom, la clé du site et la clé secrète pour le service Turnstile obtenus dans la condition préalable.

    4. Cliquez sur Créer.

      Configurez le Cloud Service pour connecter votre environnement AEM Forms à Turnstile

    note note
    NOTE
    Les utilisateurs ne doivent pas modifier l’URL de validation JavaScript côté client et l’URL de validation côté serveur, car ils sont déjà préremplis pour la validation de Turnstile.

    Une fois le service de capture de Turnstile configuré, il peut être utilisé dans un formulaire adaptatif basé sur les composants principaux.

Utiliser Turnstile dans un formulaire adaptatif using-turnstile-core-components

  1. Ouvrez votre instance AEM Forms as a Cloud Service.

  2. Accédez à Forms > Forms and Documents.

  3. Sélectionnez un formulaire adaptatif et sélectionnez Propriétés. Pour l’option Conteneur de configuration, sélectionnez le Conteneur de configuration contenant la configuration cloud qui connecte AEM Forms à Turnstile et sélectionnez Enregistrer et fermer.

    Si vous ne disposez pas d’un tel conteneur de configuration, reportez-vous à la section Connexion de votre environnement AEM Forms à Turnstile pour savoir comment créer un conteneur de configuration.

    Sélectionner Conteneur de configuration

  4. Sélectionnez un formulaire adaptatif et choisissez Modifier. Le formulaire adaptatif s’ouvre dans l’éditeur de Forms adaptatif.

  5. A partir de l’explorateur de composants, faites glisser et ajoutez le composant Turnstile de formulaire adaptatif sur le formulaire adaptatif.

  6. Sélectionnez le composant Turnstile de formulaire adaptatif et cliquez sur l’icône de propriétés Icône Propriétés . Elle ouvre la boîte de dialogue des propriétés. Spécifiez les propriétés suivantes :

    Turnstile v2

    • Nom : Spécifiez le nom de votre composant Captcha. Vous pouvez identifier facilement un composant de formulaire avec son nom unique dans le formulaire et dans l’éditeur de règles.

    • Titre : Spécifiez le titre de votre composant Captcha.

    • Paramètres de configuration : sélectionnez une configuration cloud configurée pour Turnstile.

    • Message de validation : fournissez un message de validation pour valider Captcha lors de l’envoi du formulaire.

    • Message de validation de script : cette option permet de saisir un message à afficher en cas d’échec de la validation de script.

      note note
      NOTE
      Vous pouvez avoir plusieurs configurations de cloud dans votre environnement à des fins similaires. Choisissez donc le service avec soin. Si aucun service n’est répertorié, voir Connexion de votre environnement AEM Forms à Turnstile pour savoir comment créer un Cloud Service qui connecte votre environnement AEM Forms au service Turnstile.

      * **Message d’erreur :** indiquez le message d’erreur à afficher à l’utilisateur lorsque l’envoi du Captcha échoue.

  7. Sélectionnez Terminé.

Désormais, seuls les formulaires légitimes dans lesquels l’utilisateur parvient à résoudre le problème posé par le service Turnstile sont autorisés pour l’envoi du formulaire.

Défi Turnstile

Questions fréquentes

  • Q : Puis-je utiliser plusieurs composants Captcha dans un formulaire adaptatif ?
  • Réponse : L’utilisation de plusieurs composants Captcha dans un formulaire adaptatif n’est pas prise en charge. En outre, il n’est pas recommandé d’utiliser un composant Captcha dans un fragment ou un panneau marqué pour le chargement différé.

Voir également see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab