imnar v1.1.1

IMNAR

🙋A module for verifying ReCaptcha responses

Options

• secret (String) - Google ReCaptcha server secret
• sendIp (Boolean) - Only available for middleware, will send the request.ip value to be verified
• endRequest (Boolean) - Only available for middleware, if the checks fail it will send a 400 response and not continue the middleware chain

Usage

Express / Connect

When using IMAR with Express it needs a bodyParser higher up the middleware chain as it reads the ReCaptcha response from request.body['g-recpatcha-response']

var ReCaptcha = require('imnar');
var bodyParser = require('body-parser');
ReCaptcha({
  secret: 'RECAPTCHA_SECRET_HERE',
  sendIp: false
})

app.use(bodyParser.urlencoded({ extended: false }));
app.use(ReCaptcha.middleware);

Standalone

You can use IMAR without Express by calling .check(response, [ip]) the IP value is optional, this will return a promise.

var ReCaptcha = require('imnar');

ReCaptcha({
  secret: 'RECAPTCHA_SECRET_HERE',
  sendIp: false
})

ReCaptcha.check('g-recaptcha-response').then(function(success){
  console.log('Woohoo! captcha passed');
}, function(error){
  console.log('Uh oh! looks like you\'re a robot');
})