We recommend users to leverage Jamf's AppConfig Generator to easily configure blocked content categories and any blocked or allowed websites you wish to set as part of your SPIN Safe Browser app configuration. Visit Jamf's AppConfig Generator here. 

Current functionality

The AppConfig Generator currently only supports our Content Categories and Blocked/Allowed website formatting. For additional settings such as deploying bookmarks and setting a homepage for a New Tab, refer to our full documentation in the Resources section below. 

Content Categories

Our default list of content categories are set to: 

• Prone to Bad Content (websites that are normally good but may contain sexual or inappropriate content)
• Pornography and Adult Content
• Nudity
• Unsafe Search Engines
• File Sharing / Peer to Peer sites
• VPN and Proxy sites

Each category has a set number to it. By using the AppConfig Generator, there is no need to know these codes but if you are manually editing the plist file, then refer to our Jamf Pro + SPIN Safe Browser (iOS) documentation article on the additional codes for all of the available content categories.

Blocked and Allowed Websites

For this policy, we recommend using the AppConfig Generator in order to set your preferred content categories. In the dropdown, type 'spin' in the drop down list and choose com.nationaledtech.spin/current/appconfig.xml.

URL formatting important when adding a website to the blocked or allowed list. You must include the whole URL: http://example.com. Adding a URL that exists in a currently blocked content category into the Allowed list will overwrite its blocking and be allowed.

Example: https://twitter.com is blocked under the Prone to Bad Content category, adding this URL in the Allowed website list will let users visit https://twitter.com. 

<dict>
  <key>Blocked Websites</key>
  <array>
        <string>https://example1.com</string>
        <string>https://example2.com</string>
  </array>
  <key>Allowed Websites</key>
  <array>
        <string>https://twitter.com</string>
  </array>
</dict>

How to use the exported plist file?

Once you have chose your preferences with the AppConfig Generator, click on Download Plist. The export file will contain the formatting supporting by Mobile Device Management solutions by simply copying and pasting the file's contents. 

Jamf Users

• Jamf Pro, it is required to remove the header information and simply have <plist> at the beginning of your file content.

Remove the first two first lines and rename <plist version="1.0"> to <plist>. The rest of the file's content doesn't require any changes. 

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">

• Jamf School, you can copy the whole contents of the file without any changes and the content categories and any blocked or allowed websites will be applied. 

Resources

SPIN Safe Browser + AppConfig documentation (Jamf example)