Service auth provider

This microservice is used to authenticate services across HMCTS.

Getting Started

Prerequisites

• JDK 8

Building

To build the project execute the following command:

$ ./gradlew build

Configuration

Services to authenticate are retrieved from environment variables in the following format:

MICROSERVICEKEYS_{service}={secret}

where {service} is the name of the service and {secret} is a base32 encoded secret used for generating and validating OTP.

Running

To run the app execute:

$ ./gradlew bootRun

You can also run the app on docker.
To build:

$ docker-compose build

And to run:

$ docker-compose up

Dockerized app comes with preconfigured sample service. See docker-compose.yml for details.

Documentation

API documentation is provided with Swagger.
Json spec is available under standard /v2/api-docs route.

Flow diagram can be found here

Developing

Unit tests

To run all unit tests execute the following command:

$ ./gradlew test

License

This project is licensed under the MIT License - see the LICENSE file for details.