Skip to content

AP-806 - Update using-integration-for-testing.html.md.erb #448

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ImogenCraigmile wants to merge 3 commits into
base: main
Choose a base branch
from
Open

AP-806 - Update using-integration-for-testing.html.md.erb #448

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
7fa02e0
Update using-integration-for-testing.html.md.erb
ImogenCraigmile Feb 23, 2026
c0817f6
Update using-integration-for-testing.html.md.erb
ImogenCraigmile Mar 9, 2026
340f0ee
Update using-integration-for-testing.html.md.erb
ImogenCraigmile Apr 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 12 additions & 27 deletions source/test-your-integration/using-integration-for-testing.html.md.erb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,13 +34,13 @@ We will not notify you for changes that are internal to the GOV.UK One Login jou
## Before you begin


Before you can test on our integration environment, you must:
Before you can test on our integration environment, you:


* have [registered your service to use GOV.UK One Login][integrate.register-your-service]
* have built an application to work with GOV.UK One Login
* have accessed the [example responses from the GOV.UK One Login API](https://github.com/govuk-one-login/onboarding-examples/tree/main/data)
* have contacted GOV.UK One Login to access the fictional users and their knowledge-based verification (KBV) answers to help you test your journeys
* must have [registered your service to use GOV.UK One Login][integrate.register-your-service]
* must have built an application to work with GOV.UK One Login
* can have accessed the [example responses from the GOV.UK One Login API](https://github.com/govuk-one-login/onboarding-examples/tree/main/data)



## Navigating automated testing
Expand Down Expand Up @@ -72,14 +72,6 @@ When conducting automated testing, the multi-factor authentication may block you
## Conducting end-to-end user testing against the integration environment
### Test successful user journeys


Before you can test successful authentication or identity proving journeys, you need to:


1. Check you can connect to the integration environment.
1. [Contact GOV.UK One Login to access test user data](mailto:govuk-one-login@digital.cabinet-office.gov.uk) – you’ll use this to test your journeys.


#### Test a successful authentication journey


Expand All @@ -89,7 +81,7 @@ You should test if you can authenticate users successfully. This scenario uses a
1. Go to your service start page.
1. Select **Start**.
1. Select **Create a GOV.UK One Login**.
1. Follow the instructions to create an account using the test user data. You should use an email address which you have access to so you can receive the two-factor authentication code – if using Gmail, you can add ‘+1’ onto the end of your email address to create additional accounts, if needed. For example, `janedoe+1234@example.com`. If you are using another email provider, you might not be able to access this feature.

1. Enter the 6-digit security code sent to your email – it will have a subject line similar to ‘Your security code for your GOV.UK One Login’.
1. Create a password.
1. Select how you want to receive your security codes.
Expand All @@ -104,10 +96,11 @@ If your service provides identity proving functionality, you should test if you
1. Go to your service start page.
1. Select **Start**.
1. Select **Create a GOV.UK One Login**.
1. [Contact GOV.UK One Login to access test user data](mailto:govuk-one-login@digital.cabinet-office.gov.uk) – you’ll use this to test your journeys.
1. Follow the instructions to create an account using the test user data. You should use an email address which you have access to so you can receive the two-factor authentication code – if using Gmail, you can add ‘+1’ onto the end of your email address to create additional accounts, if needed. For example, `janedoe+1234@example.com`. If you are using another email provider, you might not be able to access this feature.
1. Enter the 6-digit security code sent to your email – it will have a subject line similar to ‘Your security code for your GOV.UK One Login’.
1. Create a password.
1. Select how you want to receive your security codes.
1. Select how you want to receive your 6-digit security codes.
1. Select **Continue**.
1. Select **Continue** when asked about proving your identity with GOV.UK One Login.
1. Select **Yes**, then **Continue** when asked if you have a photo ID.
Expand All @@ -125,15 +118,7 @@ If your service provides identity proving functionality, you should test if you

### Test unsuccessful user journeys


You should test if your service recognises failed authentication or identity proving journeys. Before you can test these, you need to:


1. Check you can connect to the integration environment.
1. [Contact GOV.UK One Login to access test user data](mailto:govuk-one-login@digital.cabinet-office.gov.uk) – you’ll use this to test your journeys.


To test a failed journey, you need to input incorrect data. For example, inputting an incorrect date of birth, or document number.
To test a failed journey, you need to input incorrect data. For example, an incorrect date of birth, or document number.

#### Test a failed identity proving journey

Expand All @@ -150,10 +135,10 @@ Your test outcome will vary depending on whether you use the return code claim o
1. Go to your service start page.
1. Select **Start**.
1. Select **Create a GOV.UK One Login**.
1. Follow the instructions to create an account using the test user data. You should use an email address which you have access to so you can receive the two-factor authentication code – if using Gmail, you can add ‘+1’ onto the end of your email address to create additional accounts, if needed. For example, `janedoe+1234@example.com`. If you are using another email provider, you might not be able to access this feature.
1. [Contact GOV.UK One Login to access test user data](mailto:govuk-one-login@digital.cabinet-office.gov.uk) – you’ll use this to test your journeys.
1. Enter the 6-digit security code sent to your email – it will have a subject line similar to ‘Your security code for your GOV.UK One Login’.
1. Create a password.
1. Select how you want to receive your security codes, then **Continue**.
1. Select how you want to receive your 6-digit security code, then **Continue**.
1. Select **Continue** when asked about proving your identity with GOV.UK One Login.
1. Select **Yes**, then **Continue** when asked if you have a photo ID.
1. Select **Yes, I am on a computer or tablet**, then **Continue**.
Expand All @@ -178,7 +163,7 @@ For example, submitting an incorrect document number will return an error which
1. Follow the instructions to create an account using the test user data. You should use an email address which you have access to so you can receive the two-factor authentication code – if using Gmail, you can add ‘+1’ onto the end of your email address to create additional accounts, if needed. For example, `janedoe+1234@example.com`. If you are using another email provider, you might not be able to access this feature.
1. Enter the 6-digit security code sent to your email – it will have a subject line similar to ‘Your security code for your GOV.UK One Login’.
1. Create a password.
1. Select how you want to receive your security codes, then **Continue**.
1. Select how you want to receive your 6-digit security code, then **Continue**.
1. Select **Continue** when asked about proving your identity with GOV.UK One Login.
1. Select **Yes**, then **Continue** when asked if you have a photo ID.
1. Select **Yes, I am on a computer or tablet**, then **Continue**.
Expand Down
Loading