Guide/implementingCaptcha: Difference between revisions

Latest revision as of 21:26, 5 March 2025

Implementing Captcha

This captcha system is put in place to force new users at the kiosk to have to use a captcha before sending a account creation request. This is a resolution to some events being spammed with account creation requests and thereby getting their email sender reputation damaged.

This is available as of version 12.0.0 and requires no "configuration" other than to add your keys to CM.

How to Add your keys to CM

Log into Convention master
Click on the "Admin event" >> "System Settings" menu.
Locate the setting called "Captcha Keys", set the pulldown to "hcaptcha" and then copy and paste your site key and Site Secret.

That is all that needs to happen, this will enable captcha at all the kiosks and other places needed.

How to get hCaptcha keys from their website

Sign Up

Go to https://www.hcaptcha.com/ Sign up and create a account that is the right size for your organization (including free level for many) Log into your account

Create a new 'Site'

Click New
Fill Out Fields

Get your Site Key

Select the site
Copy the Site Key
Paste the Site Key

Get your Site Secret

Site Secret

Click your Profile then Settings
Click the Generate Secret Button
Click Confirm Button
Copy the Secret (Perhaps save this in a key vault)
Paste the Secrety

Your System should now be configured

Visit any kiosk entrypoint url and try to enter your email address. This will be turned on globally.

@@ Line 13: / Line 13: @@
 == How to get hCaptcha keys from their website ==
-*Go to https://www.hcaptcha.com/
+===Sign Up===
-*Sign up and create a account that is the right size for your organization (including free level for many)
+Go to https://www.hcaptcha.com/ Sign up and create a account that is the right size for your organization (including free level for many)
-*Log into your account
+Log into your account
-*[[File:HCaptcha_New_button.png|300px|thumb|left|Click 'New Site']]
+====Create a new 'Site'====
-*[[File:HCaptcha_New_button.png|300px|thumb|left|Fill out the fields]]
+*Click New <br>[[File:HCaptcha_New_button.png|800px]]
-*Click Save
+*Fill Out Fields<br>[[File:HCaptcha_Fields_Example.png|800px]]
-*Now you will be brought back to your list of sites
+====Get your Site Key ====
-*Click into the server
+*Select the site<br>[[File:HCaptchaSelectSite.png|800px]]
-*Copy the site key [[File:Hcaptcha_SiteKey.png|300px|thumb|left|Caption]]
+*Copy the Site Key<br>[[File:Hcaptcha_SiteKey.png|800px]]
-*Paste the site key into the CM Configuration
+*Paste the Site Key<br>[[File:CM-EnterCaptchaSiteKey.png|800px]]
-*Site Secret
+====Get your Site Secret ====
-**In Hcaptcha you can go to profile->settings to be able to roate to a new secret.  So if you didn't capture the secret the first time it showed you'll have to roate the secret for all your sites.
+Site Secret
+*Click your Profile then Settings<br>[[File:HCaptcha ProfileSettings.png|300px]]
+*Click the Generate Secret Button<br>[[File:Hcaptcha GenerateSecret.png|800px]]
+*Click Confirm Button<br>[[File:HcaptchaConfirm.png|300px]]
+*Copy the Secret (Perhaps save this in a key vault)<br>[[File:HcaptchaCopySecret.png|300px]]
+*Paste the Secrety<br>[[File:CM-EnterCaptchaSecret.png|800px]]
+===Your System should now be configured===
+Visit any kiosk entrypoint url and try to enter your email address.  This will be turned on globally. <br>
+[[File:CM-HcaptchaConfigured.png|400px]]