Skip to main content

SPIN Safe Browser + AppConfig documentation

JP
Updated

Requirements

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

Requires SPIN Safe Browser + AppConfig version 1.2 or higher.

Features 

Tip: Admins can use the Jamf AppConfig Generator to get their XML file started with content categories, set allowed and blocked websites and then use the additional areas of customization below 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. Content Categories
  2. Deploying Bookmarks 
  3. Blocked, allow and allow only websites 
  4. Allow or Block access to Settings 

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>

 

Allow or Block access to Settings 

Requires version 1.2 or higher

When set to true this policy will block the user from being able to access the Settings area of SPIN Safe Browser. This will not prevent the IT Admin from customizing the preferences within Settings via the policies below. 

This policy supports the following flags: <false/> or <true/>.

<dict>
	<key>Block Settings</key>
    <false/>
</dict>

 

Customize Browsing preferences

Requires version 1.2 or higher

Customize various options under the General > Browsing preferences. 

This policy includes a customization via a True or False flags for the following preferences: 

  • Offer to Open Copied Links
  • Show Link Previews
  • Block Pop-up Windows
  • Block Images
  • Block Opening External Apps 

An enforced key is included to prevent user changes (if the IT Admin doesn't block access to the Settings area).

<key>Browsing Settings</key>
        <dict>
            <key>Offer to Open Copied Links</key>
            <dict>
                <key>enabled</key>
                <false/>
                <key>enforced</key>
                <true/>
            </dict>

            <key>Show Link Previews</key>
            <dict>
                <key>enabled</key>
                <true/>
                <key>enforced</key>
                <true/>
            </dict>

            <key>Block Pop-up Windows</key>
            <dict>
                <key>enabled</key>
                <true/>
                <key>enforced</key>
                <true/>
            </dict>

            <key>Block Images</key>
            <dict>
                <key>enabled</key>
                <true/>
                <key>enforced</key>
                <true/>
            </dict>

            <key>Block Opening External Apps</key>
            <dict>
                <key>disabled</key>
                <false/>
                <key>enforced</key>
                <true/>
            </dict>
        </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 (case sensitive): google, duckduckgo, ecosia and bing.

Search Suggestions can also be disabled when typing in the address bar. Use the following flags: <false/> or <true/>.

<key>Search Engine</key>
<dict>
<key>Default Search Engine</key>
<string>google</string><!-- google, duckduckgo, ecosia, bing -->
<key>Show Search Suggestions</key>
<false/>
</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>

 

Manage Autofills and Password preferences

This key controls how SPIN Safe Browser can safe pre-filled information such as passwords, payment methods and addresses. 

Each policy can also be enforced so the user cannot change it in SPIN Safe Browser. 

<key>Autofills and Passwords</key>
        <dict>
            <key>Save and Fill Addresses</key>
            <dict>
                <key>enabled</key>
                <true/>
                <key>enforced</key>
                <true/>
            </dict>

            <key>Passwords</key>
            <dict>
                <key>Save Passwords</key>
                <dict>
                    <key>enabled</key>
                    <true/>
                    <key>enforced</key>
                    <true/>
                </dict>

                <key>Show in Application Menu</key>
                <dict>
                    <key>enabled</key>
                    <true/>
                    <key>enforced</key>
                    <true/>
                </dict>
            </dict>

            <key>Payment Methods</key>
            <dict>
                <key>Save and Fill Payment Methods</key>
                <dict>
                    <key>enabled</key>
                    <true/>
                    <key>enforced</key>
                    <true/>
                </dict>
            </dict>
        </dict>

 

Data Management - 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>

 

Tracking Protection preferences  

Requires version 1.2 or higher

Control the Tracking Protection preferences

The keys under <key>Enhanced Tracking Protection</key> can be set to <true/> or <false/>. 

Key value for <key>Protection Level</key> can be <string>Standard</string> or <string>Strict</string>

<key>Tracking Protection</key>
       <dict>
           <key>Enhanced Tracking Protection</key>
           <dict>
               <key>enabled</key>
               <true/>
               <key>enforced</key>
               <true/>
           </dict>
           <key>Protection Level</key>
           <dict>
               <key>value</key>
               <string>Standard</string>
               <key>enforced</key>
               <true/>

 

Enable or Disable Pop-Up Windows/Dialogs

Deprecated as of version 1.2

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. 

Set the key>Enabled</key> key to <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

Related articles

Comments

0 comments

Please sign in to leave a comment.

Powered by Zendesk