How To Obtain and Enter a Set Of Google reCAPTCHA Keys

• Background
• Obtain Your Keys
• Install Your Keys Into Your Titan CMS Instance
• Enable Captcha on Forms

Background

reCAPTCHA is a free service from Google that helps protect websites from spam and abuse. A “CAPTCHA” is a turing test to tell human and bots apart. It is easy for humans to solve, but hard for “bots” and other malicious software to figure out. By adding reCAPTCHA to a site, you can block automated software while helping your welcome users to enter with ease. -Google documentation

What is the difference between reCAPTCHA v2 and v3?

ReCAPTCHA v2 requires the user to click the “I'm not a robot” checkbox and can serve the user an image recognition challenge. ReCAPTCHA v3 runs in the background and generates a score based on a user's behavior. The higher the score, the more likely the user is human

Billing

Google requires that a billing account be established in order to get a pair of ReCaptcha keys.  This should be done by the client so that they own and control the keys (and can pay for any charges that may be incurred).

Requirements

The following steps require that the person creating the ReCAPTCHA keys have a valid Google Account, preferrable one tied to the client and not a personal account.

Obtain Your Keys

1. Browse to https://www.google.com/recaptcha/admin and sign-in to your Google account
2. Click the (+) Plus button to create a new key-set.  You might also be prompted to register an Enterprise key-set.  Do so if prompted.
3. FAs you fill in the fields, you can click info to learn more about the fields and see what details are needed.
4. Enter a friendly name in the LABEL box (e.g. your company name)
   
5. Identify and select what reCAPTCHA type you need.  If you are unsure, follow this link for details:  developers.google.com/recaptcha/docs/versions 
6. • reCAPTCHA v2 relies on visible challenges like checkboxes or puzzles to verify users. At the time of this documenting, we have noticed v2 is more robust for bots hitting forms.
   • reCAPTCHA v3 operates in the background, assigning a risk score to user interactions without requiring explicit action. 
7. Under “Domains” enter the domains for which the key can be used.  Your registration is restricted to the domains you enter here, plus any subdomains. In other words, a registration for example.com also registers subdomain.example.com. A valid domain requires a host and must not include any path, port, query or fragment. For each site, enter the domain name both with and without the "www" part.
8. For Enterprise keys, you may be prompted to enter a Google Cloud Platform Project Name. Do so if prompted. 
9. Read and agree to the terms of service.
10. Receive alerts to your email if your integration is thought to be wrong or an increase of suspicious traffic is suspected.
11. Hit Submit.
12. You will see the "Success" dialogue below, followed by your Site Key and Secret Key. Please take a copy of these keys and save them on your computer for later use.
13. Proceed to the next set of steps to install the keys into Titan CMS.

Install Your Keys Into Your Titan CMS Instance

1. Go to the Admin Dashboard in the Titan Workstation
2. Click on a Content Site -> {site name} -> General
3. Scroll down to Site Configuration.

  

1. Under Captcha Processor, enter:
   NorthwoodsSoftwareDevelopment.Cms.Display.RecaptchaSupport, UISupport
2. Under Captcha Config XML:
   • If you are using Invisible Mode enter:
     <InvisiblePublicKey>{enter SITE KEY here}</InvisiblePublicKey>
     <InvisiblePrivateKey>{enter SECRET KEY here}</InvisiblePrivateKey>
   • If you are using Checkbox Mode enter:
     <PublicKey>{enter SITE KEY here}</PublicKey>
     <PrivateKey>{enter SECRET KEY here}</PrivateKey>

3. For Titan CMS V6 those fields will look like this: 
   

4. Save your changes.

Enable Captcha on Forms

1. Open up a page that has a Forms Editor block you would like to have a Captcha on.
2. Open the Forms Editor block.
3. Check the “Use Captcha” box on the appropriate Form Submission Action type. 
4. Click Done on the Forms Editor dialog box.
5. Publish the page.