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 Turnstile:

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 Turnstile.
   

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

3. Specify Widget Type as managed, widget type can change which depends on the key obtained in the prerequisite, Title, Name, Site Key, and Secret Key for Turnstile 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 Turnstile, and select Save & Close.

If you do not have such a Configuration Container, see section Connect your AEM Forms environment with Turnstile 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 validating Captcha 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 Cloudfare Turnstile Captcha service.

• Captcha Configuration: Select a Cloud Configuration configured for Turnstile. for example, here you select the managed key.

  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 Turnstile to learn how to create a Cloud Service that connects your AEM Forms environment with Turnstile 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 Turnstile challenge dialog. Use the Compact option to display a small sized and the Normal option to display a relatively large-size Turnstile challenge dialog.

  note note
  NOTE
  This is applicable for widget type Managed and Non-interactive. If the widget type is invisible, the size property is not required and it is disabled.

Select Done.