TABLE OF CONTENTS
1. Introduction
The Backdrop macOS client is a cluster of applications that runs a number of system and user processes.
Once installed and enrolled it provides students with the freedom to explore the internet while empowering teachers to monitor, guide, and assist. The macOS client shares a live stream of the student's device with the teacher and allows them to perform the following actions.
Classroom
- Send Message – Teachers can send a direct one-way message to the device
- Launch Website – Teachers can open a website on the device automatically
- Lock Screens – Teachers can lock the screen of the device
- Internet Access – Teachers can disable internet access in browsers where Impero browser extensions are installed
- Website Lists – Teachers can enforce allow and block website lists in browsers where Impero browser extensions are installed
- Close Application - Teachers can view a list of open applications on the device and can force them to close
- Close Tab – Teachers can view open browser tabs lists and close open tabs in browsers where Impero browser extensions are installed
- Broadcast Screen - Teachers can broadcast their screen to students or broadcast student to student
- Logout Device - Teachers can remotely log out of the Windows device. This returns the student to the Windows login screen and disconnects them from Backdrop
- Google Meets - Teachers can invite the class to a Google Meets session that opens automatically on student devices
- Switch Schools - The Backdrop client has the capability for students to be registered against multiple schools
Wellbeing
- Written words - Monitors typed words and sends captures to Backdrop if keywords are found
- Viewed words - Monitors viewed words across the OS and sends captures to Backdrop if keywords are found
1.1. System Requirements
The minimum system requirements for the client are:
- macOS 11 or Higher (macOS Big Sur)
- Google Chrome or Microsoft Edge (v77+ chromium)
- Install Rosetta (Silicon Macs)
1.2. macOS 11 supported devices
https://support.apple.com/en-gb/HT211238
1.3. Browser Extensions
Browser Extensions are required to perform the following actions and need to be installed to provide the full set of Classroom functionality.
- Block Internet Access.
- Allow/Block Website Lists.
- View/Close browser tabs.
For more details on browser extensions, click on the following link:
To download the Chrome Extension, click on the following link:
1.4. Download Backdrop macOS Client
To download the macOS Client, click on the following link:
1.5. Release Notes - v2.2.49 - 22 Aug 2024
- Improvement to Single Device View load time
- Improvements to keyword capture frequency
- Improvement to logging captured
- Adding version number to app menu
- Podfile updates
The macOS client changelog can be found at the following link: MacOS Client Change Log/Release Notes
2. Installation
The following installation guides describe the process of installing the Backdrop macOS client.
2.1. Single Device Installation via Installer
1. Double click the Impero.pkg to begin the installation process.
2. The "Welcome to the Impero Installer" setup wizard is displayed.
3. Click on "Continue".
4. The Installer displays which disk it will install to and how much disk space it will use. Click on "Install" to begin the installation process.
5. The installer now prompts for the username and password of the local administrator account. Enter these credentials and click on "Install Software".
6. Once the installation has been completed you are prompted to accept the "System Events" permission. This allows Backdrop to remotely log out the user from the device. Click on "OK" to this message.
7. Now that installation has been completed, click on "Close" on the Installer wizard.
8. The school code registration form automatically appears once the macOS client has started running.
9. Enter the school code the device is provisioning against and click on "Next".
(The school code is a 6 character alphanumeric code and can be found on the Administration page of your Backdrop school).
10. The user login screen appears next. You see the name of the school you have provisioned against displayed. Enter the credentials to log a student in, found under "Access Details" on the student profile or "Login Details" under Administration.
If you are using automatic login identifiers then step 10 is skipped.
2.2. Mass Deployment Requirements
Mass deployment is the process of installing the Backdrop macOS client to many devices in a single action and providing school code details so that the client can connect to correct school without user interaction. The following lists the requirements needed to perform mass deployment of the macOS client.
You will need two components to complete the deployment
1. Application to deploy (.pkg or .dmg format)
2. Preference file (.plist format)
The application can be downloaded above. It will need to be added to your deployment tool so that it can push it out to your devices and users. Depending on the deployment tool used a .pkg or .dmg is required but not both. Consult your deployment tool documentation for guidance.
Example of adding the application to Microsoft Intune.
While setting up the application for deployment you may be asked to add a preference file or managed configuration for the app to define settings. The Preference file gives the application your school code so it does not need to be entered manually on the device. Add the preference file (example below) so it can be deployed with the app and enroll the device in the correct school.
If you were not asked to add the preference file during application setup then it will need to be added elsewhere, likely a device configuration profile. Consult your deployment tool documentation for guidance. In order to link this profile to the correct app you will need to enter the app Bundle ID below.
Bundle ID: com.imperosoftware.impero-client-mac
Here is an example of the plist contents from Microsoft Intune. Replace abc123 with your desired school code.
Step-by-step instructions can be found here.
2.3. Permissions
Firewall
If the Mac's firewall is on you might need to add the Impero application in as an exception:
- Open System Preferences.
- Click on the Security or Security & Privacy icon.
- Select the Firewall tab.
- Click on the lock icon in the preference pane, then enter an administrator name and password.
- Click on the Firewall Options button.
- Click on the Add Application (+) button.
- Use the Finder to select the Impero application in the Applications folder.
Permissions
The following permissions will need to be set for the Impero application to run properly
- Impero : Accessibility
- Impero : Screen Recording
- Impero : Automation
Default Browser
Google Chrome must be set as the default browser for Impero application to run properly.
2.3.1 - Screen Recording
The first time a macOS device is viewed in Classroom the Screen Recording permission will be triggered. This permission is required to share the screen of the device. It is a one-time permission that is accepted at the user level meaning each user on the device will get asked the permission individually. The client needs to quit and restart in order to use the permission.
You may be asked to enter your administrator username and password to change system preferences.
3. Uninstallation
The following uninstallation guide describes the process of removing the Backdrop macOS client. Ensure you are logged in with an administrator level account.
1. Download the uninstall tool here
2. Run the tool , it may show you that it cannot be opened until approved
3. Open System Preferences>Security & Privacy>General and allow impero uninstaller
4. The tool will ask for access to system permissions to remove the application, allow them
5. You will be asked to enter the admin password again to confirm uninstall
6. The app is removed
4. Debug Logs
Debug logs can be accessed from the following location.
Users/%USERNAME%/Library/ApplicationSupport/Impero/Logs/
5. FAQ and Troubleshooting
I am not being prompted to login, is the application working?
If you are using automatic log in you are not prompted to log in to Backdrop. Verify the website to see if you appear in Classroom.
If you are not using automatic log in and you are not prompted to appear. Verify that the Impero process is running in Activity Monitor.
Finally, verify your Internet connection. The software requires an Internet connection to work properly. If you have recently fixed a problem with your Internet connection, it is necessary that you restart your macOS device.
If you are still having problems, double-check that the user has the correct application permissions set as described in the installation steps.
I have checked the logs, the client is struggling to connect to Backdrop?
Double-check that the system has the correct Network Access.
Check that your 3rd party firewalls, MDM solutions, or Webcheck is not blocking the solution.
I can not see the live feed in Backdrop or broadcasting a student's screen does not work?
On the student's macOS device:
Verify that the Screen Recording permission is enabled for the application Impero:
Open System Preferences.
Click on the Security or Security & Privacy icon.
Select the Screen Recording tab.
Click on the lock icon in the preference pane, then enter an administrator name and password.
Click on the Add Application (+) button.
Use the Finder to select the Impero application in the Applications folder.
Verify that your 3rd party firewalls, MDM solutions or Webcheck is not blocking the Impero application.
If the macOS device's firewall is on, you might need to add the Impero application in as an exception:
Open System Preferences.
Click on the Security or Security & Privacy icon.
Select the Firewall tab.
Click on the lock icon in the preference pane, then enter an administrator name and password.
Click on the Firewall Options button.
Click on the Add Application (+) button.
Use the Finder to select the Impero application in the Applications folder.
I have enabled keyword lists against a group the device is in but I can't trigger any captures?
Verify that the Accessibility permission is enabled for the application Impero:
Open System Preferences.
Click on the Security or Security & Privacy icon.
Select the Screen Recording tab.
Click on the lock icon in the preference pane, then enter an administrator name and password.
Click on the Add Application (+) button.
Use the Finder to select the Impero application in the Applications folder.
I have installed on a Silicon Mac but the application doesn't run?
Impero requires that Rosetta is installed for the macOS client to run. If Rosetta is not already installed then you should be promoted to install when you run Impero.
Comments
0 comments
Please sign in to leave a comment.