Skip to main content

Admin Dashboard

Mosyle - iOS Configuration Guide

Note

We support iOS 13.1 and higher.

  1. Open port 81 outbound traffic on the internal network.

  2. All iOS Devices must be enrolled in the Supervised model.

  3. Create an iOS Filtering Policy on the Blocksi Admin Dashboard.

  4. Provide Organization ID and Organization Name to Blocksi Support to authorize use of the iOS filtering application.

To get your organization ID and name

Note

This information must be provided to Blocksi to authorize your organization for iOS filtering.

  1. Sign in to your Apple School Manager account with your Administrator credentials.

  2. Click your account name in the lower left-hand corner, and then click Preferences from the pop-up menu.

  3. Go to Organization Information.

  4. Locate your Organization ID and Company Name.

  5. Send this information to Blocksi and we will add your organization to the approved list of customers who can use our filtering app.

To configure volume purchasing

  1. Sign in to your company’s account at business.apple.com (Apple Business Manager) or school.apple.com (Apple School Manager).

  2. Click your account name in the lower left-hand corner, and then click Preferences from the pop-up menu.

  3. Click Payments and Billing.

  4. Click Download in the Content Tokens section next to the correct server location token under the Apps and Books tab. The token downloads to the Downloads folder on your computer.

  5. Upload the downloaded token to the Mosyle Content (Volume Purchasing) payload. The Blocksi for iPad application should now be available for assignment in the Mosyle app library and appears as a Custom App.

To configure the DNS proxy extension

Note

If DNS Proxy Extension is not listed, click Activate New Profile Type to add this profile type to your Management Profiles in Mosyle.

  1. Go to Management Profiles and click DNS Proxy Extension from the left menu.

    DNS_Proxy_Ext.png
  2. Click Add new profile to create a new DNS Proxy Extension profile.

  3. Give the profile a name. For example, Blocksi for iPad DNS Proxy Ext.

  4. Add com.blocksi.dnsproxy in the App Bundle ID field.

  5. Add com.blocksi.dnsproxy.ext in the Provider Bundle ID field.

  6. Type the following configuration in the Provider Configuration box.

    <plist>

    <dict>

    <key>organizationId</key>

    <string>admin@blocksi-super-admin.com</string>

    <key>adminPassword</key>

    <string>123PasswordExample</string>

    <key>ttl</key>

    <string>60</string>

    <key>userAuthEnabled</key>

    <string>false</string>

    </dict>

    </plist>

    Note

    Update your Blocksi SuperAdmin username. This can be done on the Admin Dashboard > Dashboard Settings > Administrators and Roles page. You may also change the 123Blocksi password string to whatever password you choose or leave as is.

    Note

    Make sure that this provider configuration matches the AppConfig PLIST configuration for the App. You will configure this in the next section of these instructions.

  7. Ensure the Configure per-app DNS checkbox is cleared; if it is not, clear it now.

  8. Select the Enable Variables for this profile checkbox now, if it is not already selected.

  9. Configure Profile Assignment to target devices.

  10. Click Save. The profile should look like this:

    DNS_Proxy_Ext_Profile.png

To configure the app

  1. Go to Management Profiles and click Install App from the left menu.

  2. Click Add new profile.

  3. Give the new profile a name. For example, Blocksi for iPad App.

  4. Select your preferred Assignment Method.

  5. Click the + Add Application button and add the Blocksi for iPad application to the profile.

  6. Click the app icon once the app is added to the App Grid View. The following window opens. Here you need to configure the Per-App Configuration.

    Blocksi_for_iPad_Per_App_Config.png
  7. Clear the Allow user to manually remove this app checkbox.

  8. Select the Prepare and Apply an AppConfig PLIST checkbox. A new text box area appears below it.

  9. Add the following XML/PLIST configuration in the text box area:

    <plist>

    <dict>

    <key>organizationId</key>

    <string>admin@blocksi-super-admin.com</string>

    <key>adminPassword</key>

    <string>123PasswordExample</string>

    <key>ttl</key>

    <string>60</string>

    <key>userAuthEnabled</key>

    <string>false</string>

    </dict>

    Note

    Update your Blocksi SuperAdmin username. This can be done on the Admin Dashboard > Dashboard Settings > Administrators and Roles page. You may also change the 123Blocksi password string to whatever password you choose or leave as is.

    Note

    Make sure that this AppConfig PLIST configuration matches the Provider configuration of the DNS Proxy Extension profile.

  10. Click Configure Per-App VPN, Web Filter or DNS Proxy.

  11. Click the DNS Proxy tab and select the DNS Proxy Extension profile you created for the Blocksi app.

    Blocksi_for_iPad_Per_App_Config_Profile.png
  12. Click Confirm.

The deployment configuration is now complete. All you need to do now is verify that the configuration is correctly installed on the target enrolled devices.

To validate the app installation

  1. Verify the app is installed on the target device.

  2. Open the app. You should see a page with a green check mark and the following text: Everything is OK.

    Everything_OK.png
  3. Click the Details button and type the Admin password configured in plist to verify the configurable values.

  4. Open a browser on the iPad device (Safari or Chrome) and verify that the filtering policy you created is working correctly.

  5. Navigate to a site that is set to Allow on the filtering policy: the site opens.

  6. Navigate to a site that is set to Block on the filtering policy. You are presented with the Blocksi Access denied page or a This Connection Is Not Private page.

    Access_Denied_Not_Private.png

To create the filtering policy, please see Configuring the iOS Filtering Policy on the BMEE Admin DashboardConfiguring the iOS Filtering Policy on the BMEE Admin Dashboard