Play2 Built-in Java Cryptographic Example

This example has two different implementation of crypto algorithm,

• Play2 built-in example
• Customization of AES crypto using Java utilities

New Features!

• Play 2.4’s AES encryption now uses initialization vectors to randomize each encryption.
• The Play encryption format has been changed to add support for initialization vectors.

You can also:

• Download and Use the GitHub project for your learning purpose
• Refer Play2 Site for more info: Play2 Crypto

Tech

Play2 Built-in Java Cryptographic Example uses a number of open source projects to work properly:

• Play Framework - Play Framework makes it easy to build web applications with Java & Scala. Play is based on a lightweight, stateless, web-friendly architecture
• [AngularJS] - HTML enhanced for web apps!
• [node.js] - evented I/O for the backend
• [Gulp] - the streaming build system

Installation

This example required the following tools to run

• Play Framework v2.4+ to run.
• SBT vsbt-0.12+ to run.
• Node.js v4+ to run.

Install the dependencies and devDependencies and start the server.

$ mkdir examples
$ cd examples
$ git clone ssh://git@github.com/vinstonpandiyan/scalaplay2aesexample.git
$ cd scalaplay2aesexample
$ sbt run

$ cd examples/app/website
$ npm install -d
$ node app

Configuration

For using the play2 we need to generate the private key. Use and run the following steps to create the private key and copy paste the play2 application.conf file

• Ex: play.crypto.secret="jhc_GPt:=uhJJYjEI00`5RkoB9C6kotmqb3iM9CVE]9jq:3t]>oOK2;MSzxmg?Uy"

$ sbt playGenerateSecret

OR

$ sbt play-generate-secret

For production environments...

$ npm install --production
$ npm run predeploy
$ NODE_ENV=production node app

Development

Use IntelliJ scala editor tool to develop the application, it is sweet and elagant way of development friendly tool.

• Use Git to download the project
• And use Scala Play SBT plugin to run the project

Use the following REST end point to test the AES crypto

• To Encrypt the text using play2 - http://127.0.0.1:9000/app/play/encrypt?text=TEST_TEXT
• To Decrypt the text using play2 - http://127.0.0.1:9000/app/play/decrypt?text=
• To Encrypt the text using custom AES - http://127.0.0.1:9000/app/aes/encrypt?text=TEST_TEXT
• To Decrypt the text using custom AES - http://127.0.0.1:9000/app/aes/decrypt?text=

CURL Example:

$ curl --request GET 'http://127.0.0.1:9000/app/play/encrypt?text=TEST_TEXT'
$ curl --request GET 'http://127.0.0.1:9000/app/play/decrypt?text=<ENCRYPTED _TEXT>'
$ curl --request GET 'http://127.0.0.1:9000/app/aes/encrypt?text=TEST_TEXT'
$ curl --request GET 'http://127.0.0.1:9000/app/aes/decrypt?text=<ENCRYPTED _TEXT>'

Running Test Spec

$ cd scalaplay2aesexample
$ sbt test

Building for source

For production release:

$ sbt build --prod

Docker

Scala Play2 Example is very easy to install and deploy in a Docker container.

By default, the Docker will expose port 80, so change this within the Dockerfile if necessary. When ready, simply use the Dockerfile to build the image.

cd scalaplay2aesexample
docker build -t vinston/scalaplay2aesexample:${package.json.version}

This will create the scalaplay2aesexample image and pull in the necessary dependencies. Be sure to swap out ${package.json.version} with the actual version of scalaplay2aesexample.

Once done, run the Docker image and map the port to whatever you wish on your host. In this example, we simply map port 9000 of the host to port 80 of the Docker (or whatever port was exposed in the Dockerfile):

docker run -d -p 9000:9000 --restart="always" <youruser>/scalaplay2aesexample:${package.json.version}

Verify the deployment by navigating to your server address in your preferred browser.

127.0.0.1:9000