Connect your AEM Forms environment with hCaptcha®

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.

Configure your Cloud Services:

1. On your AEM author instance, go to > Cloud Services and Click hCaptcha®.
   

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

3. Specify Title, Site Key, and Secret Key for hCaptcha® service obtained in Prerequisite.

4. Click Create.

   

NOTE

Users need not to modify Client-side JavaScript validation URL and Server-side validation URL as they are already prefilled for hCaptcha® validation.

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

Open your AEM Forms environment.

Go to Forms > Forms and Documents.

Select an Adaptive Form and Click Properties.

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

Click Save & Close.

If you do not have a Configuration Container for hCaptcha, see section Connect your AEM Forms environment with hCaptcha® to learn how to create a Configuration Container.

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

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

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

• 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 hCaptcha®.

• Configuration Settings: Select your Cloud Configuration configured for hCaptcha®.

  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 hCaptcha® to learn how to create a Cloud Service that connects your AEM Forms environment with hCaptcha® 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 hCaptcha® challenge dialog. Use the Compact option to display a small sized and the Normal to display a relatively large-size hCaptcha® challenge dialog or Invisible to validate hCaptcha® without explicitly rendering the checkbox widget on the user interface.

Select Done.