Skip to main content

 

 

Netskope Global Technical Success (GTS)

Manual Deployment of Netskope Client on macOS with PLIST

Netskope Cloud Version - 130

 

Objective

This document provides step-by-step instructions to manually install and configure the Netskope Client on macOS using the PLIST method. This method ensures the client is preconfigured with the correct tenant details during installation.

 

Prerequisites

  • Mac OS device with administrator access
  • Netskope Client installer package (.pkg) and script downloaded from support portal.
  • Access to the Netskope tenant to retrieve the Organization Token and Secure Enrollment Token

 

What is PLIST?

A PLIST (Property List) is a configuration file used in macOS to store structured data like application preferences and system settings. In this case the the installation the Netskope Client reads this file to automatically configure itself with the correct tenant information and eliminate the need for manual configuration steps.

 

Steps

Step 1: Download the Netskope macOS Package and Script

 

Step 2: Place the Netskope Package and Deployment Script in the Same Folder

  • On your macOS device, create a folder (for example "Netskope file") in a convenient location such as Desktop or Downloads.
  • Copy both the Netskope Client installer package (.pkg) and the deployment script into this folder.
  • Ensure that both files are in the same directory because the script will reference the installer package during execution.

 

Step 3: Generate the PLIST File

  • Open Terminal on the macOS device and run the command below with your user email. You can give any name to the PLIST file.

    sudo /usr/libexec/PlistBuddy -c "add email string adelev@M365x03333076.onmicrosoft.com" /Library/Managed\ Preferences/netskope.plist

  • If your macOS device is not managed through an MDM solution, you might see an error similar to the one below when running the command:

This happens because the directory /Library/Managed Preferences/ is not created by default on unmanaged devices. To fix this, manually create the directory by running the following commands in Terminal:

sudo mkdir -p "/Library/Managed Preferences"
sudo chmod 755 "/Library/Managed Preferences"

 

After creating the /Library/Managed Preferences/ folder and running the same command again, you can see that the PLIST file is successfully created.

 

Step 4: Install the Netskope Client Using the Script

  • Go to the directory where you have saved the script file.
  • Make the script executable by running the command below:

chmod +x mac_mdm_install.sh

 

  • Execute the installation command by providing the required parameters as shown below

sudo ./mac_mdm_install.sh 0 0 0 addon-<tenant-name>[.region].<tenant-domain> <Organization ID> <plist file name> preference_email enrollauthtoken=<authentication token> enrollencryptiontoken=<encryption token>
 

example:

sudo ./mac_mdm_install.sh 0 0 0 addon-test.goskope.com ABCDEFGH netskope.plist preference_email enrollauthtoken=ABCDEFGH enrollencryptiontoken=ABCDEFGH

 

  • The Organization ID, enrollauthtoken, and enrollencryptiontoken can be found in the Netskope UI under:Settings > Security Cloud Platform > Netskope Client > MDM Distributions

 

 

  • You should see an output similar to the one shown below:
  • Now double-click the .pkg file and install the Netskope Client.
  • Once the client is installed it will prompt you to allow system extensions. Make sure you approve and allow them.
  • For Netskope Client deployments on macOS Sonoma and later, Netskope Client requires Full Disk Access Permissions. During installation, end-users can view a dialog box instructing them to approve these permissions in System Settings for Netskope’s NetskopeClientMacAppProxy.

 

Verification

 

Terms and Conditions

  • All documented information undergoes testing and verification to ensure accuracy.
  • In the future, it is possible that the application's functionality may be altered by the vendor. If any such changes are brought to our attention, we will promptly update the documentation to reflect them.

Notes

  • This article is authored by Netskope Global Technical Success (GTS).
  • For any further inquiries related to this article, please contact Netskope GTS by submitting a support case with 'Case Type – How To Questions'.
Be the first to reply!