Requirements

The customizations for SPIN Safe Browser below are based on the AppConfig standard which allows compatibility with the following MDMs: IBM MaaS360, Jamf, Hexnode, Mobile Iron, VMWare, SOTI, Blackberry, Meraki and SAP.

Requires SPIN Safe Browser + AppConfig version 1.0 or higher.

Features 

Tip: Users can use the Jamf AppConfig Generator to start customizing SPIN. This allows Administrators to easily select the content categories they wish to use, set blocked and allowed lists of websites. 

Additional areas of customization as possible by manually editing the app configuration section of SPIN Safe Browser inside your mobile device management solution. The following features are detailed in this article: 

1. Set and edit default blocking categories
2. Deploying bookmarks 
3. Blocked, allow and allow only websites 
4. Set home page
5. Set New Tab preference
6. Set Search Engine Preferences 
7. Prevent deletion of the browser's browsing History

Policies List

Content Categories

For this policy, we recommend using the AppConfig Generator in order to set your preferred content categories.

Removing the <key>Prohibited Categories</key> section will reset SPIN Safe Browser to its default categories when installed from the App Store.

If you remove one of the categories in the <array> section, all websites from our database for that removed category will be allowed (whitelisted). Be careful with our default list which is recommended for the best safe browsing experience. 

To add another category to filter, simple add another line copy the syntax of <integer>xxxxx</integer>. Refer to our master list of content categories. 

<key>Prohibited Categories</key>
<array>
  <integer>1010</integer>
  <integer>1011</integer>
  <integer>1027</integer>
  <integer>1031</integer>
  <integer>1058</integer>
  <integer>1062</integer>
  <integer>1076</integer>
  <integer>10002</integer>
  <integer>10005</integer>
  <integer>10007</integer>
</array>

Deploying Bookmarks

To deploy a single bookmark to an iOS device, the whole section must be copied as per below (text in red). Using the example below, edit the title of the Bookmark by replacing <string>SPIN Safe Browser</string> with the name of the Bookmark and set the URL by replacing <string>https://spinsafebrowser.com</string> with the website URL.

Bookmarks will then show up in SPIN > Your Library > Bookmarks. Websites with favicons we cannot download will grab the first letter of the bookmark name.

<key>Bookmarks</key>
<array>
  <dict>
  <key>title</key>
        <string>SPIN Safe Browser</string>
  <key>url</key>
        <string>https://spinsafebrowser.com</string>
  <key>favicon</key>
  <string></string>
  </dict>
</array>

Blocked, Allowed and Allow only website lists

For this policy, we recommend using the AppConfig Generator in order to set your preferred content categories.

The Allowed Websites Only key will overwrite any other websites in the Blocked or Allowed websites. 

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>
  <key>Allowed Websites Only</key>
  <array>
        <string>https://nationaledtech.com</string>
  </array>
</dict>

New Tab Homepage

Set the URL for new tabs and Home shortcut. 

The <string>HomePage</string> string under <key>New Tab</key> can be set to the following: 

1. Blank = new tabs open blank ready to enter a URL in address bar
2. Home = Loads pinned websites and recently visited websites
3. HomePage = Home page set under <key>Home Page</key> loads for new tab

Set the URL for the new tab and Home Page by replacing <string>https://spinsafebrowser.com</string>. 

The <key>enforced</key> can be set to <true/> or <false/> which will hide the preferences under the app’s Settings.

<dict>
  <key>New Tab</key>
    <dict>
    <key>Type</key>
        <string>HomePage</string>
        <key>enforced</key>
        <false/>
    </dict>
<key>Home Page</key>
<dict>
    <key>url</key>
    <string>https://spinsafebrowser.com</string>
    <key>enforced</key>
    <false/>
</dict>

Search Engine Preferences

Requires SPIN version 1.0.22

The default search engines options built-in SPIN can be set and enforce with the following parameters. The key Default Search Engine sets the search engine that will be used for all searches from the address bar. The selections can be enters in the field <string>google</string>. The supported values are: google, duckduckgo, ecosia and bing.

Search Suggestions can also be disabled when typing in the address bar. The red coloured text below supports a flag of <false/> or <true/>.

<key>Search Engine</key>
<dict>
<key>Default Search Engine</key>
<string>google</string>
<key>Show Search Suggestions</key>
<false/>
</dict>

Prevent deletion to the browsing History

Requires version 1.0.13

Adding this key will allow administrators to prevent changes by the user under the Data Management area of SPIN Safe Browser. This also prevents the Cache, Cookies, Offline Website Data, Tracking Protection and Downloaded Files toggles from being changed. 

The red coloured text below supports a flag of <false/> or <true/>.

<key>Data Management</key>
    <dict>
    <key>Prevent changes</key>
    <true/>
</dict>

Enable or Disable Pop-Up Windows/Dialogs

Requires version 1.0.15

Some key websites to your organization may require pop-ups to be disabled. By default, SPIN Safe Browser has pop-up blocking enabled. Use this key to enable or disable pop-ups in SPIN Safe Browser. When this is key is used, the user cannot make changes to this preference. 

The red coloured text below supports a flag of <false/> or <true/>.

<key>Block Pop-Up Windows</key>
    <dict>
    <key>Enabled</key>
    <true/>
</dict>

Categories List

Refer to our category list support article here - SPIN Safe Browser Content Category List