Provides sign in / sign out and attribute storage functionality to
other GOV.UK applications.
In production, this app currently uses the Digital Identity
In development, this app uses a stub OIDC provider which signs you in
as the first user in the database.
This app does not serve any user-facing pages. To see the app working, you
must run an app which uses it, such as frontend.
After starting Frontend, you should be able to access the account
This is a Ruby on Rails app, and should follow our Rails app
Use GOV.UK Docker to run any of the following commands.
This repository follows the standards for testing described in the
GOV.UK RFC on continuous deployment:
- code coverage in excess of 95%
- API contract tests (“pact tests”) between the Account API and its
rake task runs all the tests and records code coverage:
bundle exec rake
Changing the Pact tests
If you make changes to the API, you must update the Pact tests.
A Pact test has two parts:
The consumer test (defined in gds-api-adapters), which:
- specifies the state it expects the provider to be in
- gives a request to make
- and a response to match against
The provider configuration (defined in this repo), which
defines all of the provider states referenced by the consumer
See the GOV.UK Developer Docs for how to update a Pact test.