recaptcha-tester

Generate ReCaptcha V2 challenges, to test your captcha-protected backend.

How to use

• In your ReCaptcha settings, add humodz.github.io to the list of allowed domains
• (Optional) if you want to generate lots of ReCaptcha challenges, reduce the ReCaptcha difficulty to make validation faster.
• Go to https://humodz.github.io/recaptcha-tester/, fill the text box with your Site Key (NOT your secret key), and press Create ReCaptcha
• After you solve the ReCaptcha, the returned challenge string will appear in Challenge result
• To generate again, click Reset ReCaptcha

How do I validate a ReCaptcha challenge?

Node.js sample, using the recaptcha-verify library:

const Recaptcha = require('recaptcha-verify');

function validateRecaptcha(challengeResult) {
  const recaptcha = new Recaptcha({
    secret: 'the secret key from the ReCaptcha admin console',
    verbose: false,
  });

  return new Promise((resolve, reject) => {
    recaptcha.checkResponse(challenge, (error, response) => {
        // Couldn't verify (maybe a network error?)
        if (error) {
            return reject(error);
        }

        // Success is a boolean, true = valid challenge, false = invalid challenge
        return resolve(response.success);
    });
  });
}

// Usage:
const isValid = await validateRecatpcha('03AGdBq25btArIsqz0ES7NLHisR7GiM0On... (the result from recaptcha-tester)');