Google reCAPTCHA v2 Support

CAPTCHA in Dada Mail

Dada Mail supports Google reCAPTCHA v2

Setting up Google reCAPTCHA in Dada Mail

Create a Site and Secret Key Pair

Sign up for the Google reCAPTCHA service at,

http://www.google.com/recaptcha/admin

and create a site and secret key pair for the site you have Dada Mail installed at, as outlined here:

https://developers.google.com/recaptcha/docs/start

Make sure you record both the site and secret key somewhere safe - we'll be using them, later.

Configure Dada Mail to use Google ReCAPTCHA

Plugging in the site and secret keys, and telling Dada Mail to use Google reCAPTCHA is done in Dada Mail's global configuration.

The easiest way to work with that is through Dada Mail's included web-based installer, so an install or upgrade would be the perfect time to set all this up.

You can also drop back into the installer to make these configuration changes: https://dadamailproject.com/d/install_dada_mail.pod.html#Making-Additional-Global-Configuration-Changes-using-the-Dada-Mail-Installer

Once in the installer's configure screen, look for Advanced Options.

This is the section where you can setup the plugins/extensions, as well as many of Dada Mail's more advanced features. If you do not see these options, click the button labeled, Show/Hide Advanced Options...

Next, look for a checkbox labeled, Configure CAPTCHA Options. Check the box, and the CAPTCHA options will be revealed.

Dada Mail supports displaying and verifying a CAPTCHA on the initial subscripion form. Check the box labeled, Add CAPTCHA on all subscription forms to enable this feature.

Plug in the site key and secret key in the textboxes labeled, reCAPTCHA Site key: and, reCAPTCHA Secret key:

Test to make sure if everything works, by clicking the button labeled, Test CAPTCHA Configuration.... If everything works correctly, you'll be shown a working reCAPTCHA v2 widget

Required Perl CPAN Module?

Dada Mail's Google reCAPTCHA support requires the Google::reCAPTCHA Perl module, which you can install from CPAN. See, https://dadamailproject.com/d/FAQ-installing_CPAN_Perl_modules.pod.html

Using CAPTCHA in Dada Mail

CAPTCHA may be used for:

Subscription Confirmations

Enabling

In the list control panel, navigate to: Mailing List - Options, under Subscriptions, check the option labeled, Enable CAPTCHA

"Forward a Friend"

CAPTCHA protection in the "Forward to a Friend" Form is highly suggested, as this form is easy to spoof.

In the list control panel, navigate to: Archives - Options.

Check the option labeled, Enable CAPTCHA on the, "Forward to a Friend" Form

Profile Registrations

CAPTCHA protection is available for Dada Mail Profile Registrations.

Enabling

CAPTCHA for Profile Registrations is enabled by default. If you'd like to disable CAPTCHA, you can do so in the config variable, $PROFILE_OPTIONS

reCAPTCHA Mailhide

If you're using the reCAPTCHA service, you may also take advantage of reCAPTCHA Mailhide. In Dada Mail, this is used to protect individual email addresses in mailing list archives. Before an email address can be viewed, a CAPTCHA has to be solved.

Configuration

Mailhide can also be configued in the Dada Mail Installer.

If not already shown, click the button, Show/Hide Advanced Options..., then check the option, Configure CAPTCHA Options. Additional CAPTCHA settings will then be revealed.

Under, reCAPTCHA Mailhide Settings, enter in your reCAPTCHA Mailhide Public Key and reCAPTCHA Mailhide Private Key, much like you did for your CAPTCHA settings, above. You may create those keys here:

https://www.google.com/recaptcha/admin#mailhide/apikey

Enabling

In your list control panel, go to: Manage Archives - Advanced Archive Options, under, Email Address Protection select, reCAPTCHA MailHide.

Requirements

You may need to separately install the Captcha::reCAPTCHA::Mailhide CPAN Perl module, in order to gain reCAPTCHA Mailhide support.


Dada Mail Project

Download

Installation

Support