ÃÛ¶¹ÊÓÆµ

Connect your AEM Forms environment with ³ó°ä²¹±è³Ù³¦³ó²¹Â® connect-your-forms-environment-with-hcaptcha-service

This feature is not enabled by default. You can write from your official address to aem-forms-ea@adobe.com to request access to the feature.

CAPTCHA (Completely Automated Public Turing test to tell Computers and Humans Apart) is a program commonly used in online transactions to distinguish between humans and automated programs or bots. It poses a challenge and evaluates user response to determine if it’s a human or a bot interacting with the site. It prevents the user to proceed if the test fails and helps make online transactions secure by keeping bots from posting spam or malicious purposes.

In addition to ³ó°ä²¹±è³Ù³¦³ó²¹Â®, AEM Forms 6.5 supports the following CAPTCHA solutions:

Integrate AEM Forms environment with ³ó°ä²¹±è³Ù³¦³ó²¹Â®

³ó°ä²¹±è³Ù³¦³ó²¹Â® service protects your forms from bots, spam, and automated abuse. It poses a checkbox widget challenge and evaluates the user response to determine if it’s a human or a bot interacting with the form. It prevents the user to proceed if the test fails and helps make online transactions secure by keeping bots from posting spam or malicious activities.

AEM 6.5 Adaptive Forms support hCaptcha&reg. You can use it to present a checkbox widget challenge on form submission.

Prerequisites to integrate AEM Forms environment with ³ó°ä²¹±è³Ù³¦³ó²¹Â® prerequisite

To configure ³ó°ä²¹±è³Ù³¦³ó²¹Â® with AEM Forms, you need to obtain the from the ³ó°ä²¹±è³Ù³¦³ó²¹Â® website.

Configure ³ó°ä²¹±è³Ù³¦³ó²¹Â® steps-to-configure-hcaptcha

To integrate AEM Forms with ³ó°ä²¹±è³Ù³¦³ó²¹Â® service, perform the following steps:

  1. Create a Configuration Container on your AEM Forms environment, which holds Cloud Configurations used to connect AEM to external services. To create a Configuration Container:

    1. Open your AEM Forms environment.

    2. Go to Tools > General > Configuration Browser.

    3. In the Configuration Browser, you can select an existing folder or create a new folder:

      • To create a new folder and enable the Cloud Configurations:

        1. In the Configuration Browser, click Create.
        2. In the Create Configuration dialog, specify a name, title, and check Cloud Configurations.
        3. Click Create.
      • To enable Cloud Configuration for an existing folder:

        1. In the Configuration Browser, select the folder and select Properties.
        2. In the Configuration Properties dialog, enable Cloud Configurations.
        3. Click Save & Close to save the configuration and exit the dialog.
  2. Configure your Cloud Services:

    1. On your AEM author instance, go to tools-1 > Cloud Services and Click ³ó°ä²¹±è³Ù³¦³ó²¹Â®.
      hCaptcha in ui

    2. Select a Configuration Container, created or updated, as described in the previous section. Select Create.
      Configuration hCaptcha

    3. Specify Title, Site Key, and Secret Key for ³ó°ä²¹±è³Ù³¦³ó²¹Â® service obtained in Prerequisite.

    4. Click Create.

      Configure the Cloud Service to connect your AEM Forms environment with hCaptcha

    note note
    NOTE
    Users need not to modify and as they are already prefilled for ³ó°ä²¹±è³Ù³¦³ó²¹Â® validation.

    Once the hCAPTCHA service is configured, it is available for use in your adaptive form.

Use ³ó°ä²¹±è³Ù³¦³ó²¹Â® in an Adaptive Form using-hCaptcha-in-aem-6.5

  1. Open your AEM Forms environment.

  2. Go to Forms > Forms and Documents.

  3. Select an Adaptive Form and Click Properties.

  4. In the Configuration Container, select the Configuration Container that contains the Cloud Configuration that connects AEM Forms with hCaptcha.

  5. Click Save & Close.

    If you do not have a Configuration Container for hCaptcha, see section Connect your AEM Forms environment with ³ó°ä²¹±è³Ù³¦³ó²¹Â® to learn how to create a Configuration Container.

    Select Configuration Container

  6. Select an Adaptive Form and Click Edit to open the form in the editor.

  7. From the component browser, drag-drop the Captcha component onto the Adaptive Form.

  8. Select the Captcha component, and click properties Properties icon to open the properties dialog. Specify the following properties:

    hCaptcha v1

    • Title: Specify the title for your Captcha component.

    • Validation Message: Provide a validation message for your Captcha validation on form submission or on a user action.

    • Captcha Service: Select the CAPTCHA Service for your form submission, here you select ³ó°ä²¹±è³Ù³¦³ó²¹Â®.

    • Configuration Settings: Select your Cloud Configuration configured for ³ó°ä²¹±è³Ù³¦³ó²¹Â®.

      note note
      NOTE
      You can have multiple Cloud Configurations in your environment for a similar purpose. So, choose the service carefully. If no service is listed, see Connect your AEM Forms environment with ³ó°ä²¹±è³Ù³¦³ó²¹Â® to learn how to create a Cloud Service that connects your AEM Forms environment with ³ó°ä²¹±è³Ù³¦³ó²¹Â® service.
    • Error Message: Provide the error message to display to the user when the Captcha submission fails.

    • Captcha Size: You can select the display size of the ³ó°ä²¹±è³Ù³¦³ó²¹Â® challenge dialog. Use the Compact option to display a small sized and the Normal to display a relatively large-size ³ó°ä²¹±è³Ù³¦³ó²¹Â® challenge dialog or Invisible to validate ³ó°ä²¹±è³Ù³¦³ó²¹Â® without explicitly rendering the checkbox widget on the user interface.

  9. Select Done.

Now, only legitimate forms, in which the form filler successfully clears the challenge posed by the ³ó°ä²¹±è³Ù³¦³ó²¹Â® service are allowed for the form submission.

³ó°ä²¹±è³Ù³¦³ó²¹Â® is a registered trademark of Intuition Machines, Inc.

Frequently Asked Questions

  • Q: Can I use more than one Captcha component in an Adaptive Form?
  • Ans: Using more than one Captcha component in an Adaptive Form is not supported. Also, it is not recommended to use a Captcha component in a fragment or a panel marked for lazy loading.

See also see-also

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2