Features/Proxy Settings

Summary
Allow the user to configure proxy settings using the Sugar Control Panel.

Owner
Sascha Silbe, Ajay Garg (ajay@activitycentral.com)

Current status

 * Targeted release: 0.99
 * Last updated: 2013-02-17
 * Percentage of completion: 100%

Detailed Description
Both individual users and deployments need to be able to set a proxy for Sugar and activities to use. While we'd like the system to work that all out automatically (e.g. using WPAD), this often isn't possible. Common reasons include legacy ("inherited") setups and network uplinks simply being out of control of the user respectively deployment.

The existing Network Control Panel is enhanced by adding a new section for the proxy settings. For consistency between Sugar and Gnome, the basic layout of the Gnome 3 proxy settings has been mirrored: A combo box allows the user to select how the proxy setting should be determined (None=direct connection, Automatic=WPAD or PAC, Manual=enter host names and ports for each protocol). Based on which method was selected, additional configuration options are presented to the user.

The settings are stored via "gconf" as well as "dconf" (gsettings).

Benefit to Sugar
See Detailed Description.

Scope
Modifying the existing Network Control Panel.

"Manual" mode

 * Fill in the settings "manually", and restart when prompted so.
 * proxy21.png


 * Now, open Browse. "www.facebook.com" should be blacklisted.
 * proxy5.png


 * "www.google.com" shoud be allowed.
 * proxy4.png

Automatic mode - PAC

 * Fill in the URL of the proxy-file, and restart when prompted so.
 * proxy24.png


 * Now, open Browse. "www.facebook.com" should be blacklisted.
 * proxy5.png


 * "www.google.com" shoud be allowed.
 * proxy4.png

Automatic mode - WPAD

 * Motive
 * To provide proxy-configuration, without needing the client-user
 * to manualyy enter the proxy-settings (Manual mode)
 * to manually enter the location of proxy-configuration file herself (Automatic (PAC) mode).


 * Benefits
 * By not needing the client-user to manually specify the settings, every client-user is saved a headache :) Instead, all the configuration is done via a network-administrator, on the server-side.
 * By delegating the responsibility of specifying every proxy-rule (even the proxy-configuration file) to the network-administrator, security is increased dramatically.


 * Notes
 * Setting this particular mode (Automatic-WPAD Proxy) is quite complicated; and many possibilities exist. However, the bottom-rule is, client should himself not need to specifiy the location of proxy-configuration file as per say.


 * Testing (one of the possible ways :) )
 * (For those not interested in the technicalities, please proceed to the next bullet :D) To verify that current dextrose-4 supports Auto-WPAD mode, we test using the method, as per the following 4 requirements, as listed at http://en.wikipedia.org/wiki/Web_Proxy_Autodiscovery_Protocol#Requirements ::
 * In order to use the DNS only method, a DNS entry is needed for a host named WPAD.
 * The host at the WPAD address must be able to serve a Web page.
 * In both cases, the Web server must be configured to serve the WPAD file with a MIME type of "application/x-ns-proxy-autoconfig".
 * If the DNS method is used, a file named wpad.dat must be located in the WPAD Web site's root directory.


 * Select "Automatic" mode in "My Settings" -> "Proxy" (without specifying anything else), and restart when prompted so.
 * proxy1.png


 * The above step is all that is needed for "Automatic (WPAD)" mode to take effect; the WPAD-configuration-file will be located by the DHCP/DNS Server. However, for easy QA testing,  we specify an easy way to replicate this DNS behavior ::


 * Add the line "build.activitycentral.com wpad" to the file "/etc/hosts" on the XO, and reboot. It is repeated innumerable times, that this step is required just for easy testing; in actual deployments, the DNS-name resolution will be provided by network-administrators/School-Server-running-DHCPD
 * Also, thanks a ton to Santiago Rodriguez (scollazo@activitycentral.com) for setting up the proxy-configuration-files at build.activitycentral.com.


 * Open "Browse", and type in "www.google.com". You should be prompted for credentials (as is required by the WPAD-configuration-file at build.activitycentral.com


 * proxy2.png


 * Entering wrong credentials in the previous step, re-prompts :). This time, enter correct credentials.
 * proxy3.png


 * The page opens successfully.
 * proxy4.png


 * Next, type "www.facebook.com"; the "Access Denied" page is shown instantaneously, as per the rule in the WPAD-configuration-file at build.activitycentral.com
 * proxy5.png


 * NOTE: The proxy setup will persist even if a user switches to Gnome Desktop, because the way it is setup, is the natural way gnome does too ( GCONF ) (Thanks Ariel).

User Experience
See UI Design

Dependencies
There are no new dependencies.

Contingency Plan
Users can continue to use the Gnome Control Center to configure proxy settings.

Documentation
There is no documentation beyond this page.

Release Notes
There have been no changes to public API. The Release Notes merely need to mention that users can now configure proxy settings from within Sugar. As detailed above, the UI is very similar to the Gnome UI.

Comments and Discussion

 * See |discussion tab for this feature