Windows Connect Now–NET - 2

A WINDOWS® RALLY™ SPECIFICATION

Windows Connect Now–NET

Abstract

Microsoft® Windows® Connect Now technology enables simple and secure configuration of wireless networks and provisioning of wireless hardware. Windows Connect Now-NET (WCN‑NET) is the Microsoft implementation of the Simple Configuration Protocol, a new standard in the Wi‑Fi Alliance. WCN‑NET supports configuration of devices on out-of-band Ethernet and in-band wireless networks.

Windows Connect Now-NET in Microsoft Windows Vista™ communicates with access points and wireless stations by using Universal Plug and Play (UPnP), authenticates with them by using a personal identification number (PIN), and provides wireless settings that are based on user selection.

This specification defines the WCN‑NET implementation details for devices that connect with systems running the Windows Vista operating system. WCN‑NET is a component of the Microsoft Windows Rally™ set of technologies.

Version 1.1  December 8, 2006

Disclaimer

This is a preliminary document and may be changed substantially prior to final commercial release of the software described herein.

The information contained in this document represents the current view of Microsoft Corporation on the issues discussed as of the date of publication. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information presented after the date of publication.

This White Paper is for informational purposes only. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS DOCUMENT.

Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of Microsoft Corporation.

Microsoft may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Microsoft, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property.

Unless otherwise noted, the example companies, organizations, products, domain names, e-mail addresses, logos, people, places and events depicted herein are fictitious, and no association with any real company, organization, product, domain name, email address, logo, person, place or event is intended or should be inferred.

© 2006 Microsoft Corporation. All rights reserved.

Microsoft, Rally, Windows, and Windows Vista are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.

The names of actual companies and products mentioned herein may be the trademarks of their respective owners.

The current version of this specification is maintained on the Web at:
              http://www.microsoft.com/rally

Revision History

Contents

Introduction to WCN‑NET              5

WCN‑NET User Experience              5

Entry Points and Flows              5

Set up a Wireless Access Point or Use the Router Wizard              5

Use the Add a Wireless Device Wizard              9

Double-click the Device in Network Explorer              11

User Experience Pamphlet in the Box for Access Points              12

WCN‑NET Architecture              13

Registration in Windows Vista              13

Registration Protocol              14

Summary and Classification of Keys              16

Key Derivation              16

Derivation of AuthKey, KeyWrapKey, and EMSK              17

Message Format              19

Registration Message Attributes              19

Transportation of Registration Protocol Messages              23

UPnP Transport              23

EAP Transport of Registration Protocol              24

EAP Message Framing              25

EAP Message Fragmentation and Reassembly              26

EAP Identity              26

EAP Messages              26

Device Requirements              27

Resources              27

Appendix A              28

Master Table—Data Component Set              28

Master Table Definitions              29

Appendix B. WFADevice:1  Device Template Version 1.01              41

B.1 Overview and Scope              41

B.1.1 Focus and Goals for DCP Version 1.0              42

B.1.2 Non-Goals for DCP Version 1.0              42

B.1.3 WLAN Security Requirements and Recommendations              42

B.1.3.1 Station Parameter Configuration              43

B.2 Device Definitions              44

B.2.1 Device Type              44

B.2.2 Device Model              44

B.2.2.1 Description of Device Requirements              44

B.2.3 Theory of Operation              44

B.2.3.1 WLAN Node Requirements              45

B.2.3.2 Configuration of New Clients to the WLAN              45

B.3 XML Device Description              46

B. 4 Test              47

Appendix C. WFAWLANConfig:1  Service Template Version 1.01              48

C.1 Overview and Scope              49

C.2 Service Modeling Definitions              49

C.2.1 ServiceType              49

C.2.2 State Variables              49

C.2.2.1 Message              50

C.2.2.2 InMessage              50

C.2.2.3 OutMessage              50

C.2.2.4 DeviceInfo              51

C.2.2.5 APSettings              51

C.2.2.6 APStatus              51

C.2.2.7 STASettings              51

C.2.2.8 STAStatus              51

C.2.2.9 WLANEvent              52

C.2.2.10 WLANEventType              52

C.2.2.11 WLANEventMAC              52

C.2.3. Eventing and Moderation              52

C.2.3.1. Event Model              52

C.2.4 Actions              53

C.2.4.1 GetDeviceInfo              53

C.2.4.2 PutMessage              54

C.2.4.3 GetAPSettings              54

C.2.4.4 SetAPSettings              55

C.2.4.5 DelAPSettings              55

C.2.4.6 GetSTASettings              56

C.2.4.7 SetSTASettings              56

C.2.4.8 DelSTASettings              57

C.2.4.9 PutWLANResponse              57

C.2.4.10 SetSelectedRegistrar              58

C.2.4.11 RebootAP              58

C.2.4.12 ResetAP              59

C.2.4.13 RebootSTA              59

C.2.4.14 ResetSTA              60

C.2.4.15 Nonstandard Actions Implemented by a UPnP Vendor              60

C.2.4.16 Common Error Codes              60

C.2.5 Theory of Operation              60

C.2.5.1 Establishing a Registrar with an Access Point and Access Point Management              60

C.2.5.2 Proxy Function              61

C.2.5.3 Initialization and Configuration of the Ethernet-Connected Wireless Device              61

C.3 XML Service Description              62

C.4 Test              66

Introduction to WCN‑NET

Microsoft® Windows® Connect Now technology provides solutions for creating secure wireless networks and adding devices to the network. Specifically, Windows Connect Now‑NET (WCN‑NET) solves two problems that have limited consumer deployment of secure wireless networks:

·         Most users do not realize that the default network configuration is not secure.

·         Many of the remaining users find that the security configuration is too complex.

WCN‑NET solves these problems by providing a user-friendly, simplified, and consistent way to set up secure wireless networks and add devices to the network. This solution works for both out-of-band Ethernet devices and in-band wireless devices

This specification summarizes the architecture and then covers registration in detail:

·         User interface flow

·         Registration Protocol

·         Message format

·         Registration message attributes

·         Transportation of Registration Protocol messages by using universal Plug and Play (UPnP) or Extensible Authentication Protocol (EAP)

Appendix A explains the master table definitions. References and resources discussed in this specification are listed in “Resources” at the end of this specification.

WCN‑NET User Experience

Entry Points and Flows

By using WCN‑NET, device configuration and setup can be done through three entry points:

·         Set up a wireless a...