Application Resilience policies for Zscaler Client Connector

You can activate an Application Resilience policy for Zscaler Client Connector to collect information about the functional status of Zscaler Client Connector installed on your Windows devices and to view the results in reports. You can also configure the policy to attempt to repair or reinstall the application.

Application Resilience policies for Zscaler Client Connector are supported on devices running:

  • a supported version of the Windows operating system

  • PowerShell version 5.1 or higher

    Due to PowerShell restrictions imposed by Microsoft, Application Resilience isn't supported for this application on devices running Windows 11 SE.

  • one of the following versions of Zscaler Client Connector:

    • 3.x or higher

      Significant software changes in higher versions may cause health checks to become invalid.

In addition to checking the version, the following table describes the health checks performed:

If you select Report higher versions as Compliant, higher versions report Compliant without running health checks.

Component Test performed
Services Installed Running Signed by
  • ZSAService (ZSAService.exe)
 P P

One of the signers entered in the policy configuration

By default, Signers contains "Zscaler, Inc.".
  • ZSATunnel (ZSATunnel.exe)
  • ZSATrayManager (ZSATrayManager.exe)
  • ZSAUpdater (ZSAUpdater.exe)
 P n/a
Application name

The application uses one of the following names:

  • Zscaler

  • Zscaler_* (the asterisk [*] indicates the health check accepts any additional characters starting from that position in the application name)

You can configure an Application Resilience policy for Zscaler Client Connector to enable the Application Resilience (RAR) component A lightweight software component of the Secure Endpoint Agent that detects the status of third party applications installed on a device. The component may also attempt to repair the third party application if it is non-compliant. The RAR component is deployed on a device only when the device is associated with a customized policy group and that policy group's Application Resilience policy is activated. to repair Zscaler Client Connector if it's not functioning or to reinstall it if it's missing or can't be repaired.

Depending on the Absolute product licenses associated with your account, the Report and repair and Report, repair, and reinstall options may not be available.

The RAR component of the Secure Endpoint Agent can respond to the following issues:

Issue Resolution
Repair
The ZSAService (ZSAService.exe) isn't running The RAR component restarts the service.

One or more of the following services aren't installed and the service's executable can be detected on the device:

  • ZSAService (ZSAService.exe)
  • ZSATunnel (ZSATunnel.exe)
  • ZSATrayManager (ZSATrayManager.exe)
  • ZSAUpdater (ZSAUpdater.exe)

The RAR component reinstalls each missing service.
Reinstall

Downgrades are not supported. If the version installed on a device is higher than the expected version, no action is taken.

One or more of the following services aren't installed and the service's executable cannot be detected on the device:

  • ZSAService (ZSAService.exe)
  • ZSATunnel (ZSATunnel.exe)
  • ZSATrayManager (ZSATrayManager.exe)
  • ZSAUpdater (ZSAUpdater.exe)

The RAR component downloads and installs the configured version of the application.
Zscaler Client Connector failed to be repaired, or the expected version isn't installed

You can add a 32-bit installer, a 64-bit installer, or both. The installers:

  • must be MSI files

  • can have any file name

The RAR component looks for the following files names when checking pre-cached installers:

Component File name
Installers Zscaler_Setup.msi

Before you activate an Application Resilience policy, you need to configure the policy. You need to configure the application version in addition to the settings in Configuring Application Resilience policies.

To configure the application version:

  1. Under Application version, select 3.*+ from the drop-down.

  2. Under Zscaler™ Client Connector version, enter the version of Zscaler Client Connector you expect to be running on your devices.

    • The target version must be a sequence of digits separated by a period.

    • You can use wildcard "*" characters after the major version number, for example, 3.* or 3.1.*.

    Make sure the version you are entering is consistent with version 3.x or higher.

If you selected the Report, repair, and reinstall option, you also need to configure these settings in addition to the settings in Configuring Application Resilience policies.

To configure the Zscaler Client Connector specific settings:

  1. [Optional] To only reinstall the application if it's missing, select the checkbox next to Do not reinstall or upgrade if the app is already installed. When this option is selected, the application is not reinstalled when either of the following conditions apply:

    • The application version is lower than the expected version.
    • The application can't be repaired.

  1. [Optional] Under Additional installation commands, enter the applicable installation command-line parameters to configure any settings not covered by the policy configuration. For more information on available parameters, see the Zscaler Client Connector documentation.