Skip to main content
All CollectionsTroubleshooting and How-ToHow-To Articles
How to configure the macOS permission settings
How to configure the macOS permission settings
A
Written by Arick Disilva
Updated over a month ago

Note that the NetApp extension (that affects both the Network and File permissions) is only supported on macOS 11 (Big Sur) and higher.

The Computer's Details screen shows what permissions are currently enabled/disabled. You can also use the API to get the computers' details. For more information, check out this article.

Revealed Agent (v0.1.233 and later, released after January 2022)

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 the Accessibility Access window will pop up:

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 0.1.234 and Newer

This permission is only supported on macOS 11 (Big Sur) and higher.

1. To monitor network activities, you will need to enable a 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 System Extension Blocked 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

This permission is only supported on macOS 11 (Big Sur) and higher.

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 System Extension Blocked 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 data, 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.

Revealed Agent (v0.1.226 to v0.1.232, released between May to December 2022)

The Revealed Agent will prompt you to add the permissions. You don't have to use the sudo command. However, you will still have to uncheck and recheck the two permission settings from your System Preferences and restart the Agent.

Hidden Agent (v0.1.233 and later, released after January 2022)

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 -n "/usr/local/teramind/agent/bin/System Monitoring.app" --args permissions

The Accessibility Access window will pop up:

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 then 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 Preferences 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 permission.

Network Monitoring Permission

For Agent Version 0.1.234 and Newer

This permission is only supported on macOS 11 (Big Sur) and higher.

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"

You will see the System Extension Blocked 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

This permission is only supported on macOS 11 (Big Sur) and higher.

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 data, 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.

Hidden Agent (v0.1.226 to v0.1.232, released between May to December 2022)

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.

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

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

The Accessibility Access window will pop up:

4. On the Accessibility Access window, click the Open System Preferences button. This will take you to the Security & Privacy settings:

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

6. Click the Accessibility option on the left panel.

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

8. On the same Security & Privacy settings window, scroll up/down on the left panel to find the Screen Recording option and click it.

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

10. Click the Quit & Reopen button when the system shows, “System Monitoring” will be able to record the contents of your screen until it is quit. warning message. The Agent will restart and should work properly from now on.

Mac Agent v0.1.204 and earlier, released prior to May 2020

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

The Accessibility Access window will pop up:

image-2__3___1_.png

4. On the Accessibility Access window, click the Open System Preferences button. This will take you to the Security & Privacy settings:

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

6. Click the Accessibility option on the left panel.

7. Click the checkmark next to the Teramind Agent to grant it the accessibility permission. Do not close this window yet.

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

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

10. Click the Quit Now button when the system shows, “tmagent” will not be able to record the contents of your screen until it is quit. warning message. The Agent will restart and should work properly from now on.

Did this answer your question?