Installing, Upgrading and Uninstalling the Agent

You require administrative rights to the macOS system are required for installing, configuring, upgrading, and uninstalling the agent.

After upgrading the agent, it is highly recommended to run the Configure_macLogon script file available in the package as per your configuration.

This section describes the following ways to install, configure, upgrade, and uninstall the agent:

• Using Jamf Pro
• Using Installer

Using Jamf Pro

This section describes the steps to perform the installation, upgrade, configuration, and uninstallation of the agent using Jamf Pro. This process is used to deploy the agent on multiple machines.

Prerequisites

• A valid Jamf Pro license purchased from Jamf
• Jamf Pro setup on the targeted machine

Silent Installation and Upgrade

Perform the following steps to add and run the policies on a targeted machine:

1. Log in to Jamf Pro.

2. Click the Settings icon on the top right-hand side corner.

3. Select Computer Management, and then click Packages.

4. Click New to add a new package.

5. In the General tab, enter a Display Name for the package, and then click Choose File to upload SafeNet_Agent_For_macOS_Installer.pkg. Now, click Save at the bottom right-hand side corner.

6. To add a policy, click Computers > Policies in the left pane, and then click New.

7. In the Options tab, under General,

   a. Enter a Display Name for the policy.

   b. Select the Enabled check box.

   c. Select the options to Trigger Event(s) (to use to initiate the policy) as per your requirement.

   d. Select the Execution Frequency (frequency at which to run the policy).

8. Click Packages, and then click Configure.

   a. Click Add (next to the package name) to select the above added .pkg file.

   b. Select Cloud distribution point from the Distribution Point drop down.

9. Select the Scope tab, and then add the target computers and target users to run the Jamf policies. You can click Add, displayed next to Selected Deployment Targets to add a specific target, and then click Save.

Execution of the policy to install the Mac Logon agent by using Jamf Pro policies on the targeted machine will be done automatically (based on the configured trigger event).

Silent Configuration

Perform the following steps to configure the agent on a targeted machine:

1. Add the following parameters in the sampleConfig.agent file (available in the package):

   {"
   Data": {
   "Communication": {
   "PrimaryTokenValidatorUrl": "",
   "SecondaryTokenValidatorUrl": "",
   "agentStatus": "0",
   "agentMode": "0",
   "emergencyPassword": "1",
   "logLevel": "3",
   "defaultAuthenticator": "1",
   "sslCertificate": "1",
   "usernameFormat": "0",
   "BsidKey": "",
   "byPassAdmin": "1",
   "internetReqTimeoutInSec": "10"
   }}}
   

1. Copy the content of the updated sampleConfig.agent file.

2. Open Configure_macLogon script file and paste the content (that you copied in the previous step) in line 3 between ' and ':

   echo 'copied_content' > /usr/local/thales/MLA.agent
   

3. In Jamf Pro, click the Settings icon on the top right-hand side corner.

4. Select Computer Management, and then click Scripts.

5. Click New on top right-hand side corner to add a new script.

   a. In the General tab, enter a Display Name for the script.

   b. In the Script tab, copy and paste the updated Configure_macLogon.sh script.

   c. Click Save.

6. To add a policy, click Computers > Policies in the left pane, and then click New.

7. In the Options tab, under General,

   a. Enter a Display Name for the policy.

   b. Select the Enabled check box.

   c. Select the options to Trigger Event(s) (to use to initiate the policy) as per your requirement.

   d. Select the Execution Frequency (frequency at which to run the policy).

   b. Click Script, and then click Configure. Now, click Add (next to the script name) to select the above added script.

   c. Select the Scope tab, and then add the target computers and target users to run the Jamf policies. You can click Add, displayed next to Selected Deployment Targets to add a specific target.

   d. Click Save.

Execution of the policy to configure the Mac Logon agent by using Jamf Pro policies on the targeted machine will be done automatically (based on the configured trigger event).

Silent Uninstallation

Perform the following steps to uninstall the agent on the targeted machine:

1. In JamfPro, click the Settings icon on the top right-hand side corner.

2. Select Computer Management, and then click Scripts.

3. Click New on top right-hand side corner to add a new script.

4. In the General tab, enter a Display Name for the script.

5. In the Script tab, copy and paste SafeNet_Agent_For_macOS_UnInstaller.sh script.

6. Click Save.

7. In the Options tab, under General,

   a. Enter a Display Name for the policy.

   b. Select the Enabled check box.

   c. Select the options to Trigger Event(s) (to use to initiate the policy) as per your requirement.

   d. Select the Execution Frequency (frequency at which to run the policy).

   b. Click Script, and then click Configure. Now, click Add (next to the script name) to select the above added script.

   c. Select the Scope tab, and then add the target computers and target users to run the Jamf policies. You can click Add, displayed next to Selected Deployment Targets to add a specific target.

   d. Click Save.

   Execution of the policy to uninstall the Mac Logon agent by using Jamf Pro policies on the targeted machine will be done automatically (based on the configured trigger event).

Using Installation File

This section describes the process of installation, upgrade, and uninstallation of the agent using installer.

Installing and Upgrading the agent

Perform the following steps to install or upgrade the agent:

1. Locate the following installation file and double-click it to run the installer:

   SafeNet_Agent_For_macOS_Installer.pkg
   

2. Perform the following steps in the Installation wizard:

   a. On the Introduction page, click Continue.

   

   b. On the License Agreement page, read the software license agreement, click Continue and to proceed, and click Agree to accept the license agreement.

   

   c. On the Destination Select page, click Continue.

   

   d. On the Installation Type page, click Install.

   

   e. Enter the administrator's Username and Password, and click Install Software.

   

   f. After successful authentication, the agent gets installed, and a successful installation message is displayed. Click Close.

   

   Note

   The agent files are installed at a fixed location.

Silent Installation and Upgrade

To install or upgrade the SafeNet Agent for macOS Logon in silent mode, perform the following steps:

1. Open the terminal and navigate to the folder that contains the installer.

2. Run the following command from the command line:

   sudo installer -store -pkg SafeNet_Agent_For_macOS_Installer.pkg -target /
   

3. To configure the agent in SAS PCE:

   a. Update the sampleConfig.agent (available in the downloaded package) as per your requirement.

   b. Copy the content of the updated sampleConfig.agent file.

   c. Open Configure_macLogon.sh script file and paste the value (that you have copied in the previous step) in line 3 between ' and '.

       echo 'copied_content' > /usr/local/thales/MLA.agent
   

   d. Run Configure_macLogon using the following command:

       sh Configure_macLogon
   

Uninstalling the agent

You can uninstall the SafeNet Agent for macOS Logon in two ways:

Perform the following steps to uninstall the agent:

1. Run SafeNet_Agent_For_macOS_UnInstaller, provided with the installer package.

2. Enter your local administrator password.

Or, Perform the following steps using the terminal:

1. Navigate to the directory where the package is downloaded.

2. Run the following command:

   sh SafeNet_Agent_For_macOS_UnInstaller
   

3. Enter the administrator password.

   All the installed files of macOS Logon Agent will be uninstalled.