FORGEBOX Enterprise 🚀 - Take your ColdFusion (CFML) Development to Modern Times! Learn More...

ColdBox ReCaptcha v2.0

v1.0.0+0002 Public
ColdBox ReCAPTCHA v2.0 Module
This module contains helpers for using Google's ReCAPTCHA API.

reCAPTCHA is a free service that protects your site from spam and abuse. It uses advanced risk analysis techniques to tell humans and bots apart. With the 2.0 API, a significant number of your valid human users will pass the reCAPTCHA challenge without having to solve a CAPTCHA. reCAPTCHA comes in the form of a widget that you can easily add to your blog, forum, registration form, etc.

Apache License, Version 2.0.

- Railo 4+
- ColdFusion 9+
- ColdBox 4+


Just drop into your `modules` folder or use the box-cli to install

`box install recaptcha2`

Get an API key pair at and add the following settings to your `Coldbox.cfc` under a `recaptcha` structure:

// recaptcha settings
recaptcha = {
    private_key = "Secret key",
    public_key = "Site key",

In any form you wish to add the reCaptcha widget use `#renderview(view="widget",module="recaptcha")#`.

In your handler for the post of the form, or in a model object you can then use the included Validator. Here is an example of using it in a model object:

    this.constraints = {
         "body" : { required:true }
        ,"recaptcha" : { validator:"id:[email protected]" }

In the above example, your handler would just need to set the recaptcha property on the model object to the `g-recaptcha-response` value that is part of the form payload.

There also is a `[email protected]` Wirebox mapping you can use to validate manually if you prefer to not use the `cbvalidation` integration. In your handler:

var recaptchaOK = getInstance("[email protected]").isValid( rc["g-recaptcha-response"] );

if (!recaptchaOK) {
    echo("Prove you have a soul!");

Here are all the versions for this package. Please note that you can leverage CommandBox package versioning to install any package you like. Please refer to our managing package version guide for more information.

Version Created Last Update Published By Stable Actions
1.0.0+0002 Oct 27 2016 01:22 PM Oct 27 2016 01:22 PM
Version History
1.0.0+0001 May 11 2016 03:28 PM Jun 09 2016 05:04 PM


No collaborators yet.
  • May 11 2016 03:28 PM
  • Oct 27 2016 01:22 PM
  • 2146
  • 983
  • 3706