Install the Cloud Gateway Client

The EmpowerID Cloud Gateway Client enables your EmpowerID Cloud SaaS tenant to inventory and manage your on-premise systems without requiring ports to be opened on your firewall. The Cloud Gateway is a lightweight client that can be installed on a Windows desktop or server machine in your on-premise network. The Cloud Gateway client then makes a secure and encrypted outbound HTTPS connection to an EmpowerID queue in Azure as a bridge for communication between the EmpowerID Cloud servers and your on-premise network. You can install multiple Cloud Gateways on-premise for fault tolerance and increased performance.

Requirements

  • .NET Framework 4.8 must be installed on any server running the Cloud Gateway Client.

Create the Cloud Gateway Person Account

  1. On the navbar, expand Identity Administration and select People.

  2. Click the Create Person Advanced Action link.

     

  3. In the General tab of the Create Person form that appears, enter the following information:

    • First Name – First name

    • Last Name – Last name

    • Display Name – Enter the name that will appear for the person in the User Interface

    • Login – Enter the login for the account or click the icon to have EmpowerID suggest one for you

    • Primary Business Role and Location – Click Select a Role and Location and do the following:

      • Search for and select Temporary Role as the Business Role

      • Search for and select Temporary Location as the Location

      • Click Select.

    • Management Roles – Search for and select UI-Admin-Cloud-Gateway.

  4. Leave all other fields empty and click Save.

Install the EmpowerID Cloud Gateway Client

  1. On a designated on-premise machine, double-click the EmpowerIDCloudGateway.msi installer file to run it.

  2. In the EmpowerID Cloud Gateway Setup wizard that appears, enter the Host URL to connect with and click Next.

     

  3. On the Ready to install page, click the Install button. 

  4. When the agent finishes installing, click the Finish button to close the wizard.


    You should see the EmpowerID Cloud Gateway Setup window appear.

     

  5. Optionally, if you are using a proxy to connect to the internet, select Use Proxy and then enter the address in the Proxy Address field.

     

  6. Click Connect.

     

  7. Enter the EmpowerID username and password for the dedicated cloud service account and click Login.

  8. Click OK to close the Registration Complete message box.

  9. Open Services.msc and start the EmpowerID Remote Agent Windows service.

     

After you have installed the Cloud Gateway Client, you will need to set the Server Role to Cloud Gateway for the server hosting the client. Please see Configuring Server Roles for more information.


Next Steps

Configure Server Roles

Â