Skip to main content

HelloID

Agent

2022-12-08_16-08-05.jpg

The on-premises HelloID Agent comprises three Windows services that you install & run on a server within your organization's network. These services communicate with your HelloID tenant via HTTPS. This lets HelloID execute actions & PowerShell code in your network.

For example:

  • Executing Tasks and other PowerShell scripts on-premises, in order to manage folders, groups, users, or other IT resources

  • Synchronizing users into HelloID from an on-premises Active Directory configuration (see AD sync)

  • Authenticating users into HelloID when using the AD Agent IdP

  • Reading & writing data in on-premises source & target systems in Provisioning

To get started, Add an Agent Pool and then Install an on-premises Agent.

Tip

It is possible to install multiple on-premises Agent instances. This is particularly useful in large enterprise environments. If you do install multiple instances, they are coordinated by Agent pools.

On-premises Agent services

The three on-premises Agent services correspond to the three HelloID modules:

2021-02-11_8-53-30.png

On-premises Agent updates

With every new version of HelloID, there is a new version of Agent. Agent auto-updates itself whenever it communicates with your HelloID portal and detects a version difference. This normally occurs immediately after each HelloID release. Under normal circumstances, no action is required on your part to update Agent. However, if the auto-update process fails, you will need to manually uninstall the services and re-install them from scratch.

Cloud Agent

HelloID Service Automation and HelloID Provisioning can run certain actions using a Cloud Agent instead of an on-premises Agent.

The Cloud SA Agent and Cloud Provisioning Agent are particularly useful if your organization is 100% cloud-based and does not have an on-premises Windows network.

Note

Unlike HelloID Service Automation and HelloID Provisioning, HelloID Access Management does not have a cloud Agent. It only has an on-premises Agent.