From 4a18cde90ff01ff62a36e782e68e0d2be42d7ab8 Mon Sep 17 00:00:00 2001 From: Anna-Sutton Date: Mon, 24 Aug 2026 12:21:57 +0100 Subject: [PATCH 01/10] Logging in updates related to Keycloak Updated login instructions for NHS Record a vaccination, including details on using Okta and pharmacy IT systems. --- app/logging-in.md | 33 ++++++++++++++++++++++++++++----- 1 file changed, 28 insertions(+), 5 deletions(-) diff --git a/app/logging-in.md b/app/logging-in.md index ad42dd1..400c673 100644 --- a/app/logging-in.md +++ b/app/logging-in.md @@ -9,11 +9,15 @@ order: 2 {% include 'guide-contents.njk' %} -To log in to the service, go to [NHS Record a vaccination](https://www.ravs.england.nhs.uk). +To access the service, go to [NHS Record a vaccination](https://www.ravs.england.nhs.uk) and select **Log in**. -## Users who already have an Okta account +Then choose how you want to log in. All users can log in securely with Okta. Pharmacy users can also log in with their pharmacy IT system if it is listed on the log in page. -Record a vaccination (RAVS), like some other NHS services, uses Okta to sign users in securely. +## Logging in with Okta + +### Users who already have an Okta account + +Several NHS services use Okta to sign in users securely, so you may already have an Okta account. If you already have an Okta account, you will get a welcome email telling you how to log in to RAVS using your Okta username and password. @@ -21,9 +25,9 @@ Your Okta username will be the email address used to sign up to RAVS. If you've If that does not work, it may be your Okta account has been suspended because you've not used it for 6 months. In that case, [contact our support team](https://www.support.digitalservices.nhs.uk/csm?id=sc_cat_item&sys_id=7406446b9779f290dd80f2df9153af58) and ask them to reset your password. -## Users who do not have an Okta account +### Users who are new to Okta -If you do not have an Okta account, we will create one for you at the same time as we create your RAVS account. +If you do not already have an Okta account, we will create one for you at the same time as we create your RAVS account. You will get 2 emails: one from Okta and another from Record a vaccination. @@ -35,6 +39,25 @@ Once you’ve activated your Okta account, you will be able to log in to RAVS wi If your Okta link has expired, [contact our support team](https://www.support.digitalservices.nhs.uk/csm?id=sc_cat_item&sys_id=7406446b9779f290dd80f2df9153af58). +## Logging in via an approved pharmacy IT system + +Pharmacy users can log in to RAVS via their pharmacy IT system, if it has been approved for accessing RAVS. Approved pharmacy IT systems are listed below the Okta option on the Log in page. + +If you are already signed into your pharmacy IT system and select it on the RAVS log in page, you will go directly to RAVS without having to enter a username or password. + +You may also have a direct link to RAVS from your pharmacy IT system interface. + +If the email addresses used for your RAVS account and the one used for your pharmacy IT system are different, you will not be able to sign in to RAVS via your pharmacy IT system. However, you can still sign in to RAVS with Okta, as long as you enter the email address linked to your RAVS account. + +### How to change the email address linked to your RAVS account + +If you want to change the email address that is linked to your RAVS account so that it matches your credentials for your pharmacy IT system, a lead administrator in RAVS can: + +* deactivate your RAVS account +* invite you to RAVS again, with the email you use to access the pharmacy IT system +* [contact our support team](https://www.support.digitalservices.nhs.uk/csm?id=sc_cat_item&sys_id=7406446b9779f290dd80f2df9153af58) if there are any problems + + ## Problems logging in ### Deactivated account From cd7b6b7cd6e8836733febc8a156e9d943537b783 Mon Sep 17 00:00:00 2001 From: Anna-Sutton Date: Mon, 24 Aug 2026 13:24:26 +0100 Subject: [PATCH 02/10] Simplify Okta login instructions Removed redundant text about account suspension from the login guide. --- app/logging-in.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/logging-in.md b/app/logging-in.md index 400c673..9cfbf93 100644 --- a/app/logging-in.md +++ b/app/logging-in.md @@ -23,7 +23,7 @@ If you already have an Okta account, you will get a welcome email telling you ho Your Okta username will be the email address used to sign up to RAVS. If you've forgotten your password, you'll have the option to reset it. -If that does not work, it may be your Okta account has been suspended because you've not used it for 6 months. In that case, [contact our support team](https://www.support.digitalservices.nhs.uk/csm?id=sc_cat_item&sys_id=7406446b9779f290dd80f2df9153af58) and ask them to reset your password. +If that does not work, [contact our support team](https://www.support.digitalservices.nhs.uk/csm?id=sc_cat_item&sys_id=7406446b9779f290dd80f2df9153af58) and ask them to reset your password. ### Users who are new to Okta From 825c71ec483091ac82076128f83731a93d1b6fd1 Mon Sep 17 00:00:00 2001 From: Anna-Sutton Date: Mon, 24 Aug 2026 13:26:17 +0100 Subject: [PATCH 03/10] Format Okta account activation link in markdown --- app/logging-in.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/logging-in.md b/app/logging-in.md index 9cfbf93..bbd7099 100644 --- a/app/logging-in.md +++ b/app/logging-in.md @@ -31,7 +31,7 @@ If you do not already have an Okta account, we will create one for you at the sa You will get 2 emails: one from Okta and another from Record a vaccination. -The email from Okta includes an ‘Activate Okta Account’ link, which expires after 7 days. +The email from Okta includes an **Activate Okta Account** link, which expires after 7 days. If you cannot find the email from Okta, check your spam or junk. From d4f377fe2e94c2f4a89feb86304c2b378cd330e0 Mon Sep 17 00:00:00 2001 From: Anna-Sutton Date: Mon, 24 Aug 2026 13:27:29 +0100 Subject: [PATCH 04/10] Correct capitalization in login instructions --- app/logging-in.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/logging-in.md b/app/logging-in.md index bbd7099..7def51a 100644 --- a/app/logging-in.md +++ b/app/logging-in.md @@ -11,7 +11,7 @@ order: 2 To access the service, go to [NHS Record a vaccination](https://www.ravs.england.nhs.uk) and select **Log in**. -Then choose how you want to log in. All users can log in securely with Okta. Pharmacy users can also log in with their pharmacy IT system if it is listed on the log in page. +Then choose how you want to log in. All users can log in securely with Okta. Pharmacy users can also log in with their pharmacy IT system if it is listed on the Log in page. ## Logging in with Okta From 8e83bbf75ffd2c0bb9bda2517eb725d15a9fe87a Mon Sep 17 00:00:00 2001 From: Anna-Sutton Date: Mon, 24 Aug 2026 13:30:17 +0100 Subject: [PATCH 05/10] Correct capitalization in logging-in documentation --- app/logging-in.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/logging-in.md b/app/logging-in.md index 7def51a..5b25bd4 100644 --- a/app/logging-in.md +++ b/app/logging-in.md @@ -43,7 +43,7 @@ If your Okta link has expired, [contact our support team](https://www.support.di Pharmacy users can log in to RAVS via their pharmacy IT system, if it has been approved for accessing RAVS. Approved pharmacy IT systems are listed below the Okta option on the Log in page. -If you are already signed into your pharmacy IT system and select it on the RAVS log in page, you will go directly to RAVS without having to enter a username or password. +If you are already signed into your pharmacy IT system and select it on the RAVS Log in page, you will go directly to RAVS without having to enter a username or password. You may also have a direct link to RAVS from your pharmacy IT system interface. From 5a112bd366fd89438a3f9fe997bfd75bfdae122d Mon Sep 17 00:00:00 2001 From: Anna-Sutton Date: Mon, 24 Aug 2026 13:31:02 +0100 Subject: [PATCH 06/10] Fix formatting issue in logging-in.md --- app/logging-in.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/logging-in.md b/app/logging-in.md index 5b25bd4..13e454d 100644 --- a/app/logging-in.md +++ b/app/logging-in.md @@ -47,7 +47,7 @@ If you are already signed into your pharmacy IT system and select it on the RAVS You may also have a direct link to RAVS from your pharmacy IT system interface. -If the email addresses used for your RAVS account and the one used for your pharmacy IT system are different, you will not be able to sign in to RAVS via your pharmacy IT system. However, you can still sign in to RAVS with Okta, as long as you enter the email address linked to your RAVS account. +If the email address used for your RAVS account and the one used for your pharmacy IT system are different, you will not be able to sign in to RAVS via your pharmacy IT system. However, you can still sign in to RAVS with Okta, as long as you enter the email address linked to your RAVS account. ### How to change the email address linked to your RAVS account From d2a7682e441ec7ce5446bdf639278a4b21180577 Mon Sep 17 00:00:00 2001 From: Anna-Sutton Date: Mon, 24 Aug 2026 15:16:21 +0100 Subject: [PATCH 07/10] Enhance login instructions formatting Formatted login options for clarity. --- app/logging-in.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/app/logging-in.md b/app/logging-in.md index 13e454d..ab74bc9 100644 --- a/app/logging-in.md +++ b/app/logging-in.md @@ -11,7 +11,10 @@ order: 2 To access the service, go to [NHS Record a vaccination](https://www.ravs.england.nhs.uk) and select **Log in**. -Then choose how you want to log in. All users can log in securely with Okta. Pharmacy users can also log in with their pharmacy IT system if it is listed on the Log in page. +Then choose how you want to log in: + +* all users can log in securely with Okta +* pharmacy users can also log in with their pharmacy IT system if it is listed on the Log in page ## Logging in with Okta From ded6244f8f15503e2a7a6cbdf0752703c66ad7c4 Mon Sep 17 00:00:00 2001 From: Anna-Sutton Date: Mon, 24 Aug 2026 15:19:03 +0100 Subject: [PATCH 08/10] Fix punctuation in logging-in.md --- app/logging-in.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/logging-in.md b/app/logging-in.md index ab74bc9..ff85bf0 100644 --- a/app/logging-in.md +++ b/app/logging-in.md @@ -14,7 +14,7 @@ To access the service, go to [NHS Record a vaccination](https://www.ravs.england Then choose how you want to log in: * all users can log in securely with Okta -* pharmacy users can also log in with their pharmacy IT system if it is listed on the Log in page +* pharmacy users can also log in with their pharmacy IT system, if it is listed on the Log in page ## Logging in with Okta From 79356150d51f469089560ca506fc66c6d0ec39b7 Mon Sep 17 00:00:00 2001 From: Anna-Sutton Date: Tue, 25 Aug 2026 11:46:32 +0100 Subject: [PATCH 09/10] Improve clarity in logging-in instructions Rephrase sentences for clarity and consistency in the logging-in documentation. --- app/logging-in.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/app/logging-in.md b/app/logging-in.md index ff85bf0..9618161 100644 --- a/app/logging-in.md +++ b/app/logging-in.md @@ -26,7 +26,7 @@ If you already have an Okta account, you will get a welcome email telling you ho Your Okta username will be the email address used to sign up to RAVS. If you've forgotten your password, you'll have the option to reset it. -If that does not work, [contact our support team](https://www.support.digitalservices.nhs.uk/csm?id=sc_cat_item&sys_id=7406446b9779f290dd80f2df9153af58) and ask them to reset your password. +If that does not work, [contact our support team](https://www.support.digitalservices.nhs.uk/csm?id=sc_cat_item&sys_id=7406446b9779f290dd80f2df9153af58). ### Users who are new to Okta @@ -40,7 +40,7 @@ If you cannot find the email from Okta, check your spam or junk. Once you’ve activated your Okta account, you will be able to log in to RAVS with your Okta credentials. -If your Okta link has expired, [contact our support team](https://www.support.digitalservices.nhs.uk/csm?id=sc_cat_item&sys_id=7406446b9779f290dd80f2df9153af58). +If your Okta link has expired or you have any other issues, [contact our support team](https://www.support.digitalservices.nhs.uk/csm?id=sc_cat_item&sys_id=7406446b9779f290dd80f2df9153af58). ## Logging in via an approved pharmacy IT system @@ -48,7 +48,7 @@ Pharmacy users can log in to RAVS via their pharmacy IT system, if it has been a If you are already signed into your pharmacy IT system and select it on the RAVS Log in page, you will go directly to RAVS without having to enter a username or password. -You may also have a direct link to RAVS from your pharmacy IT system interface. +You should also have a direct link to RAVS from your pharmacy IT system interface. If the email address used for your RAVS account and the one used for your pharmacy IT system are different, you will not be able to sign in to RAVS via your pharmacy IT system. However, you can still sign in to RAVS with Okta, as long as you enter the email address linked to your RAVS account. @@ -58,7 +58,8 @@ If you want to change the email address that is linked to your RAVS account so t * deactivate your RAVS account * invite you to RAVS again, with the email you use to access the pharmacy IT system -* [contact our support team](https://www.support.digitalservices.nhs.uk/csm?id=sc_cat_item&sys_id=7406446b9779f290dd80f2df9153af58) if there are any problems + +If you have any problems changing your RAVS account, [contact our support team](https://www.support.digitalservices.nhs.uk/csm?id=sc_cat_item&sys_id=7406446b9779f290dd80f2df9153af58). ## Problems logging in From 8caccafb94f77e71d84a796c3390205aa4867fba Mon Sep 17 00:00:00 2001 From: Anna-Sutton Date: Tue, 25 Aug 2026 11:51:27 +0100 Subject: [PATCH 10/10] Minor update --- app/logging-in.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/app/logging-in.md b/app/logging-in.md index 9618161..2a5c2eb 100644 --- a/app/logging-in.md +++ b/app/logging-in.md @@ -24,9 +24,9 @@ Several NHS services use Okta to sign in users securely, so you may already have If you already have an Okta account, you will get a welcome email telling you how to log in to RAVS using your Okta username and password. -Your Okta username will be the email address used to sign up to RAVS. If you've forgotten your password, you'll have the option to reset it. +Your Okta username will be the email address used to sign up to RAVS. -If that does not work, [contact our support team](https://www.support.digitalservices.nhs.uk/csm?id=sc_cat_item&sys_id=7406446b9779f290dd80f2df9153af58). +If you've forgotten your password, you'll have the option to reset it. If that does not work, [contact our support team](https://www.support.digitalservices.nhs.uk/csm?id=sc_cat_item&sys_id=7406446b9779f290dd80f2df9153af58). ### Users who are new to Okta