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.
git clone https://github.com/tillkuhn/visualCaptcha-java-rest.git
mvn verify
mvn test
mvn spring-boot:run
Note: Docker support is still experimental
docker build -t visual_captcha_java_rest .
docker run -d -p 8080:8080 visual_captcha_java_rest
- Complete Implementation for Audio
- Dockerize
- Spring Integration tests
Work is still in progress and not yet finished, but feel free to contribute!
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.
This route will be the first route called by the front-end, which will generate and store session data.
Parameters:
howmany
is required, the number of images to generate.
This route will be called for each image, to get it and show it, by index.
Parameters:
index
is required, the index of the image you want to get.
This route will be called for the audio file, to get it and play it, either the mp3 or ogg file.
Parameters:
type
is optional, the audio file format defaults tomp3
, but can also beogg
.
This is just a sample route, where we post the form to, and where the visualCaptcha validation takes place.
Check the LICENSE file.