HomeGuidesRecipesAPI
HomeGuidesAPILog In
Guides
These docs are for v14. Click to read the latest docs for v31.

Overview

reCAPTCHA is a Google free service that protects your website from spam and abuse. reCAPTCHA uses an advanced risk analysis engine and adaptive challenges to keep automated software from engaging in abusive activities on your site. It does this while letting your valid users pass through with ease.

Features

  • reCaptcha V2
  • TestMode
  • Light and dark reCaptcha themes

Connector Components

  • reCaptcha Question Extension

Configuration

  1. Go to Manage Application, open Settings > Connector Settings > reCAPTCHA and provide the following information:
  • Default Site Key: Get this key from Google reCAPTCHA Admin Console.
  • Default Secret Key: Get this key from Google reCAPTCHA Admin Console.
  • Test Mode (True|False): Allows to skip reCAPTCHA for quick tests. This can also be enabled using troubleshooting mode for one specific project.

📘

Note

All of these individual settings are system wide parameters. It is also possible to define specific inputs per reCAPTCHA Question

  1. Click Save.

Using reCAPTCHA Question in Design

reCAPTCHA is a question that can be added at any point in a process. If you have already defined system wide properties for the Site Key and Secret Key there's no need to add the in design. By default, the question will use the Light Theme.

Question Inputs

Optional

  • Site Key: Get this key from Google reCAPTCHA Admin Console.
  • Secret Key: Get this key from Google reCAPTCHA Admin Console.
  • Theme: Allows to select Light or Dark themes.

To enable Test Mode for one specific project (instead of using the system wide option), just enable troubleshooting.

Question Extension Outputs

  • Success: [True|False] Before validation -> False, when reCAPTCHA is successful -> True.

Important Notes

  • reCAPTCHA Question cannot be directly referenced in a Form Summary. The Designer needs to map the response value to a label in order to make it a visible property.
  • reCAPTCHA Question is not recorded in the Interaction Log and Project Results.
  • reCAPTCHA v3 is not supported at this stage.