Connect your AEM Forms environment with hCaptcha® connect-your-forms-environment-with-hcaptcha-service

Create a Configuration Container on your AEM Forms as a Cloud Service environment. A Configuration Container holds Cloud Configurations used to connect AEM to external services. To create and configure a Configuration Container to connect your AEM Forms environment with hCaptcha®:

1. Open your AEM Forms as a Cloud Service instance.

2. Go to Tools > General > Configuration Browser.

3. In the Configuration Browser, you can select an existing folder or create a folder. You can create a folder and enable the Cloud Configurations option for it or enable the Cloud Configurations option for an existing folder:

   • To create a folder and enable the Cloud Configurations option for it:

     1. In the Configuration Browser, click Create.
     2. In the Create Configuration dialog, specify a name, title, and select the Cloud Configurations option.
     3. Click Create.

   • To enable the Cloud Configurations option 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. Select Save & Close to save the configuration and exit the dialog.

Configure the Cloud Service:

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

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

3. Specify Title, Name, Site Key, and Secret Key for hCaptcha® service obtained in prerequisite. Select Create.

   

Open your AEM Forms as a Cloud Service instance.

Go to Forms > Forms and Documents.

Select an Adaptive Form and select Properties. For the Configuration Container option, select the Configuration Container that contains the Cloud Configuration that connects AEM Forms with hCaptcha®, and select Save & Close.

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

Select an Adaptive Form and select Edit. The Adaptive Form opens in Adaptive Forms Editor.

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

Select the Captcha component and click on properties icon. It opens the properties dialog.

Specify the following properties:

• Title: Specify the title for your Captcha component, you can identify a form component easily with its unique name both in the form and in the rule editor.

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

• Validate Captcha: You can select one of the options to validate Captcha:

  • At form Submission
  • On a user action.

• Captcha Service: Select your Captcha service, here you select hCaptcha® service.

• Captcha Configuration: Select a Cloud Configuration configured for hCaptcha®.

  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 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 select the display size of the hCaptcha® challenge dialog. Use the Compact option to display a small sized and the Normal option 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.