macOS always-on client

Prev Next

Always-on clients are similar to the full client that a normal user runs. They allow the user's device to connect to the network even when the user is not signed in. The always-on client combines the full client, which behaves in the usual interactive way, with the headless client, which runs in the background without a UI.

Example use cases for the headless half of the always-on client:

  • Provision entitlements sufficient to allow connection to the domain Controller. This can allow a computer to join a domain while remote from the network using only a bootable USB stick.

  • Include an entitlement (down rule) to allow remote administration of the device.

  • Set a default route entitlement for the device so it captures and redirects all user traffic at all times.

The only difference between this and the headless client is that the user can sign in because a screen and keyboard are available. Whenever the user is not signed in, the always-on headless client continuously tries to sign in; at boot, the device is always signed in through it, and the headless half receives its own entitlements based on its policy. This allows secure connections to a limited set of resources protected by AppGate ZTNA, regardless of what the user is doing.

When the user signs in to the always-on full client, the headless half suspends, retaining its tokens in memory to resume later. When the user suspends the always-on full client or signs out, the always-on headless client takes over immediately. These two modes of operation are independent: renewing tokens for one does not renew tokens for the other. Auto-update, once initiated from either half, updates both parts together.

NOTE

To use the macOS client, turn off Limit IP address tracking on your device. If this setting is enabled, the client ignores DNS settings. You can disable it manually or through an Apple MDM profile. To disable it manually:

  1. On your macOS device, go to Settings > Network.

  2. Select your ethernet connection or Wi-Fi.

  3. Select the Details… button.

  4. Disable Limit IP address tracking and select OK.


System limitations

The macOS always-on client has the following limitations:

  • Define different users for always-on headless and always-on full mode. Both clients must complete onboarding. If the same user has already onboarded in one mode, the other mode fails to onboard. The client consumes two user licenses.

  • Multi-factor authentication (MFA) onboarding is not supported on the always-on headless client. If the always-on full client requires MFA, use a different identity provider (IdP) and two different profile links.

  • Custom on-demand device claims are not supported in always-on headless mode.

  • Define separate policies for always-on headless and always-on full modes, or use the clientType claim (reports full or headless depending on the active mode).


Installing the macOS always-on client

  1. Follow the same steps to download and install as for the full client.

  2. Pre-install a client profile to the full client part of the always-on client.

  3. Configure the headless part of the always-on client.


Using the client

See macOS headless client.

Using the Service Configurator tool

The appgate_service_configurator tool is in /Library/Application Support/Appgate. Enter:

sudo /Library/Application Support/Appgate/appgate_service_configurator OPTION

The Configurator tool accepts the following options:

Option

Action

getconfig

Displays the current configuration.

reload

Signs out and reconnects automatically. Useful for testing a new configuration.

status

Gets the status of the running service.

The status option returns one of the following messages:

Status message

Description

Waiting for configuration

Client is waiting to be configured

Applying the new configuration

Client is applying the configuration and trying to sign in.

Connecting

Client has successfully signed in and is connecting.

Connected

Client is signed in and connected. Details of the entitlements, Gateways, and Sites are included.

Partially Connected

Client is signed in but can only connect to some Sites.

Suspended. Full client is currently connected
(Always-on only)

Client is suspended because the full client is in operation.

None connected

Client has successfully signed in but cannot connect to any Site.

Disconnecting

Client is disconnecting and will soon try to sign in again.


Uninstalling the macOS always-on client

See Uninstalling macOS clients.


Logs

See macOS headless client and macOS full client.