Skip to main content

Check whether a device is correctly configured

Using the setup checker tool to find out whether your device will be able to run Care Identity Authentication.

Use the setup checker tool

You can use this tool to test whether your device is correctly configured to allow the use of smartcards with Care Identity Authentication. The tool is also available from error pages from within the Care Identity Authentication service.


How the tool works

The page will perform a check to detect whether the device's operating system and browser are supported by Care Identity Authentication. The user will be warned if the combination is not supported and will be advised what to do.

Smartcard checker screenshot showing the OS not working

Local IT support teams should advise the user how to proceed. Options may include using a different device or using a different browser. Consideration should be given to the device configuration the organisation has chosen to adopt.

If the page is accessed via a valid combination of operating system and browser the following page will be displayed:

Smartcard checker screenshot showing valid combination of operating system and browser

Before continuing with the configuration check the user is prompted to confirm that this is the browser they wish to use with Care Identity Authentication (in line with the device configuration that the organisation has chosen to adopt) and that they have already successfully logged in to the Identity Agent by entering their smartcard and pin. If a user can not successfully log in to the Identity Agent the configuration check will give inaccurate results.

Any issues reported by the Identity Agent, as depicted below,  should be diagnosed using the troubleshooting advice in the Identity Agent Administration Guide, found within the Identity Agent Supporting Documentation on the NHS Digital Downloads page.

When the check button is pressed Care Identity Authentication will attempt to connect to the Identity Agent using the mechanisms that are appropriate for the detected operating system and browser. Care Identity Authentication will step through each mechanism in turn until it finds one that succeeds or all the mechanisms have been exhausted.

If a successful mechanism is found then a success report will be displayed as shown in the example below. This indicates that the device is correctly configured for use with Care Identity Authentication.

Smartcard checker screenshot showing success report

However if Care Identity Authentication can not find a mechanism to connect to the Identity Agent then an error report will be displayed.

Smartcard checker screenshot showing error report


Troubleshooting incorrect configurations

If the tool highlights errors with your configuration, you can read guidance on:

You can also get help with troubleshooting common issues.

Last edited: 12 January 2024 10:33 am