folley / JAlgoArena-Auth

JAlgoArena Authentication and Authorization Server

JAlgoArena Auth

JAlgoArena Auth is core service dedicated for authentication and authorization of the JAlgoArena users. It's keeping all data in Xodus DB, and for authorization it's using JWT tokens which are verified on the requests. Initial creation of accounts happens through AJAX requests.

• Introduction
• Components
• Continuous Delivery
• Infrastructure
• [Running Locally] (#running-locally)
• Notes

Introduction

• JAlgoArena Auth allows for creation of account, login in using username and password, authenticating using previously received token or just taking information about users of JAlgoArena.
• On the first run of the service - it creates admin account with admin as username, and password put into logs
• Submissions service talks directly with Auth service to make sure users are authenticated and they have required roles

Components

• JAlgoArena
• JAlgoArena UI
• JAlgoArena Submissions (and Ranking)
• JAlgoArena Eureka Server
• JAlgoArena API Gateway

Continuous Delivery

• initially, developer push his changes to GitHub
• in next stage, GitHub notifies Travis CI about changes
• Travis CI runs whole continuous integration flow, running compilation, tests and generating reports
• coverage report is sent to Codecov
• application is deployed into Heroku machine

Infrastructure

• Heroku (PaaS)
• Xodus (embedded highly scalable database) - http://jetbrains.github.io/xodus/
• Spring Boot, Spring Cloud (Eureka Client)
• TravisCI - https://travis-ci.org/spolnik/JAlgoArena-Auth

Running locally

There are two ways to run it - from sources or from binaries.

• Default port: 9999

Running from binaries

• go to releases page and download last app package (JAlgoArena-Auth-[version_number].zip)
• after unpacking it, go to folder and run ./run.sh (to make it runnable, invoke command chmod +x run.sh)
• you can modify port and Eureka service url in run.sh script, depending on your infrastructure settings. The script itself can be found in here: run.sh

Running from sources

• run git clone https://github.com/spolnik/JAlgoArena-Auth to clone locally the sources
• now, you can build project with command ./gradlew clean bootRepackage which will create runnable jar package with app sources. Next, run java -Dserver.port=9999 -jar build\libs\jalgoarena-auth-*.jar which will start application
• there is second way to run app with gradle. Instead of running above, you can just run ./gradlew clean bootRun

Notes

• Travis Builds