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:
On your macOS device, go to Settings > Network.
Select your ethernet connection or Wi-Fi.
Select the Details… button.
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/appgateUsing 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> --novalidateConfiguring 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 YESSet 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 serviceui-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.logLog 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.