Deploying the GINA (Windows) Login Agent via Endpoint Central
You can use the following steps to deploy the GINA (Windows) login agent through Endpoint Central. This procedure applies to both fresh installations and machines with an existing agent.
Step 1: Create the Software Package
Go to Software Deployment > Add a Package > Windows.
Fill in the details:
Package Name: ADSelf Service GINA agent
Package Type: MSI/MSP
License Type: Commercial
Locate Installable: Navigate to <Product_installation_folder>/bin and select ADSelfServicePlusClientSoftware.msi.
Step 2: Configure Installation Details
3. Under Installation > Installation Details, enter the following:
MSI/MSP File Name: ADSelfServicePlusClientSoftware.msi
MSI/MSP Properties for Installation: SERVERNAME=abc.selfservice.com" PORTNO="9251" PROTOCOL="https" INSTALLATION_KEY="XXXX" BUTTONTEXT="Reset Password / Unlock Account" BYPASS="true" FRAMETEXT="Can't login? Please click on Reset Password/Unlock Account button to reset your password or unlock your account" GINAHOSTEXCLUDE="okta,onelogin" MFAENROLLMENTWINDOWTITLE="Multi-Factor Authentication - Enrollment" MFAWINDOWTITLE="Multi-Factor Authentication" PPE_POPUP="true" PROD_TITLE="ADSelfService Plus" RESTRICTBADCERT="false" SERVERUNREACH="This action requires you to be verified with MFA. Please make sure the ADSelfService Plus server is reachable, has a proper SSL certificate, and connected to the domain controller. " SHOWADSSPLINK="true" SHOWADSSPTILE="true" WINDOWSLOGONTFA="true" MACHINEMFAUSAGESCENARIO="5" OFFLINEMFA="false"
Note: Replace the paramater values in the installation command above with your application-specific values. You can also add other parameters to the installation command as per your requirements. You can find the full list of available parameters here.
Step 3: Configure Pre-deployment Activities
4. Under Pre-deployment Activities, click + > Add Custom Script.
5. Configure the script:
Execute Script from /Run: Command Line
Command Line: msiexec /x {E451B224-C4E6-452E-BB61-2EFD4DC79A9C} /qn
Dependency File: Browse and locate ADSelfServicePlusClientSoftware.msi.
Enable Proceed with the installation even if the above configuration fails.
6. Click Save & Continue.
Step 4: Deploy the Package
7. Add the package and deploy it to the target machines.