CAPTCHA is a program or system intended to distinguish human from machine input, typically used to prevent spam or bad data created by automated bots.
The software uses the Google reCAPTCHA service as the standard CAPTCHA functionality for our online applications. reCAPTCHA is a free service that protects your web form (and corresponding CRM data) from spam and abuse. It uses a risk analysis engine and adaptive CAPTCHAs to keep automated software from engaging in abusive activities on your site. It does this while letting your valid users pass through.
For more information on the Google reCAPTCHA service, as well as more detailed instructions on implementation, see https://www.google.com/recaptcha/intro/index.html.
The following applications currently support reCAPTCHA v2:
- Customer Opportunity Web Form
- Registration
- Exhibitor Service Center
The following applications currently support reCAPTCHA v3:
- Online Space Booking (online payment process only)
- E-Payment
To enable reCAPTCHA, you need to:
- Create a Google Account
- Connect the reCAPTCHA Site to the Database
- Enable reCAPTCHA in Application Configurations
Create a Google Account
ReCAPTCHA is a Google product so you need a Google account to obtain the necessary information/credentials to set up ReCAPTCHA. You can use a personal Google account, but using a business account is recommended.
- Browse to https://www.google.com/recaptcha.
- In the Label field, enter a label for the site .
- Select the reCAPTCHA version for the reCAPTCHA type. See the list above for versions supported.
- If you select reCAPTCHA v2, select the "I'm not a robot" Checkbox option.
- In the Domains field, enter the applicable domains. This is the web server/domain name used for public-facing applications: when you copy the link for the application, the portion of the URL up to the .com or .net.
- Review the Terms of Service. Check the check box to agree.
- Click Submit.
- Click Register. A Site Key and Secret Key display. These keys are used later in the configuration within the database.
Connect the reCAPTCHA Site to the Database
- Log into the database.
- Click the Integration Security Configuration link from the Main Menu. The Integration Configurations page opens.
- Click the A dd reCAPTCHA v2 Configuration button or click the arrow next to the button and select Add reCAPTCHA v3 Configuration. The Add Integration Configuration window opens.
- Enter the following information:
- Description - Name of the reCAPTCHA configuration.
- Default - If checked, the configuration is used as the default configuration when reCAPTCHA is enabled for a public-facing configuration. Only used with reCAPTCHA v2 configurations.
- Public Key - Paste the public key from step 7 in the previous section.
- Secret - Paste the secret key from step 7 in the previous section.
- Click OK.
Enable reCAPTCHA in Application Configurations
Customer Opportunity Web Form
- From the Main Menu, search for and select Customer Opportunity Web Form. The Customer Opportunity Web Form Configuration page opens.
- Select the configuration to edit.
- Right-click and select Edit. The Edit Customer Opportunity Web Form Configuration window opens.
- Expand the More Settings section.
- Check Enable Captcha. The configuration marked as default in step 4 of the Connect the reCAPTCHA Site to the Database section is used.
- Click OK.
Registration
- In the Global Navigation Bar, click Events. The Events page opens.
- Select the event with the registration you need to add reCAPTCHA.
- Right-click and select Tools -> Registration Setup. The Registration Setup window opens.
- Select the Registration Form Setup tab.
- Expand the Appearance section.
- Click the Edit Form Template link next to the Form Template drop-down. The Form Template window opens.
- Click the Edit Component link in the Sign-In Group. The Edit Sign In Form Section window opens.
- Note the name of the configuration selected in the Sign-In Configuration drop-down.
- Open the drop-down.
- Click the All hyperlink. The Logon Configurations page opens.
- Select the sign-in configuration from step 8.
- Right-click and select Edit. The Edit Logon Configuration window opens.
- Check the Enable Captcha check box in the Details tab. The configuration marked as default in step 4 of the Connect the reCAPTCHA Site to the Database section is used.
- Click OK.
Exhibitor Service Center
- From the Main Menu, search for and select Exhibitor Service Center Configurations. The Exhibitor Service Center Configurations page opens.
- Select the configuration to edit.
- Right-click and select Edit. The Edit Exhibitor Serviced Center Configuration window opens.
- Check Enable reCAPTCHA. The configuration marked as default in step 4 of the Enable reCAPTCHA in Application Configurations section is used. You may need to add this field to your screen layout.
- Click OK.
Online Space Booking
- From the Main Menu, search for and select Online Space Booking Configurations. The Online Space Booking Configurations page opens.
- Select the configuration to edit.
- Right-click and select Edit. The Edit Online Space Booking Configuration window opens.
- Select the reCAPTCHA configuration to use from the ReCAPTCHA configuration drop-down. You may need to add this field to your screen layout.
- Click OK.
E-Payment
- From the Main Menu, search for and select E-Payment Configurations. The E-Payment Configurations page opens.
- Select the configuration to edit.
- Right-click and select Edit. The Edit E-Payment Configuration window opens.
- Select the reCAPTCHA configuration to use from the ReCAPTCHA Configuration drop-down. You may need to add this field to your screen layout if you cannot find it.
- Click OK.
Comments
3 comments
Can someone confirm the expected behavior of the new ESC reCaptcha in 20.94L? Should it be possible to not complete the reCaptcha and still submit the order for payment? I was expecting it to work similar to the terms and conditions where the user would need to respond before the submit button was enabled. However, I am not particularly familiar with reCaptcha so perhaps the fact that it is optional is expected? Thank you for providing clarification regarding how this should be working.
0 upvotes
Hi Rebecca,
If you have reCaptcha configured and are able to submit an order without having to check the box, then you will need to submit a ticket and we can have Development correct the issue. I tested this recently and it was working correctly, so if it is broken now, we will want to get it fixed as quickly as possible.
Thanks!
Matt
0 upvotes
Thanks Matt. I set up a Customer Opportunity Web Form and also a v20 Registration in our Development environment. Both of these worked correctly with completion of the reCaptcha being required before being able to submit the form. The v20 Registration reCaptcha completion requirement error message was very clear, but the COWF error was blank. It would be great if the same messaging was used on all web forms that allow reCaptcha to be enabled. I will submit a ticket for the ESC reCaptcha issue.
0 upvotes
Please sign in to leave a comment.