Block access to web content outside of Smoothwall Browser on iPads and iPhones

Smoothwall Browser only applies your Web Filter Policies within itself and can’t filter content in other web browsing apps, such as link previews in word processors.

To stop links and content from opening in other apps, install Smoothwall's Content Filter Plugin. The end user won’t be able to access the site, and will see a message that says: ‘Restricted Site: You cannot browse this page at “URL” because it is restricted.’

Before you begin

• The device must be a supervised device with Smoothwall Browser installed.
• Your MDM supports creating Web Content Filters or deploying a manually created profile from Apple Configurator.

Install the Content Filter Plugin

1. In Apple Configurator, create a new profile or open an existing profile.
   

     Tip

   If you use a different MDM, refer to the provider’s documentation to create a profile and install it.

2. Go to Content Filter > Configure.
3. For the Filter Type, select Plugin (Third Party App).
4. Fill in the fields as required:
   • For Identifier, enter Smoothwall Browser's Bundle ID: com.smoothwall.ios.Firefox
   • Do not select or fill in the Service Address, Organization, User Name, Password, Certificate and Custom Data fields.
   • Ensure the Filter WebKit Traffic checkbox is selected.
   • Deselect the Filter Socket Traffic checkbox.
5. Save the profile by going to File > Save.
6. Install the configuration profile.

Set custom filter rules

Some apps display content using an internal web browser without allowing users to browse the wider internet. By default, the Content Filter Plugin blocks the content, but you can create custom rules to allow specific apps or websites to show their content.

1. In Apple Configurator, open an existing profile.
2. Go to Content Filter > Configure.
3. Enter custom rules in the Custom Data section:
   
   • In the Key column:
     
     • Enter the bundle ID, such as ‘com.example.MathsQuiz’, to set the rule for a specific app.
     • Enter a domain or hostname to set the rule for a specific website.
   • Enter allow or block in the Value column.
4. Deploy the rule changes to devices.

If you have multiple hostnames or apps from the same vendor, you can use a wildcard *. To explicitly block content that might be allowed by a wildcard, set the Value as block.

Order the rules are applied

Rules are applied in this order, regardless of the order of rules in the Custom Data section:

1. If the app is Smoothwall Browser, filtering is applied via your Web Filter Policies.
2. Access is allowed for single sign-on from Google or Microsoft.
3. App-specific custom filter rules.
4. Custom filter rules for apps using a wildcard. If there are multiple matches, the longest is used.
5. Host-specific custom filter rules.
6. Custom filter rules using a wildcard. If there are multiple matches, the longest is used.
7. If no rules match, access to the content is blocked.

Report on blocked and allowed requests

Due to Apple’s restrictions, you can’t report on what content was allowed or blocked by the Content Filter Plugin in Cloud Reports or the On-Premise Appliance Reports and Logs.

If you have a Mac computer, you can use the Console app to view Content Filter Plugin's filtering decisions:

1. Add a custom data rule with Debug as the Key and true as the Value, and deploy the configuration to a test device.
2. Connect the device to the Mac.
3. In the Console app, search the logs for smw.DataFilter