Skip to main content

CAPTCHA

CAPTCHA (Completely Automated Public Turing test to tell Computers & 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 from proceeding if the test fails and helps make online transactions secure by keeping bots from posting spam for malicious purposes. We use reCAPTCHA service by Google to implement CAPTCHA on adaptive forms.

Prerequisites

During initial form creation the Configuration Container should have been set to /conf/[agency-acronym]. If this was not set on creation, it can be updated within the form properties. If unsure of the agency acronym to use please contact DoIT.WebServices@illinois.gov, to confirm.

To open the form properties, hard-select the form. Then click Properties in the top tool bar.

  1. Remove the checkmark by 'Inherited from /content/dam'
  2. In the Configuration Container type: /conf/[agency-acronym]
  3. Click correct agency from the drop-down list
  4. Click Save & Close 

Placement

Place the CAPTCHA component at the end of the form. It should be the last component on the form above the toolbar, or the last component in the last panel on the form.

Configuration

Select the component and click the wrench icon on the component toolbar to configure the properties for CAPTCHA. Only two properties need changed in the configuration, as all others are already set correctly by default.

  • Name: auto-generated
  • Title: CAPTCHA
  • Hide title: Checkmark this field
  • Validation Message
    • No Value: Provide CAPTCHA to proceed.
    • Incorrect Value: Invalid CAPTCHA. Try again.
  • Validate CAPTCHA: Validate CAPTCHA at form submission
  • CAPTCHA Service: reCAPTCHA
  • Configuration
    • Settings: [agency-acronym]-recaptcha (only one option should be available in this list)
    • Type: Invisible

Once properties are set, click the checkmark in the upper right-hand corner of the configuration pane to save the changes. This will remove the title from the component, and a small square icon will be seen in the lower left-hand corner of the form. When icon is hovered over, a small flag will appear stating the form is "Protected by reCAPTCHA." If you see an error message in the flag review properties of the form and CAPTCHA component. If error persists please notify DoIT.WebServices@illinois.gov for further troubleshooting. If everthing is correct Placement will adjust accordingly once form is place on a site page.