In this article

The Mosyle Manager is a Mobile Device Management (MDM) solution designed for Education. In this guide, we will detail the steps to deploy the DNSFilter Roaming Client to your devices.

iOS devices

To deploy the DNSFilter app to iOS devices, follow the steps listed below. NOTE: Applicable only on supervised devices with iOS 11 or higher.

1. Login to Apple School Manager or Apple Business Manager and purchase ‘licenses’ for the DNSFilter Roaming Client. There are no additional cost for these licenses, as the Roaming Client is included as part of the DNSFilter service
2. Login to Mosyle Manager and navigate to Management > Apple Apps and Books. Confirm that the newly purchased licenses from the previous step appear here. Depending on the number of licenses acquired, it could take some time before the licenses appear in Manager. If you don’t see them immediately, please check back later
3. Within Mosyle Manager, navigate to Management > Install App > + Add new profile
4. In the Install Apps profile that appears, click Apps and Books from the installation source drop-down. Then choose your designed license assignment method. Device-based license assignment will assign the app license to the device serial number and will not require the user to login on the device with an Apple ID. User-based license assignment will assign the app license to the user and will require the user to accept the invite to the Apps and Books account and login to the device with the Apple ID. Finally, click the Add Application button and select the DNSFilter - Roaming Client. Choose the locations and users/devices to install the app and click Save
5. Within Mosyle Manager, navigate to Management > DNS Proxy Extension > + Add new profile
6. In the DNS Proxy Extension profile that appears, enter the following details and click Save:

• Profile Name: DNSFilter Roaming Client (Or any other name of choice)
• App Bundle ID: com.DNSFilter.public.app
• Provider Bundle ID: com.DNSFilter.public.app.extension
• Provider Configuration: Paste the code below and replace KEY-HERE with your Site Secret Key

<dict>
<key>site_key</key>
<string>KEY-HERE</string>
</dict>

• Profile Assignment: Select the locations and users/devices to install the profile and click Save

7. The DNSFilter Roaming Client and associated configuration will be automatically deployed to all devices which are managed by Mosyle Manager
8. After the DNSFilter Roaming Client is available on the device, launch the app and tap the Register This Device button to automatically register the device and begin filtering

macOS devices

To deploy the DNSFilter Agent to iOS devices, follow the steps listed below.

1. Login to Mosyle Manager and navigate to Management > Custom Commands > + Add new profile
2. In the Custom Commands profile that appears, enter the following details and click Save:
   1. Profile Name: DNSFilter Roaming Client (Or any other name of choice)
   2. Choose an Icon: Optionally choose an icon to make it easier to find
   3. Categories Optionally add the command to categories, for organizational purposes
   4. Code:
      1. Choose the correct code block below
      2. Replace Your SITE KEY here with your Site Secret Key
         The Site Key is found in the app at Deployments > Roaming Clients > Install
      3. Paste into Mosyle Manager
   5. Schedule: Choose When saving the profile, to run the installation upon saving or upon enrollment of any new device

Branded DNSFilter MacOS Roaming Client

#!/bin/bash
cd /tmp
curl https://download.dnsfilter.com/User_Agent/MacOS/DNSFilter%20Agent-Installer.pkg -o /tmp/DNSFilter%20Agent-Installer.pkg
echo "Your SITE KEY here" > dns_agent_site_key && installer -dumplog -store -pkg "/tmp/DNSFilter%20Agent-Installer.pkg" -target /

WhiteLabel MSP MacOS Roaming Client

#!/bin/bash
cd /tmp
curl https://download.dnsfilter.com/User_Agent/MacOS/DNS%20Agent-Installer.pkg -o /tmp/DNS%20Agent-Installer.pkg
echo "Your SITE KEY here" > dns_agent_site_key && installer -dumplog -store -pkg "/tmp/DNS%20Agent-Installer.pkg" -target /

The DNSFilter Roaming Client and associated configuration will be automatically deployed to all devices which are managed by Mosyle Manager

After the DNSFilter Roaming Client is installed on the device, the service will automatically register the device and begin filtering