Features/WPA-WPA2-Enterprise-Network-Connections

Summary
This feature helps connect to WPA/WPA2-Enterprise Networks, in a sugar-environment.

Owner

 * Name: Ajay Garg,  Anish Mangal,  Sascha Silbe
 * Email: ajay@activitycentral.com, anish@activitycentral.com, silbe@activitycentral.com

Current status

 * Targeted release: Not Specified
 * Last updated: December 14, 2011
 * Percentage of completion: 100% (tentative, subject to LEAP-authentication testing. Codewise, it seems to be complete. Obviously, any bugs/enhancements are not being considered here).

Detailed Description
WPA/WPA2-Enterprise Networks are just another kind of networks, requiring secured-authentication. This feature helps connect to such networks, which require authentication following the RADIUS protocol.

Benefit to Sugar
This is an extension to the sugar-capability, to connect to wireless-networks. This feature has been originally requested from Australia deployment.

Scope
This is an isolated change. Non-completion of this feature will just prevent the users from connecting to WPA/WPA2-Enterprise networks.

UI Design
There is no impact on the workflow; it's just that the user will have to enter way more parameters for conencting to a WPA/WPA2-Enterprise networks. Please see "User Experience" section for details.

User Experience

 * The network-icon for a WPA/WPA2-Enterprise Network, will appear just like any other network-icon, in the Neighbourhood-view.
 * When a user clicks on the icon, she will be asked for parameters-cum-secrets (much more in number, but just like any other network-type).
 * Upon clicking the 'ok' button (and provided all sufficient-and-correct parameters are provided), the connection will be made. This can be confirmed by the tray-icon.
 * Once a connection is made, user need not re-enter parameters-cum-secrets next time (reboot) onwards. The parameters-cum-secrets will automatically be read from sugar-settings-file (connections.cfg) (just like any other network-type).

Use-Cases That need to pass (thanks Sridhar Dhanapalan for the exhaustive list)

 * Network should connect, provided the credentials are correct (base-case).
 * Thereafter,
 * network should auto-connect, when XO reboots.
 * network should auto-connect, when XO resumes from being suspended.
 * network should auto-connect, when XO wakes up from Automatic Power Management.
 * network should auto-connect, when the wirless radio is turned off, and then turned on again.

Dependencies
There are no external dependencies. This feature is just an addon, with just another network-type being added to the list of "connectable" networks.

Contingency Plan
None necessary, revert to previous release behaviour.

Documentation
Discussions are on, on the "sugar-devel-" and "dextrose-" mailing lists.

Release Notes
There are no changes in ABIs/APIs, configuration or data file formats. Also, there are no upgrade concerns.

Comments and Discussion

 * See |discussion tab for this feature