Home

Awesome

visualCaptcha-java-rest Build Status Coverage Status

This is a demo/sample standalone app that uses Spring Boot and the visualCaptcha AngularJS bower package as a proof-of-concept for how to integrate with REST Services based on Spring / Java.

It's forked out of bdotzour's visualCaptcha-java project (Plain Java Servlet backend for visualCaptcha) using Spring RestController as opposed to Servlets.

Runs as a standalone application with Spring Boot so all you need to do is run mvn spring-boot:run and point your browser to http://localhost:8080. Most recent version also adds docker support.

Homepage

Installation

git clone https://github.com/tillkuhn/visualCaptcha-java-rest.git
mvn verify

Run tests

mvn test

Run application using maven

mvn spring-boot:run

Run application using docker

Note: Docker support is still experimental

docker build -t visual_captcha_java_rest .
docker run -d -p 8080:8080 visual_captcha_java_rest

Todos

Attention

Work is still in progress and not yet finished, but feel free to contribute!

API

Copied from https://github.com/emotionLoop/visualCaptcha-PHP/blob/master/README.md

visualCaptcha, since 5.0, uses an API for increased security and to become back-end-agnostic (that's why you can easily plug-in a Vanilla JS, AngularJS, or jQuery front-end without changing anything).

It expects the following routes to exist, which we've put in this sample, using Slim (just to make it easier).

You are expected to have these routes in your implementation, but you can change them in visualCaptcha's front-end config.

GET /start/:howmany

This route will be the first route called by the front-end, which will generate and store session data.

Parameters:

GET /image/:index

This route will be called for each image, to get it and show it, by index.

Parameters:

GET /audio(/:type)

This route will be called for the audio file, to get it and play it, either the mp3 or ogg file.

Parameters:

POST /try

This is just a sample route, where we post the form to, and where the visualCaptcha validation takes place.

License

Check the LICENSE file.

Links