Google reCAPTCHA: How to get user response and validate in the server side?

The cool thing about the new Google Recaptcha is that the validation is now completely encapsulated in the widget. That means, that the widget will take care of asking questions, validating responses all the way till it determines that a user is actually a human, only then you get a g-recaptcha-response value.

But that does not keep your site safe from HTTP client request forgery.

Anyone with HTTP POST knowledge could put random data inside of the g-recaptcha-response form field, and fool your site to make it think that this field was provided by the google widget. So you have to validate this token.

In human speech, it would be like,

  • Your Server: Hey Google, there’s a dude that tells me that he’s not a robot. He says that you already verified that he’s a human, and he told me to give you this token as proof of that.
  • Google: Hmm… let me check this token… yes I remember this dude I gave him this token… yeah he’s made of flesh and bone let him through.
  • Your Server: Hey Google, there’s another dude that tells me that he’s a human. He also gave me a token.
  • Google: Hmm… it’s the same token you gave me last time… I’m pretty sure this guy is trying to fool you. Tell him to get off your site.

Validating the response is really easy. Just make a GET request to

https://www.google.com/recaptcha/api/siteverify?secret=your_secret&response=response_string&remoteip=user_ip_address

And replace the response_string with the value that you earlier got by the g-recaptcha-response field.

You will get a JSON Response with a success field.

More information here:
https://developers.google.com/recaptcha/docs/verify

Edit: It’s actually a POST, as per documentation here.

Leave a Comment