macOS full client

Prev Next

You can use the macOS full client on any user device, but installation requires administrator rights. When a user opens the .dmg file, the installer installs the full client with auto-start enabled. The full client supports auto-update, applied when the user initiates it.

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.


Installing the macOS full client

You can use the standard installer file for the macOS full client or manually install it with the command line.

Downloading the installer from the command line

To manually install the client, run the following command and replace x.y.z and x.y with the correct version numbers:

curl -L -o "/tmp/AppGate-SDP-client.dmg" "https://bin.appgate-sdp.com/x.y/client/Appgate-SDP-x.y.z-Installer.dmg"

Installing the client from the command line

Install the client with the following and replace x.y.z with the correct version number:

hdiutil attach "/tmp/AppGate-SDP-x.y.z-Installer.dmg" -mountpoint /tmp/appgate
sudo installer -pkg /tmp/appgate/Appgate\ SDP\ Installer.pkg -target "/"
hdiutil detach /tmp/appgate

Using the command line to start the client

When a user runs AppGate ZTNA by clicking it, the client launches. You can also pre-install the profile link at run time to avoid subsequent user interactions. To pre-install a client profile so users go straight to the sign-in form, run:

/Applications/Appgate\ SDP.app/Contents/MacOS/Appgate\ SDP --url <full profile URL> --novalidate

Configuring the macOS full client

Run the following commands for each user account that will use the full client:

Disable the data usage acceptance screen on first launch

defaults write com.appgate.sdp.service user_approval -bool YES

Set the client profile URL

Multiple profiles can be separated by semicolons: "profile1;profile2". Replace <full profile URL> with the client profile link, found at the Client Profiles page (Identity > Client Profiles).

defaults write com.appgate.sdp.service default_profiles "<full profile URL"

Uninstalling the macOS full client

See Uninstalling macOS clients.


Logs

Client logs

Client logs are in ~/.appgatesdp/log.

  • log- includes logs from the main service

  • ui- includes logs from the UI process

log-date and ui-date records are archived at the end of every day for 30 days.

Driver logs

Use the macOS utility Console to view client logs under var/log/appgate/driver.log.

Driver logs are also at /var/log/appgate/driver.log.

From Terminal, run:

sudo cat /var/log/appgate/driver.log

Log level

To change the log level, start the client from the command line:

/Applications/AppGate\ SDP.app/Contents/MacOS/Appgate\ SDP --loglevel <value>

The <value> options are: Dump, Trace, Debug, Info, Warn, Error, Fatal.

Info is the normal setting. Values to the right reduce the number of log records saved. Values to the left are not recommended unless AppGate support instructs you to use them. To return to normal, quit the client and restart.