Install iOS and macOS Roaming Clients using Mosyle Manager
Follow these steps to install the iOS or macOS Roaming Client to Mosyle-managed Apple devices (iPhone; iPad).
Contact Mosyle's support team for questions concerning how to manage apps in their platform.
Before completing any steps to install the iOS or macOS Roaming Client, add a Site to the DNSFilter dashboard to associate the agent with. You will need the Site Secret Key to complete the installation.
Install the iOS Roaming Client
Follow these steps to deploy the iOS Roaming Client on Supervised devices with iOS 11 or higher.
Step one: Prep the app
- From the Apple School or Business Manager, purchase DNSFilter licenses for the agent. There are no additional cost for these licenses; the Roaming Client is included as part of the DNSFilter service
- Navigate to the Mosyle Manager Management page and select Apple Apps and Books
- The licenses purchased in step one should appear. This can take some time depending on the size of the purchase. Continue with the installation process once the licenses populate
- From Management, select Install App
- Select Add new profile
- From the Installation Source drop down menu, select Apps and Books
- Choose your designed license assignment method:
Device-based license assignment: Assigns 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: Assigns 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.
- Select Add Application
- Choose the DNSFilter app
- Add Locations and Users/Devices to install the app
- Save these settings
Step two: Add the Proxy Profile
- From Management, select DNS Proxy Extension
- Add New Profile
- Enter these details:
- 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
- Save these settings
The DNSFilter Roaming Client and associated configuration will be automatically pushed to the devices.
Step three: Deploy the agent
After the DNSFilter Roaming Client is available on the device:
- Launch the app
- Tap Register This Device to begin filtering
Once the app registers it will appear in the DNSFilter dashboard and send DNS queries to the DNS Query Log.
Install the macOS Roaming Client
Follow these steps to deploy the macOS Roaming Client.
- From Mosyle Manager, navigate to Management and select Custom Commands
- Select + Add new profile
- Enter these following details:
- Profile Name: DNSFilter Roaming Client (Or any other name of choice)
- Choose an Icon: Optionally choose an icon to make it easier to find
- Categories Optionally add the command to categories, for organizational purposes
-
Code:
- Choose the correct code block below (Standard or MSP/Whitelabel)
- Replace
Your SITE KEY here
with your Site Secret Key - Paste the edited code block into Mosyle Manager
- Schedule: Choose When saving the profile to run the installation upon saving or upon enrollment of any new device
- Save these settings
Standard 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 -pkg "/tmp/DNSFilter%20Agent-Installer.pkg" -target /
MSP/WhiteLabel 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 -pkg "/tmp/DNS%20Agent-Installer.pkg" -target /
The DNSFilter Roaming Client and associated configuration will be automatically deployed to the devices.
After the DNSFilter Roaming Client is installed on the device, the service will automatically register the device and begin filtering.
Please sign in to leave a comment.
Comments
0 comments