reCAPTCHA-V2-jee7

Java Bindings for reCAPTCHA V2. See Verifying the user's response | reCAPTCHA | Google Developers. Basing on JEE7's JAX-RS 2.0 Client API and JSON P 1.0. Same API as triologygmbh/reCAPTCHA-V2-java

Prerequisites

• Get a public and a secret API key from Google.
• Set up your client side to display the reCAPTCHA V2 widget, containing the public API key, as described here.
• Send the response token to your server.

Usage

Get it via JitPack, for example using maven.

Add the following maven repository to your POM.xml

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

Then add the actual dependency

<dependency>
    <groupId>com.github.schnatterer</groupId>
    <artifactId>reCAPTCHA-V2-jee7</artifactId>
    <version>1.0.0</version>
</dependency>

On your server:

• Create a new instance of ReCaptcha,
• passing the reCAPTCHA private API key (the one beloging to the public key used in your client code to generate the response).
• Then validate the token sent by the client, you'll receive a boolean response.

It's as simple as that.

String response = "03AEHxwuyM-dll21GpJuJ65tGT6SVEvQEO3tvLfyxbbgBCaSdOLRQBT4Py-jMjGxplhE1wo7nn7Y6zRNgqUufFTnYDdqzYDTupfZkgx0LppSC3_eBKkODMopBaSBeeGMlt_wzkqWes5tAo34t2LmS0fGdwsE_feGJ_NsrB29NsUNAO78FGyL5DpL7f8K5dnh9Q_6QiN5Qg0MapUEu2w30r-GOI7MfVDMF7qk7wDwbM8uZmoIMn8AenNVKsZY0yEP6ghGVTBhtFvBVaD6jiHXeKztnAX1oLAvPa0jh9sJe20Dwk4jtmuemWKLI";
String secret = "sMSd8L8jlFrKGHdtbXePOphPfhJO_oA4A0sfvw0i";

new ReCaptcha(secret).isValid(response);

Error Handling

In case there are not technical problems Recaptcha.isValid() always returns a boolean. Otherwise a ReCaptchaException is thrown.
If you need insight into the underlying HTTP traffic you best set the log level of all loggers de.triology.recaptchav2java to TRACE using your favorite SLF4J implementation.