Custom reCAPTCHA

The OneBlink LcS currently support using custom Google reCATCHA keys. These are required for any custom domain apps or utilising the website embed script for forms with a reCATCHA (not a robot) element.

TABLE OF CONTENTS

• reCAPTCHA
• Steps to create
• Add reCAPTCHA to LcS
• Adding a new domain
• App and Environment Configuration

reCAPTCHA

I'm not a robot reCAPTCHA: Standard reCAPTCHA, requires the user to tick the box before they're allowed to submit the form, it may require the user to complete additional challenges before submitting if suspicious activity is detected.

Invisible reCAPTCHA badge: Works behind the scenes of the form, allowing most users to submit forms without any interaction, instead of a checkbox. A small card is displayed in the form to indicate that reCAPTCHA is active. If suspicious activity is detected, users may be asked to complete additional challenges.

Steps to create

Step 1: Navigate to the Google admin reCAPTCH page - https://www.google.com/recaptcha/admin

Step 2: Click the plus + button to add a new key

Step 3: Add a Label

Step 4: Select reCAPTCHA V2, "I'm not a robot" or Invisible reCAPTCHA badge Checkbox

Step 5: Add your domains, owners, and Accept the terms of service

Note: You will need to whitelist any domain that is used to access the form, for example, if the form is embedded on your website, the website domain will need to be whitelisted. If the form is also used within a OneBlink app for example in forms that include approval workflows, then those app URLs will also need to be whitelisted.

Step 6: Click Submit

Add reCAPTCHA to LcS

Step 1: Open the OneBlink LcS, navigate to the integrations menu and select Setup Integration.

Step 2: Enter a Label for your key, select either the "I'm not a robot" Checkbox or Invisible reCAPTCHA badge option, and add the Site Key, Secret Key and click Save

Adding a new domain

To add further domains to the LcS reCAPTCHA integrations, please do the following

Step 1: From the reCAPTCHA integration modal, click the "Add Domain" button.

Step 2: A new section will be presented fill in the Label, reCAPTCHA Key type, Site Key and Secret Key required fields and click the "Save" button.

Now when configuring the reCAPTCHA key in your App or environment you can choose between the two different domains. 

Environment and App Configuration

Now that the integration has been configured you will need to link your reCAPTCHA Key to either an Environment or an App. If the form is being embedded into another website then you will need to configure the reCAPTCHA key on the Environment menu. If the form is being used within an app then you will need to configure the reCAPTCHA key on the App menu.

The determining factor of whether for which reCAPTCHA is used is if the embed script contains a formsAppId. If the formsAppId is not present in the embed script then the Environment reCAPTCHA key will be used, if the formsAppId is present in the embed script then the App reCAPTCHA key will be used.

Environment reCAPTCHA Configuration

Step 1: Under Advanced Tools, select Environment and then select an environment:

Step 2: Then under the Developer Tools tab, the ReCAPTCHA option can be enabled, if you have more than one reCAPTCHA domain you will be able to select which one you would like to use.

App reCAPTCHA Configuration

Step 1: Open the App Menu and click Manage on the app.

Step 2: Navigate to the Developer Tools tab, the ReCAPTCHA option can be enabled, if you have more than one reCAPTCHA domain you will be able to select which one you would like to use.

Get Help

If you have any questions or would like assistance with setting up your reCAPTCH key please contact us via this support portal or email [email protected]. We are happy to assist in any way we can.