Reinstalling the Identity Bridge Agent for Recovery

RapidIdentity Platform Documentation

Solution

Application

Content Type

Technical Documentation

Utilities & Services

ft:locale

en-US

If the Identity Bridge Agent fails, you can uninstall and reinstall the service to ensure the integrity of your files and settings. The agent may fail if your antivirus software blocks or removes files, if files are missing or corrupt, or due to Windows server issues.

Before recovering the agent, you can troubleshoot your Identity Bridge connections or review logs to determine the specific issue. For more information, see Troubleshooting an Identity Bridge Connection.

Requirements

To install the Identity Bridge Agent, you must have the following:

A tenant administrator role in your RapidIdentity portal
Certain domains in your allow list, depending on your firewall settings. For a list of required domains, see Allowing Traffic to and from RapidIdentity Cloud
Antivirus settings configured to exclude the Identity Bridge Agent. For more information, see Excluding Identity Bridge Agent from Windows Security
The registration code that you received when you configured Identity Bridge Agent settings. For more information, see Configuring Identity Bridge Settings in RapidIdentity.

You must have the following minimum specifications:

OS: Windows Server 2016 or later
.NET 8.0: ASP.NET Core and .NET Desktop Runtime

Copy and retain Identity Bridge Agent data.
1. Navigate to C:\Program Files\Identity Automation\Identity Bridge Agent.
2. Copy the CognitoState.bin and AgentState.bin files.
3. Savethe CognitoState.bin and AgentState.bin files in a secure location.
Uninstall the Identity Bridge Agent from your machine.
Note:
When you uninstall the agent, leave the box next to Preserve settings so product can be reinstalled? checked.
Reinstall the Identity Bridge Agent. For more information, see Installing the Identity Bridge Agent Service.
In your RapidIdentity portal, confirm that the Identity Bridge Agent is connected.
1. In the Dashboard pop-up menu, click Configuration.
2. In the sidebar, navigate to Systems > Identity Bridge > Agents.
3. Locate the Identity Bridge Agent that you installed.
4. In the Heartbeat section, confirm that the agent has a heartbeat signal.
Test any Identity Bridges that you have added to the agent. For more information, see Testing an Identity Bridge Connection.

The Identity Bridge Agent is reinstalled and your bridges, settings, and data are restored.