You are here: Product Documentation > Smoothwall Connect > Smoothwall: Connect Filter for iOS

Installing Smoothwall Connect for iOS

Note: This topic applies to the Edinburgh Release.

To install Smoothwall Connect, do the following:

1. In a text editor, enter the following:

<?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">
<dict>
<key>host</key> <string>Smoothwall System_IP</string>
<key>key</key> <string>pem filename</string>
<key>logOutBackground</key> <true_or_false/>
</dict>
</plist>

where:

• Smoothwall System_IP is your Secure Web Gateway or Unified Threat Management system’s external IP address.
• pem filename is the name of the .pem file downloaded; see Generating Client Keys
• true_or_false — This setting determines if a persistent authorized tunnel established. This enables users to use the iOS multi-tasking function without being logged out.

When set to true, when a user uses the multi-tasking function, they will be required to re-authenticate when browsing again.

When set to false, the connection is left open, allowing the user to return at a later point and continue browsing without re-authenticating.

2. Save the file as settings.plist and close the file.
3. On the device, go to the App store and download Smoothwall iOS.
4. Connect the device to your PC and start iTunes®.
5. In iTunes, select the device in the left hand menu and, on the Apps screen, in the File Sharing area, locate and select Smoothwall iOS.
6. Click the Add… button, locate the settings.plist file and the MobileProxy client key (.pem) file you want and click Choose. The selected files will be copied to Smoothwall iOS on your iOS device immediately.

7. On the device’s Home screen, locate and start Smoothwall iOS.

The Smoothwall iOS Home screen opens.

8. Click the Settings icon.

9. Optionally, configure the following settings:
• Home page — Enter a home page to use on the device
• Search engine — Select a search engine. Currently, the possible options are Google™, Yahoo™, and Bing™.
10. Click Done to save the settings.
11. In a browser on the device, go to www.google.com.

You are prompted to enter a username and password before continuing.

12. Enter a valid Smoothwall System username and password and click Login.
ClosedTroubleshooting Browser User Agents

If a browser on the device displays strange page behavior, for example Google Docs not loading or web sites not being able to determine what browser is being used, you can hard code the browser user agent key.

This setting is not visible by default in the plist file and is only required to work around web site incompatibility with non industry standard browsers.

To hard code a browser user agent:

1. In the plist file, enter the following:

<key>userAgent</key> <string>Mozilla/5.0(iPhone; CPU OS 5_0_1 like Mac X) MobileGuardian/1.0</string> </dict> </plist>

2. Save and close the file. Transfer the file to the device.
3. Locate and start Smoothwall iOS on the device.
4. On the Smoothwall iOS Home screen, click the Settings icon.

The Smoothwall iOS Settings screen appears.

5. Click Refresh to apply the change to the plist file and restart Smoothwall iOS.
6. Click Done.