All Collections
Troubleshooting and How-To
How-To Articles
How to configure the macOS permission settings
How to configure the macOS permission settings
A
Written by Arick Disilva
Updated over a week ago

Mac Agent 233 and Later

Revealed Agent

Step 1: Install the Revealed Agent

1. Download the pkg file. Rename the pkg file to include any optional parameters (see the Agent Installation/Configuration Parameters (Mac) section to learn more).

2. Open it and the installation dialog will be open:

mceclip0.png

3. Click the Continue button. You will be taken to the next step, Destination Select:

mceclip1.png

4. Click the Continue button. You will be taken to the next step, Installation Type:

mceclip2.png

5. Click Install button. You will be shown the Installer dialog:

mceclip3.png

6. Enter your username and password and then click the Install Software button. The installation will start. When it finishes, you will see the The installation was successful message:

mceclip4.png

7. Click the Close button to finish the installation.

After you have installed the agent, you will need to enable a few macOS permissions for the agent to be able to record screen and other activities properly. Please follow the steps below to enable the permissions.

Step 2: Set the macOS Permissions for the Revealed Agent

Accessibility and Screen Recording Permissions

mceclip5.png

1. Open the Launchpad and then select the Teramind Agent application. The Agent will launch and you will be shown a Accessibility Access pop-up window on top of the Teramind App:

mceclip6.png

2. Click the Open System Preferences button, you will be taken to the Security & Privacy window:

mceclip7.png

3. Click the Accessibility tab and click the Teramind Agent app to enable accessibility permission for it.

mceclip8.png

4. Click the Screen Recording tab and click the Teramind Agent app to enable screen recording permission for it.

5. Restart the application if requested.

Network Monitoring Permission

For Agent Version 234 and Newer

1. To monitor network activities, you will need to enable permission for NetApp. Teramind uses this extension to monitor network traffic. Run the following command on your Terminal (type everything in a single line):

sudo "/usr/local/teramind/agent/bin/Teramind Agent.app/Contents/MacOS/Teramind Agent" network_permissions;sleep 1;sudo killall "Teramind Agent"

You will see the NetApp permission request dialog:

2. Click the Open Security Preferences button. You will be taken to the Security & Privacy screen:

3. Click the Allow button next to the System software from application “.NetApp” was blocked from loading message. A pop-up window will open:

4. Click the Allow button to confirm adding proxy configurations by NetApp.

File Monitoring Permission

For Agent Version 23.35.4749 and Newer

1. To monitor file transfer activities, run the following command on your Terminal (type everything in a single line):

sudo "/usr/local/teramind/agent/bin/Teramind Agent.app/Contents/MacOS/Teramind Agent" filemonitor_permissions;sleep 1;sudo killall "Teramind Agent"

You will see the NetApp permission request dialog:

2. Click the Open Security Preferences button. You will be taken to the Security & Privacy screen:

3. Click the Privacy tab.

4. Select Full Disk Access from the left panel.

5. Enable FileMonitor from the list of apps on the right side.

Geolocation Monitoring Permission

Before you enable the geolocation permission, please make sure to turn on the Location Services on the Mac:

Apple menu > System Settings, click Privacy & Security in the sidebar, then click Location Services on the right. (You may need to scroll down.).

1. To monitor geolocation, run the following command on your Terminal (type everything in a single line)::

sudo "/usr/local/teramind/agent/bin/Teramind Agent.app/Contents/MacOS/Teramind Agent" geolocation_permissions;sleep 1;killall "Teramind Agent"

2. You will see a dialog box with the message, "Teramind Agent" would like to use your current location":

3. Click the Allow button. The Geolocation feature will be activated.

Hidden Agent

Step 1: Install the Hidden Agent

The steps are similar to the Revealed Agent. Please follow the instructions under Step 1: Installing the Revealed Agent section above.

Step 2: Set the macOS Permissions for the Hidden Agent

Accessibility and Screen Recording Permissions

1. Type the following command on the Terminal window and press Enter (type everything in a single line):

sudo killall "System Monitoring"; open "/usr/local/teramind/agent/bin/System Monitoring.app" --args permissions

A pop-up window will appear:

mceclip13.png

2. Click the Open System Preferences button. You will be taken to the Security & Privacy window:

mceclip14.png

3. Click the Accessibility tab and click the System Monitoring app to enable accessibility permission for it. You will be shown a warning message:

mceclip15.png

4. Click the Open System Preference button.

mceclip16.png

5. Provide access permission to System Monitor for Screen Recording this time. You will be asked to restart the application:

mceclip17.png

6. Click the Quit & Reopen button to apply screen recording capabilities.

Network Monitoring Permission

For Agent Version 234 and Newer

1. To monitor network activities, you will need to enable permission for NetApp. Teramind uses this extension to monitor network traffic. Run the following command on your Terminal (type everything in a single line):

sudo "/usr/local/teramind/agent/bin/System Monitoring.app/Contents/MacOS/System Monitoring" network_permissions;sleep 1;sudo killall "System Monitoring"

Then you will see the NetApp permission request dialog:

2. Click the Open Security Preferences button. You will be taken to the Security & Privacy screen:

3. Click the Allow button next to the System software from application “.NetApp” was blocked from loading message. A pop-up window will open:

4. Click the Allow button to confirm adding proxy configurations by NetApp.

File Monitoring Permission

For Agent Version 23.35.4749 and Newer

1. To monitor file transfer activities, run the following command on your Terminal (type everything in a single line):

sudo "/usr/local/teramind/agent/bin/System Monitoring.app/Contents/MacOS/System Monitoring" filemonitor_permissions;sleep 1;sudo killall "System Monitoring"

You will see the NetApp permission request dialog:

2. Click the Open Security Preferences button. You will be taken to the Security & Privacy screen:

3. Click the Privacy tab.

4. Select Full Disk Access from the left panel.

5. Enable FileMonitor from the list of apps on the right side.

Geolocation Monitoring Permission

Before you enable the geolocation permission, please make sure to turn on the Location Services on the Mac:

Apple menu > System Settings, click Privacy & Security in the sidebar, then click Location Services on the right. (You may need to scroll down.).

1. To monitor geolocation, run the following command on your Terminal (type everything in a single line)::

sudo "/usr/local/teramind/agent/bin/System Monitoring.app/Contents/MacOS/System Monitoring" geolocation_permissions;sleep 1;killall "System Monitoring"

2. You will see a dialog box with the message, "System Monitoring" would like to use your current location":

3. Click the Allow button. The Geolocation feature will be activated.

Mac Agent 226 - 232

Hidden Agent

There are two permissions required for the Mac Agent to function properly. One is related to Accessibility (that might affect how activities such as web site visits, keystrokes logging etc. are captured in Teramind) and another for Screen Recording (affects screen snapshots, screen recording, OCR etc.).

Follow the steps below to set them up.

image__2___1_.png

1. Click the Search icon from your Mac menu.

2. Type ‘terminal’ in the search box to find the Terminal app. Select the Terminal app and press Enter to run it.

image.png

3. Type the following command on the Terminal window and press Enter:

sudo killall "System Monitoring"; open "/usr/local/teramind/agent/bin/System Monitoring.app" --args permissions

4. A pop-up window similar to the below will appear:

image__1_.png

5. On the Accessibility Access pop-up window, click the Open System Preferences button. This will take you to the Accessibility settings option.

image__4_.png

6. On the Security & Privacy settings window, first click the Lock icon at the bottom to unlock the settings.

7. Then, click the checkmark next to the System Monitoring to grant it the accessibility permission. Do not close this window yet.

image__5_.png

8. On the same Security & Privacy settings window, scroll up/down to find the Screen Recording item on the left. Select it.

9. Click the checkmark next to the System Monitoring to grant it screen recording permission. This will open a pop-up window.

image__6_.png

10. Click the Quit & Reopen button when the system shows, “System Monitoring” will be able to… warning message. The Agent will restart and should work properly from now on.

Revealed Agent

The Revealed Agent will now prompt you to add the permissions. You don't have to use the sudo command anymore. However, you will still have to uncheck and recheck the two permission settings from your System Preferences and restart the agent (see step 5-9 under the Hidden Agent section.

Mac Agent 204 and Earlier

There are two permissions required for the Mac Agent to function properly. One is related to Accessibility (that might affect how activities such as web site visits, keystrokes logging etc. are captured in Teramind) and another for Screen Recording (affects screen snapshots, screen recording, OCR etc.).

Follow the steps below to set them up.

image__2___1_.png

1. Click the Search icon from your Mac menu.

2. Type ‘terminal’ in the search box to find the Terminal app. Select the Terminal app and press Enter to run it.

image-1__2___1___1_.png

3. For the Hidden Agent, type the following command on the Terminal window and press Enter:

sudo killall tmagent; open /usr/local/teramind/agent/bin/tmagent.app --args permissions

For the Revealed Agent, type the following command on the Terminal window and press Enter:

sudo killall tmui; open '/usr/local/teramind/agent/bin/Teramind Agent.app' --args permissions

A pop-up window similar to the below will appear:

image-2__3___1_.png

4. On the Accessibility Access pop-up window, click the Open System Preferences button. This will take you to the Accessibility settings option.

image-3__2___1_.png

5. On the Security & Privacy settings window, first click the Lock icon at the bottom to unlock the settings.

6. Then, click the checkmark next to the Teramind Agent to grant it the accessibility permission. Do not close this window yet.

image-4__2___1_.png

7. On the same Security & Privacy settings window, scroll up/down to find the Screen Recording item on the left. Select it.

8. Click the checkmark next to the Teramind Agent to grant it screen recording permission. This will open a pop-up window.

image-5__1___1_.png

9. Click the Quit Now button when the system shows, “tmagent” will not be able to… warning message. The Agent will restart and should work properly from now on.

Did this answer your question?