Admin interface for managing clients and users in the new OAuth2 authorization service hmpps-authorization-server here.
At time of this README update (Jan 2024) authorization and authentication services are handled by the full stack Kotlin app hmpps-auth. This also includes a Kotlin frontend for managing clients.
Due to authorization libraries used by hmpps-auth being deprecated authorization functionality is being extracted to its own service hmpps-authorization-server.
The frontend for managing clients is being extracted to this repo hmpps-authorization.
The easiest way to run the app is to use docker compose to create the service and all dependencies.
docker-compose pull
docker-compose up
The app requires:
- hmpps-auth - for authentication
- redis - session store and token caching
To start the main services excluding the example typescript template app:
docker compose up --scale=app=0
Install dependencies using npm install, ensuring you are using node v22.x and npm v11.x
Note: Using nvm (or fnm), run nvm install --latest-npm within the repository folder to use the correct version of node, and the latest version of npm. This matches the engines config in package.json and the CircleCI build config.
And then, to build the assets and start the app with nodemon:
npm run start:dev
npm run lint
npm run test
For local running, start a test db and wiremock instance by:
docker compose -f docker-compose-test.yml up
Then run the server in test mode by:
npm run start-feature (or npm run start-feature:dev to run with nodemon)
And then either, run tests in headless mode with:
npm run int-test
Or run tests with the cypress UI:
npm run int-test-ui
The following environment variables can be set when running the application:
AUDIT_ENABLED - Default is true - can be set to false to disable audit logging locally. Audit statements are sent to the console.
A changelog for the service is available here
The template project has implemented some scheduled checks to ensure that key dependencies are kept up to date.
If these are not desired in the cloned project, remove references to check_outdated job from .circleci/config.yml