DualShield Windows Logon Agent is a bridge that connects DualShield Logon Clients and the DualShield Authentication Server. The Windows Logon Agent can be installed on any Windows server machine in the network.

Prerequisites

Before you run the setup wizard, you must have your DualShield Authentication Server installed and operating, and make sure that the computer on which you are going to install the Windows Logon Agent meets the following minimum hardware and software requirements:

  • A Windows  2012 R2, 2016, 2019 or 2022 Server with the latest service pack installed.
  • TCP/IP Networking
  • TCP port 14292 and/or 14294 must be available on the Windows server for use by the DualShield Computer Logon Agent.

Enable Agent Registration

In order to install a DualShield Windows Logon Agent, we need to first enable the Agent Registration option.


For an authentication agent to be able to connect to the DualShield authentication server, the agent must be registered in the DualShield authentication server.

For security purposes, the agent registration function is disabled by default. You need to enable the Agent Auto Registration function in your DualShield authentication server.

From the management console, navigate to "Authentication | Agents", then click  


A new window will now open titled "Auto Registration", ensure the "Enabled" option is selected, then click ;


Tick the "Enabled" option first, then fill in the Starts and Expires date.

You may want to enable the "Check IP" option for extra security. If this option is enabled, then in the "IP Addresses" field you must enter the IP address of the machine where the authentication agent is being installed.

Click on the button, and Auto-Registration will now take place during the installation of the RADIUS server.

Install DualShield Windows Logon Agent 

To install the DualShield Windows Logon Agent, launch the installer SetupDSAgent-xxx.yyyy.exe (where xxx is the version number and yyyy the build number) and go through the following steps:

Step 1: Welcome

Step 2: License Agreement

Step 3: Installation Path

Step 4: Install GINA or Credential Provider

Enable the option: “Enable multi-factor authentication on this machine” only if you wish to secure the server machine on which the Windows Logon Agent is being installed with MFA. Otherwise, do not check this option.

If you selected this option, then you will be prompted with the next screen: 

Leave this option checked.

Step 5: Agent Registration

In the FQDN field, enter the correct FQDN of your DualShield server. The default suggestion is based on the host name of the machine and is often not the correct value.

In the Port field, keep the default value 8071, unless you have changed your DualShield Server's operating port numbers.

Step 6: Installing...

Step 7: Connect to an application

At this point, the agent has been successfully registered with the DualShield server., and is waiting for an application to be published on this agent.

In the “Application” field, it displays “Click here to select”.

The next step is to publish a Windows application on this agent.

Step 8: Publish an application

Login to your DualShield Admin Console, select "Authentication | Agents" in the side panel.

You will see that the agent you are installing is listed. 

Open the Agent's context menu.

Select "Applications" to launch the application list

Select the application that you want to publish on this agent, e.g. Windows Logon, then click the "SAVE" button.

The application is now published on the agent.

Step 9: Complete installation

Now, go back the agent installation process where it is displaying "Click here to select” in the Application field:

 

Click "Click here to select", you will see that an application is now available in the list

Select the application, then click the Save icon on the toolbar:

Finally, click the close icon to close the window

The Windows logon agent has now been successfully installed, registered and linked to an logon application.







  • No labels