Windows SSO (PLAP) client

Prev Next

The SSO client lets users authenticate to the network before logging on to Windows with a local account. Single sign-on (SSO) provides a secure way to obtain Extensible Authentication Protocol (EAP) method-specific credentials for a network user or computer account. Users do not have to sign in multiple times to the PC and the network.

The AppGate ZTNA SSO client is a version of the Windows client that adds a custom AppGate ZTNA sign-in screen. This screen captures Windows domain credentials for use by AppGate ZTNA to provision authenticated access and for Windows to perform network authentication. The user enters their credentials once and does not need to sign in to AppGate ZTNA again after signing in to Windows.

NOTE

When installed, the normal client mode is not available. SSO mode must be used at all times.


Windows 10 sign in

To access the AppGate ZTNA SSO client sign-in page:

  1. Go to the Windows sign-in screen.

  2. Press the Network sign-in icon in the lower left of the screen.

Network sign-in option displayed in a computer interface with additional icons.

  1. The AppGate SSO sign-in page appears.

AppGate SDP login screen with fields for username and password.

  1. Enter the username and password. The username must include both the domain and the username in the format domain\user.

After signing in to Windows, the AppGate ZTNA client runs in the same way as the normal client. When using the AppGate ZTNA SSO sign-in, the user is signed in to the client with limited options. The user cannot quit or sign out from the client. Sign-out happens automatically when the user signs out of Windows.


System limitations

The Windows SSO client has the following limitations:

  • You must join the machine to the domain. Without domain membership, the SSO client cannot sign in even with valid domain credentials.

  • The SSO client fails to onboard if the user has already onboarded using the normal client. You must perform onboarding from the SSO client for a user on a specific computer.

  • Set the Windows security policy to show the last logged-in username and user profiles on the sign-in screen.

  • Local users cannot use the normal AppGate ZTNA client after you install the SSO client.


Standard executables

The Windows SSO (PLAP) client uses the following standard executables:

  • Service Configurator. Configures the SSO client. Requires the AppGate SDP Service to be running.


Installing the Windows SSO client

Downloading the installer from the command line

To download the installer, follow the steps in Downloading the installer from the command line.

Installing the client from the command line

To install the client as an SSO service, run the installer with the /L switch. The /S (silent installation) switch is also recommended. Run CMD or PowerShell as an administrator. See the Windows clients section for a full explanation of all installation switch options.

To install the Windows SSO (PLAP) client in silent mode, run CMD or PowerShell as an administrator and run one of the following commands using the full client profile URL (from Identity > Client Profiles) and replacing x.y.z with the correct version number:

CMD

start "" /WAIT "Appgate-SDP-x.y.z-Installer.exe" /L /S /G /P="<full profile URL>"

PowerShell

Start-Process "Appgate-SDP-x.y.z-Installer.exe" -ArgumentList ' /L /S /G /P="<full profile URL>" '

Use services.msc to confirm that both the AppGate ZTNA Client SSO (PLAP) Service (appgateplapservice) and AppGate ZTNA Driver Control (cxdriver) exist and are running.

NOTE

You can upgrade an existing installation to a Windows SSO client by running the installer with /L and additional parameters such as /P. The installer does not transfer any configuration set for the normal client. Always provide the /L flag every time the AppGate ZTNA client is installed, upgraded, or reinstalled to retain the AppGate ZTNA SSO functionality.


How to set or change the configuration

After installation, an "Appgate SDP" folder appears in the Windows Start menu. It contains the client uninstaller and a shortcut to the Configurator.

The Configurator is an optional tool you can use to create and test SSO client configurations—for example, testing that the Controller URL, certificate, and provider are working correctly. The user must sign in again after using the set or reset commands. See the Configurator tool section for more information.


Configuring domain access

The SSO client works as if the PC were on the LAN and able to communicate with the domain controller. For this to work when the LAN is accessible only through an AppGate ZTNA Gateway, you must have the correct entitlements in place. See Allowing full, network-like access for users for more information.


Uninstalling the Windows SSO client

You can uninstall the Windows SSO client in the following ways:

  • Run the uninstaller from the Start menu shortcut.

  • Use Add or Remove Programs in Windows.

NOTE

Uninstalling the SSO client removes only the client binaries—SSO client configurations are not removed.


Logs

See Windows headless client for log file locations.