Installation of the login agent on Windows (GINA), macOS, or Linux

Supported platforms

To protect machines with MFA and to let users reset passwords from their Windows, macOS, or Linux login screens, admins have to deploy the login agent on the users’ machines.

The different platforms supported by the login agent are listed below.

Windows servers Windows clients macOS clients Linux clients
Windows Server 2022 Windows 11 macOS 14 Sonoma Ubuntu-16.x-20.04.4
Windows Server 2019 Windows 10 macOS 13 Ventura Fedora - 27.x-31.x
Windows Server 2016 Windows 8.1 macOS 12 Monterey CentOS - 7.X
Windows Server 2012 R2 Windows 8 macOS 11 Big Sur  
Windows Server 2012 Windows 7 macOS 10.13 High Sierra  
Windows Server 2008 R2 Windows Vista macOS 10.12 Sierra  
Windows Server 2008   OS X 10.11 El Capitan  
    OS X 10.10 Yosemite  

Note:

HTTPS needs to be enabled in the Access URL to install the login agent on remote machines. Learn how to enable HTTPS in ADSelfService Plus.

While the ADSelfService Plus login agent has been officially tested to be compliant with the three Linux distributions mentioned, it may support other Linux distributions as well. Please contact the support team (support@adselfserviceplus.com) to check if the Linux distribution used in your organization is supported.

Different methods to deploy the Login Agent

The login agent can be deployed on users' machines in one of the following ways:

A. From the ADSelfService Plus admin console

The ADSelfService Plus admin portal is a simple and effective way to install the login agent on Windows, macOS and Linux machines.

Installation Steps

Different methods to deploy the Login Agent
  1. In the ADSelfService Plus web portal, go to Configuration > Administrative Tools > GINA/Mac/Linux (Ctrl+Alt+Del) > GINA/Mac/Linux installation.
  2. Click New Installation.
  3. Select a domain and then the computers on which you want to install the login agent.
  4. Click Install.

Note: ADSelfService Plus now supports three different methods of Windows login agent installation to enhance the success rate. The three methods are:

  • Remcom.
  • PAExec.
  • WMI.

When Remcom fails, PAExec is tried, and if that fails, WMI is implemented.

Click here for detailed information on installing and customizing the Login Agent through the ADSelfService Plus Admin Portal.

The Login Agent Installation Key

B. Manual installation

1. Using the Installation Wizard

Manual agent installation on Windows/macOS/Linux clients using the installer package

  1. From the ADSelfService Plus admin portal, navigate to Configuration → Administrative Tools → GINA/Mac/Linux (Ctrl+Alt+Del).
  2. Click Manual Installation Steps (GINA/MAC/Linux) to open the Manual Installation Steps pop-up.
  3. Manual installation

    Manual installation

To install the Login Agent on Windows, macOS, and Linux machines, follow the steps given under the respective tabs.

2. Using the Command Line Interface (CLI)

a. Login Agent CLI installation on Windows machines

When the login agent is installed manually using the MSI package on computers running Windows Vista and later operating systems with User Account Control (UAC) enabled, it may not function properly. In such cases, you can install the Windows login agent manually through the Command Prompt, as shown here.

b. Login Agent CLI installation on macOS machines

  1. Copy the ADSelfServiceMacLoginAgent.pkg file from the product <Installation Directory>/bin folder and paste it into the Mac where the login agent is to be installed.
  2. Copy the macOS CLI command from the ADSelfService Plus admin portal. Go to Configuration > Administrative Tools > GINA/MAC/LINUX (Ctrl + Alt + Del) > Installation Help Guide > macOS Login Agent CLI installation > View Command to find it. It is shown in the pop-up that appears on clicking View Command.
  3. Manual installation

  4. Open the Terminal on the Mac, navigate to the directory that the installer package was copied to, then paste the command, and execute it.

Note: Use the macOS CLI command when you are silently installing the Login Agent via the terminal or via any 3rd party endpoint management tools like Endpoint Central.

c. Linux Login Agent Installation

  1. Copy the installLinuxAgent.sh and ADSSPLinuxClient.tar.gz files from the product <Installation_Directory>/bin folder and paste them onto the target Linux machine on which the login agent is to be installed.
  2. Copy the Linux CLI command from the ADSelfService Plus admin portal. Go to Configuration > Administrative Tools > GINA/MAC/LINUX (Ctrl + Alt + Del) > Installation Help Guide > Linux Login Agent CLI installation > View Command to find it. It is shown in the pop-up that appears on clicking View Command.
  3. Manual installation

  4. Open the Terminal on the Linux machine and navigate to the directory that the installer package was copied to. Paste and execute the command.

C. Via GPO

Follow the steps in this Login Agent installation guide to install the GINA Login Agent on Windows machines, using GPO.

D. Via SCCM

Follow the steps in this Login Agent installation guide to install the GINA Login Agent using SCCM.

E. Via Endpoint Central

Follow the steps in this Login Agent installation guide to install the Login Agent using Endpoint Central.

Note: The installation of the login agent via GPO and SCCM deployment methods is only applicable on Windows.

Thanks!

Your request has been submitted to the ADSelfService Plus technical support team. Our technical support people will assist you at the earliest.

 

Need technical assistance?

  • Enter your email ID
  • Talk to experts
  •  
     
  •  
  • By clicking 'Talk to experts' you agree to processing of personal data according to the Privacy Policy.

Don't see what you're looking for?

  •  

    Visit our community

    Post your questions in the forum.

     
  •  

    Request additional resources

    Send us your requirements.

     
  •  

    Need implementation assistance?

    Try onboarding

     

Copyright © 2024, ZOHO Corp. All Rights Reserved.