d23ef6c84e1adf79399bf38b6588def2a06d95c0
[bcm963xx.git] / userapps / broadcom / cfm / html / tutorial_addclient.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <!--
3    (c) 2004-2005 U.S. Robotics Corporation.
4 -->
5 <html>
6 <head>
7         <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
8         <title>How to Add a New Client Tutorial</title>
9         <link href="usr_main.css" rel="stylesheet" type="text/css">
10         <link href="usr_menus.css" rel="stylesheet" type="text/css"><script src="usr_menus.js" type="text/javascript"></script><script src="usr_menus_build.js" type="text/javascript"></script>
11         <script src="usr_common.js" type="text/javascript"></script>
12 <script type="text/javascript">
13 setPageTitle("<%ejGetWlJS(wlInterface)%>");
14
15 function initializePage()
16 {
17         initializeSecurity("<%ejGetWlJS(wlAuthMode)%>", "<%ejGetWlJS(wlWep)%>");
18
19         switch ("<%ejGetWlJS(wlFltMacMode)%>")
20         {
21                 case "disabled":
22                         break;
23
24                 case "allow":
25                         setVisibility("idMACfiltering", true);
26                         setVisibility("idMACallow1", true);
27                         setVisibility("idMACallow2", true);
28                         break;
29
30                 case "deny":
31                         setVisibility("idMACfiltering", true);
32                         setVisibility("idMACdeny1", true);
33                         setVisibility("idMACdeny2", true);
34                         break;
35
36                 default:
37                         break;
38         }
39
40         if ("<%ejGetWlJS(wlHide)%>" == "0")
41                 setVisibility("idSSIDbon", true);
42         else
43                 setVisibility("idSSIDboff", true);
44
45
46         switch ("<%ejGetWlJS(wlAuthMode)%>")
47         {
48                 case "open":
49                 case "shared":
50                         if ("<%ejGetWlJS(wlWep)%>" == "enabled")
51                                 setVisibility("idAuthWEP", true);
52                         else
53                                 setVisibility("idAuthNone", true);
54                         break;
55
56                 case "psk":
57                 case "psk2":
58                 case "psk2mix":
59                         setVisibility("idAuthWPA", true);
60                         break;
61
62                 case "wpa":
63                 case "wpa2":
64                 case "wpa2mix":
65                 case "radius":
66                         setVisibility("idAuthRADIUS", true);
67                         break;
68
69                 default:
70                         setVisibility("idAuthNone", true);
71                         break;
72         }
73 }
74 </script>
75 <style type="text/css">
76 .clsHighlight
77 {
78         font-weight:            bold;
79         background-color:       #FEFAF2;
80         border:                         1px solid silver;
81         padding:                                0 0.2em;
82         text-align:                     center;
83         line-height:            150%;
84 }
85
86 DIV#idPanelHelp
87 {
88         float:                  right;
89         width:                  30%;
90         margin-left:    0.3em;
91         margin-bottom:  0.3em;
92         padding:                        0.5em 0.3em 1em 1em;
93
94         background-color:       #FEFAF2;
95         border:                         1px dashed gray;
96 }
97
98 DIV#idPanelHelp H1
99 {
100         font-family:    Verdana, Arial, sans-serif;
101         font-size:              small;
102 }
103
104 DIV#idPanelHelp P
105 {
106         font-family:    Georgia, Times New Roman, serif;
107 }
108 </style>
109 </head>
110
111 <body onload="initializePage();">
112
113 <script type="text/javascript">
114         writeHeaderInfo("Tutorial");
115 </script>
116
117 <h3>How do I add a new wireless client to my network?</h3>
118
119 <p class="clsNote"><a href="javascript:print();">Print this page</a></p>
120
121 <p>When you add a new wireless client to an existing network, there are certain
122 pieces of information you need to have. The router may provide some of this
123 information to the client automatically, but if it doesn&rsquo;t, you
124 will have to enter it yourself.</p>
125
126 <p>When you install a wireless adapter in a computer running Windows,
127 it usually comes with a utility that is installed on the computer and
128 displays an icon in the taskbar&rsquo;s notification area.
129 Windows&nbsp;XP also provides its own mechanism for managing wireless adapters.
130 One thing all wireless devices have in common is that they have some way to
131 configure the wireless connection.</p>
132
133 <p>Although there are many different wireless devices, they use almost identical
134 terms for the information they require to establish a wireless connection.</p>
135
136
137 <div id="idPanelHelp">
138
139         <h1>Client Reference Sheet</h1>
140
141         <table border="0">
142                 <tr>
143                         <td><label>Network&nbsp;name:</label></td>
144                         <td class="clsStatic"><%ejGetWlHTML(wlSsid)%></td>
145                 </tr>
146
147                 <tr>
148                         <td><label>Method:</label></td>
149                         <td class="clsStatic"><script type="text/javascript">document.write(getSecurityMethod("<%ejGetWlJS(wlAuthMode)%>", "<%ejGetWlJS(wlWep)%>"));</script></td>
150                 </tr>
151
152                 <tr id="idEncrypt" style="display: none;">
153                         <td><label>Encryption:</label></td>
154                 <td class="clsStatic"><script type="text/javascript">document.write(getEncryption("<%ejGetWlJS(wlWpa)%>"));</script></td>
155                 </tr>
156                 <tr id="idKeyWPA" style="display: none;">
157                         <td><label>Pass phrase:</label></td>
158                         <td class="clsStatic"><%ejGetWlHTML(wlWpaPsk)%></td>
159                 </tr>
160
161                 <tr id="idKey8021x1" style="display: none;">
162                         <td><label>RADIUS server:</label></td>
163                         <td class="clsStatic"><%ejGetWlHTML(wlRadiusServerIP)%></td>
164                 </tr>
165                 <tr id="idKey8021x2" style="display: none;">
166                         <td><label>RADIUS port:</label></td>
167                         <td class="clsStatic"><%ejGetWlHTML(wlRadiusPort)%></td>
168                 </tr>
169                 <tr id="idKey8021x3" style="display: none;">
170                         <td><label>RADIUS key:</label></td>
171                         <td class="clsStatic"><%ejGetWlHTML(wlRadiusKey)%></td>
172                 </tr>
173
174                 <tr valign="top" id="idKeyWEP" style="display: none;">
175                         <td rowspan="4">Keys:</label></td>
176                         <td class="clsStatic"><script type="text/javascript">document.write(getWEPkey("<%ejGetWlJS(wlKeyIndex)%>", "<%ejGetWlJS(wlKey1)%>", "<%ejGetWlJS(wlKey2)%>", "<%ejGetWlJS(wlKey3)%>", "<%ejGetWlJS(wlKey4)%>"));</script></td>
177                 </tr>
178         </table>
179
180         <!-- MAC filtering on? -->
181         <p id="idMACallow1" style="display: none;">MAC filtering is allowing only specified devices.</p>
182         <p id="idMACdeny1" style="display: none;">MAC filtering is denying only specified devices.</p>
183 </div>
184
185
186 <h3>1. Network name (SSID)</h3>
187
188 <p>The first thing a wireless client needs to know is the network name or SSID,
189 which is set on the router.</p>
190
191 <p>The network name of this router is <span class="clsHighlight"><%ejGetWlHTML(wlSsid)%></span>.</p>
192
193 <!-- SSID BROADCAST? -->
194 <p id="idSSIDbon" style="display: none;">Since the router is broadcasting its network name,
195 you don&rsquo;t have to enter it into the wireless device&rsquo;s utility.
196 You should be able to perform a &ldquo;site survey&rdquo; or &ldquo;scan&rdquo; and the
197 utility will indicate that it&rsquo;s found the router&rsquo;s network name.</p>
198 <p id="idSSIDboff" style="display: none;">The router is not broadcasting its network name,
199 so you will need to enter it into the wireless device&rsquo;s utility. Most utilities
200 are different, but there is usually a mechanism for creating a &ldquo;profile&rdquo;
201 and entering the necessary information.</p>
202
203
204 <h3>2. Security</h3>
205
206 <p>In order for a wireless client to communicate with a router using security,
207 it must use the same method.
208 Security for wireless communication consists of an authentication method (which controls
209 which devices can connect to the router) and an encryption method (which prevents someone from
210 &ldquo;reading&rdquo; the data being sent between a wireless client and the router.</p>
211
212 <!-- Display appropriate security paragraph -->
213 <!--    No security -->
214         <p id="idAuthNone" style="display: none;">The router is insecure, so the client device may already be able to connect to it.</p>
215 <!--    WEP -->
216         <p id="idAuthWEP" style="display: none;">
217         The router&rsquo;s authentication method is <span class="clsHighlight">
218         <script type="text/javascript">
219                 document.write(getSecurityMethod("<%ejGetWlJS(wlAuthMode)%>", "<%ejGetWlJS(wlWep)%>"));
220         </script>
221         </span>.
222         The encryption method is <span class="clsHighlight">WEP</span> and
223         the encryption key is <span class="clsHighlight">
224         <script type="text/javascript">
225                 document.write(getWEPkey("<%ejGetWlJS(wlKeyIndex)%>", "<%ejGetWlJS(wlKey1)%>", "<%ejGetWlJS(wlKey2)%>", "<%ejGetWlJS(wlKey3)%>", "<%ejGetWlJS(wlKey4)%>") + "<\/span>.");
226         </script>
227         You may also need to select the type of encryption key, which is <span class="clsHighlight">
228         <script type="text/javascript">
229                 document.write(getWEPkeyType(getWEPkey("<%ejGetWlJS(wlKeyIndex)%>", "<%ejGetWlJS(wlKey1)%>", "<%ejGetWlJS(wlKey2)%>", "<%ejGetWlJS(wlKey3)%>", "<%ejGetWlJS(wlKey4)%>")) + "<\/span>.<\/p>");
230         </script>
231 <!--    WPA PSK -->
232         <p id="idAuthWPA" style="display: none;">
233         The router&rsquo;s authentication method is <span class="clsHighlight">
234         <script type="text/javascript">
235                 document.write(getSecurityMethod("<%ejGetWlJS(wlAuthMode)%>", "<%ejGetWlJS(wlWep)%>") + "<\/span>,");
236         </script>
237         the encryption method is <span class="clsHighlight">
238         <script type="text/javascript">
239                 document.write(getEncryption("<%ejGetWlJS(wlWpa)%>") + "<\/span>,");
240         </script>
241         and the encryption key is <span class="clsHighlight"><%ejGetWlHTML(wlWpaPsk)%></span>.</p>
242 <!--    802.1X/RADIUS -->
243         <p id="idAuthRADIUS" style="display: none;">
244         The router&rsquo;s authentication method is <span class="clsHighlight">
245         <script type="text/javascript">
246                 document.write(getSecurityMethod("<%ejGetWlJS(wlAuthMode)%>", "<%ejGetWlJS(wlWep)%>") + "<\/span>;");
247         </script>
248         the RADIUS server is <span class="clsHighlight"><%ejGetWlHTML(wlRadiusServerIP)%></span>;
249         the RADIUS port is <span class="clsHighlight"><%ejGetWlHTML(wlRadiusPort)%></span>;
250         the RADIUS key is <span class="clsHighlight"><%ejGetWlHTML(wlRadiusKey)%></span>.</p>
251
252
253 <!-- Only display this section if MAC filtering is enabled -->
254 <div id="idMACfiltering" style="display: none;">
255 <h3>3. MAC Filtering</h3>
256
257         <!-- MAC filtering on? -->
258         <div id="idMACallow2" style="display: none;">
259                 <p>Since this router has MAC filtering enabled and is allowing only certain
260                 wireless devices to connect, you need to ensure that the client device&rsquo;s
261                 MAC address is permitted to connect to the router.</p>
262                 <p>One way to do this is to turn off MAC filtering and configure the client
263                 device to connect to the router. After that&rsquo;s completed, you can use
264                 the router&rsquo;s <strong>Allow Current Clients</strong> feature to
265                 automatically add the new client to the list of allowed devices and re-enable MAC filtering.</p>
266         </div>
267         <p id="idMACdeny2" style="display: none;">
268         Since this router has MAC filtering enabled and is denying certain wireless
269         devices the ability to connect, you need to ensure that the client device&rsquo;s
270         MAC address is not in the list of devices to be denied.</p>
271
272 <p>A MAC address is a set of six bytes typically separated by colons or dashes or spaces.
273 (A byte consists of two hexadecimal digits&mdash;0-9 and A-F.)
274 For example: &ldquo;<label>00:C0:49:AA:22:43</label>.&rdquo;</p>
275
276 <p>These are some ways you may be able to determine the client device&rsquo;s MAC address:
277 <ul>
278         <li>The MAC address is typically displayed on the device itself or on the device&rsquo;s packaging.</li>
279         <li>If the device is running Windows XP, 2000, or NT and you&rsquo;re familiar with the command prompt,
280         you can use the &ldquo;ipconfig /all&rdquo; command to display the MAC address.</li>
281         <li>If the device is running Windows Me, 98, or 95 and you&rsquo;re familiar with the command prompt,
282         you can use the &ldquo;winipcfg&rdquo; command to display the MAC address.</li>
283         <li>The device&rsquo;s wireless configuration utility typically displays the MAC address somewhere.</li>
284 </ul>
285 </p>
286
287 <p>You can configure MAC filtering on the <a href="wlmacflt.cmd">Security</a> page.</p>
288 </div>
289
290 <h3>Troubleshooting</h3>
291
292 <p>If a wireless device cannot connect, the wrong encryption method may be
293 selected or the key may be entered incorrectly.
294 Double-check the device&rsquo;s wireless configuration utility to ensure
295 you&rsquo;ve entered everything correctly.
296 Make sure the wireless device has &ldquo;Infrastructure&rdquo; selected as the network type.
297 </p>
298
299 <p>You should also make certain that the router and client device are positioned so that their
300 transmissions can reach each other.
301 If possible, try to configure them when they are positioned next to each other.</p>
302
303 <!-- MAC filtering on? -->
304         <p id="idMACallow3" style="display: none;">Since this router has
305         <span class="clsHighlight">MAC filtering configured to allow only certain devices</span>
306         to connect, the client device&rsquo;s MAC address might not be in the list of
307         devices permitted to connect to the router.
308         You can configure MAC filtering on the <a href="wlmacflt.cmd">Security</a> page.</p>
309         <p id="idMACdeny3" style="display: none;">Since this router has
310         <span class="clsHighlight">MAC filtering configured to deny certain devices</span>,
311         the client device&rsquo;s MAC address might be in the list of devices to be denied.
312         You can configure MAC filtering on the <a href="wlmacflt.cmd">Security</a> page.</p>
313
314
315 <p class="clsNote"><a href="info.html">Back to the Status page</a></p>
316
317
318 <script type="text/javascript">
319         writeFooter();
320 </script>
321
322 </body>
323 </html>