Register and manage your service
Registering should take 5 minutes to complete. To register your service to use GOV.UK One Login, you’ll need:
- a government email address
- a mobile phone
If you do not have a government email address or mobile phone, you should find a civil servant in your team who can register the service on your behalf.
Go to the Get started with GOV.UK One Login page and select Create admin tool account.
Follow the onscreen instructions to enter your email address and confirm your email security code.
Enter your mobile number and confirm your mobile security code.
Fill in your client configuration details using this list:
- Client ID
- Client name (Service name)
- Backchannel logout URI
- Claims
- Contacts
- ID token signing algorithm
- Landing page URL
- Post-logout URLs
- Public key
- Redirect URLs
- Scopes
- Sector identifier URI
- Token authentication method
Configuring your client ID
You get a unique client ID when you register your service. You’ll need this client ID to integrate each of your services with GOV.UK One Login.
You should configure a client ID for each environment you have. For example, if you have staging, user acceptance testing, integration and production you should configure 4 client IDs. There’s further guidance on creating a configuration for each service you’re integrating.
When you create a client configuration, it is tied to the GOV.UK admin tool account of the user who created it. You cannot change the configuration if the owner is not available.
It is currently not possible to assign or transfer the ownership of the client configuration to another GOV.UK admin tool user’s account. In this situation, a different admin tool user should create an additional client configuration and copy any required settings from the original configuration.
The new configuration will have a new client ID. You’ll need to update your services to the new client ID.