NOTE: Admin rights are required to install or uninstall Identity Agent.
It's very important to follow these steps in this order.
Uninstall any previous versions of Identity Agent
You can do this via Control Panel > Programs and features
Delete these directories (if present)
- C:\Program Files\Gemalto\GAC
- C:\Program Files (x86)\Gemalto\GAC
Delete these files (if present)
- C:\Program Files\java\installed version of jre\lib\ext\TicketAPDLL.dll
- C:\Program Files (x86)\java\installed version of jre\lib\ext\TicketAPDLL.dll
Reboot the machine
Note: If you're upgrading from BT Identity Agent, Gemalto Middleware will have been uninstalled. You will need need to re-install it using the instructions below, before continuing.
Uninstall any previous versions of NHS Credential Management
Uninstall any other versions of NHS Credential Management. No other programs are removed as part of this process.
Note: early releases of NHS Credential Management (during 2020) had a different name – NHS Identity Hub. Again, these should be uninstalled prior to the installation of any new version of NHS Credential Management.
Check for .NET 3.5
This is needed for the software set below. By default, Windows 10 does not install the older versions of .Net, but you cannot proceed without them
- Open Control Panel
- Programs and Features
- Turn Windows features on or off
- Check the box for .NET 3.5
Install NHS Credential Management
Follow the detailed instructions for installing NHS Credential Management v184.108.40.206 which includes notes on configuration with combinations of legacy software, as well as troubleshooting guidance for common issues.
Install Gemalto middleware
Ensure you choose the correct installation for your system type (x86 = 32-bit or 64-bit), and follow the detailed instructions for installing Gemalto middleware, paying attention to the order of installation, and notes on configuration with combinations of legacy software.
Gemalto middleware must be installed before Oberthur middleware.
Install PIV minidriver
This is a required installation for Series 9 smartcards.
The mini driver should already be present if automatic Windows updates are enabled. If it's not, follow the instructions for installing the PIV minidriver.
Install Identity Agent
Follow the detailed instructions for installing Identity Agent v220.127.116.11, which includes notes on configuration with combinations of legacy software, as well as troubleshooting guidance for common issues.
Perform additional registry changes
A number of registry changes may be needed, which must be adjusted for each organisation or template. On a new Identity Agent installation, you will need to manually create the sub trees in the registry before first use.
Our simple-to-use IA Registry Editor Tool can be used to quickly update registry setting to switch between environments. Please note, this tool requires Admin rights to update the registry. You can find a link to the tool in the downloads area at the top of this page.
Read guidance on Identity Agent configuration and registry settings.
Reboot the machine
Always close and restart Identity Agent after any registry changes have been made to ensure there are no unexpected results.
Start Identity Agent