configure.html 8.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <html>
  3. <head>
  4. <title>wpa_supplicant configuration wizard</title>
  5. <script type="text/javascript" src="configure.js"></script>
  6. <link rel="stylesheet" type="text/css" href="configure.css" />
  7. </head>
  8. <body>
  9. <div id="navig">
  10. <a href="../">wpa_supplicant</a> /
  11. <a href="index.html">configuration</a> /
  12. wizard
  13. </div>
  14. <h1>wpa_supplicant configuration wizard</h1>
  15. <p><a href="../">wpa_supplicant</a> supports large range of security
  16. modes and authentication types. Just looking at the reference
  17. information of available configuration options may not provide enough
  18. high level understanding to select which options are needed. This page
  19. provides information about configuring wpa_supplicant and a wizard for
  20. generating example configuration files to make it easier to understand
  21. different security policies and how they should be configured for
  22. wpa_supplicant.</p>
  23. <p>The wizard goes through steps to select suitable options based on
  24. your input. An example configuration file is updated at each
  25. step. This example can be seen at the bottom of this page.</p>
  26. <h2>Step 1/5: Operating system and driver</h2>
  27. <p>wpa_supplicant can be used with multiple operating systems and
  28. network drivers. Most of the configuration parameters do not depend on
  29. this, but some of the parameters may need to be changed based on
  30. OS/driver capabilities.</p>
  31. <form name="os_driver">
  32. <select name="os" onChange="configure_os()" onBlur="configure_os()">
  33. <option value="select">Select your operating system</option>
  34. <option value="linux">Linux</option>
  35. <option value="windows">Windows 2000/NT/XP</option>
  36. <option value="bsd">FreeBSD/NetBSD</option>
  37. <option value="other">Other</option>
  38. </select>
  39. <select name="driver" onChange="configure_driver()" disabled="disabled">
  40. </select>
  41. </form>
  42. <div id="os_desc" class="confdesc"></div>
  43. <h2>Step 2/5: Network name</h2>
  44. <p>
  45. Wireless networks have a "network name" (SSID = Service Set
  46. Identifier). This is a sequence of up to 32 characters. This name is
  47. used to select which access points (AP) can be used and as such, it
  48. must match with the SSID configured for the desired AP.
  49. </p>
  50. <p>
  51. Some APs allow SSIDs to be "hidden" which requires that the client is
  52. specifically searching for the configured to SSID to be able to
  53. connect. This may require some additional options in wpa_supplicant
  54. configuration, so enable those here by checking "hidden SSID" if your
  55. AP is configured to hide the SSID. This may show up as "brodcast SSID
  56. disabled" or "hidden SSID" or something similar in the AP
  57. configuration. Hidden SSID configuration does not prevent
  58. wpa_supplicant from connecting to APs that do not hide SSID, so it can
  59. be enabled for all cases.
  60. </p>
  61. <form name="network">
  62. SSID: <input type="text" name="ssid" onChange="update_conf()">
  63. <input type="checkbox" name="hidden_ssid" onChange="update_conf()">hidden SSID
  64. </form>
  65. <h2>Step 3/5: Authentication mode</h2>
  66. <p class="todo">TODO: write explanation for different modes</p>
  67. <form name="authmode">
  68. <select name="auth" onChange="configure_auth()" onBlur="configure_auth()">
  69. <option value="select">Select authentication mode</option>
  70. <option value="open">None (unencrypted, open network)</option>
  71. <option value="wep">None (encrypted network, static WEP keys)</option><
  72. <option value="ieee8021x">IEEE 802.1X/EAP without WPA</option>
  73. <option value="wpa-psk">WPA/WPA2-Personal (PSK) (IEEE 802.11i)</option>
  74. <option value="wpa-eap">WPA/WPA2-Enterprise (EAP) (IEEE 802.11i)</option>
  75. </select>
  76. <select name="auth2" onChange="configure_auth2()" disabled="auth2">
  77. </select>
  78. </form>
  79. <div id="auth_desc" class="confdesc"></div>
  80. <h2>Step 4/5: Encryption</h2>
  81. <p class="todo">TODO: different group cipher for WPA/WPA2</p>
  82. <form name="encrmode">
  83. <select name="encr" onChange="configure_encr()" onBlur="configure_encr()">
  84. <option value="select">Select encryption</option>
  85. <option value="none">None (unencrypted open network)</option>
  86. <option value="wep">WEP (Wired Equivalent Privacy)</option>
  87. <option value="tkip">TKIP (Temporal Key Integrity Protocol)</option>
  88. <option value="ccmp">CCMP (AES Counter-Mode/CBC-MAC Protocol)</option>
  89. </select>
  90. </form>
  91. <div id="encr_desc" class="confdesc"></div>
  92. <h2>Step 5/5: Authentication credentials</h2>
  93. <div id="cred_unknown">
  94. Authentication mode (Step 3) must be selected first.
  95. </div>
  96. <div id="cred_open" class="credlayer">
  97. No credentials needed for open network.
  98. </div>
  99. <div id="cred_wep" class="credlayer">
  100. <p>
  101. Static WEP keys requires that at least one key is configured. Up to
  102. four keys can be configured and one of them needs to be selected to be
  103. used for transmitted frames. All configured keys can be used when
  104. decrypting received frames.
  105. </p>
  106. <p>
  107. WEP can be used with different key length. In most cases, either
  108. 40-bit or 104-bit keys are used. These key lengths may also be shown
  109. as 64-bit and 128-bit in some cases since WEP adds 24-bit
  110. initialization vector into the keys. 40-bit keys can be entered as
  111. five character string surrounded with double quotation marks, e.g.,
  112. "abcde". Alternatively, they can be entered as a hex string of ten
  113. characters without quotation marks, e.g., 6162636465. Both of these
  114. options configure the same key. 104-bit keys are entered similarly,
  115. with 13-character text string or 26-character hex string.
  116. </p>
  117. <p>
  118. wpa_supplicant uses indexes 0 .. 3 for the WEP keys. Some other user
  119. interfaces may use indexes 1 .. 4, so this needs to be taken into
  120. account when determining which index to use here.
  121. </p>
  122. <form name="cred_wep_form">
  123. WEP key 0: <input type="text" name="wep0" onChange="configure_wep()"><br>
  124. WEP key 1: <input type="text" name="wep1" onChange="configure_wep()"><br>
  125. WEP key 2: <input type="text" name="wep2" onChange="configure_wep()"><br>
  126. WEP key 3: <input type="text" name="wep3" onChange="configure_wep()"><br>
  127. Transmit key <select name="wep_tx_idx">
  128. <option value="0">0
  129. <option value="1">1
  130. <option value="2">2
  131. <option value="3">3
  132. </select>
  133. </form>
  134. </div>
  135. <div id="cred_psk" class="credlayer">
  136. <p>
  137. Passphrase (string of 8 to 63 characters) needs to be configured for
  138. WPA/WPA2-Personal. This passphrase is then converted into a 256-bit
  139. pre-shared key (PSK). Alternatively, a 256-bit PSK can be entered as
  140. 64-character hex string into the PSK field. Only one of these options
  141. should be used.
  142. </p>
  143. <form name="cred_psk_form">
  144. Passphrase: <input type="text" name="passphrase" onChange="configure_passphrase()">
  145. PSK: <input type="text" name="psk" size=64 onChange="configure_passphrase()">
  146. </form>
  147. </div>
  148. <div id="cred_eap" class="credlayer">
  149. <p class="todo">TODO: write introduction text for each EAP method</p>
  150. <form name="cred_eap_form">
  151. EAP method: <select name="eap" onChange="update_eap()">
  152. <option value="select">Select EAP method</option>
  153. <option value="TLS">EAP-TLS</option>
  154. <option value="PEAP">EAP-PEAP</option>
  155. <option value="TTLS">EAP-TTLS</option>
  156. <option value="FAST">EAP-FAST</option>
  157. <option value="LEAP">LEAP</option>
  158. <option value="MD5">EAP-MD5</option>
  159. <option value="GTC">EAP-GTC</option>
  160. <option value="OTP">EAP-OTP</option>
  161. <option value="MSCHAPV2">EAP-MSCHAPv2</option>
  162. </select>
  163. Tunneled method (phase 2): <select name="phase2" disabled="disabled" onChange="update_eap2()">
  164. </select><br>
  165. Identity (user name): <input type="text" name="identity" onChange="configure_eap()"><br>
  166. Anonymous identity (user name): <input type="text" name="anon_identity" onChange="configure_eap()" disabled="disabled"><br>
  167. Password: <input type="text" name="password" onChange="configure_eap()" disabled="disabled"><br>
  168. CA certificate: <input type="text" name="ca_cert" onChange="configure_eap()" disabled="disabled"><br>
  169. User certificate: <input type="text" name="client_cert" onChange="configure_eap()" disabled="disabled"><br>
  170. User private key: <input type="text" name="private_key" onChange="configure_eap()" disabled="disabled"><br>
  171. User private key passphrase: <input type="text" name="private_key_passwd" onChange="configure_eap()" disabled="disabled"><br>
  172. EAP-FAST PAC file: <input type="text" name="pac_file" onChange="configure_eap()" disabled="disabled"><br>
  173. </form>
  174. </div>
  175. <div id="cred_desc" class="confdesc"></div>
  176. <h2>Example configuration</h2>
  177. <form>
  178. Configuration example is updated automatically when modifying
  179. information above. However, if it is not updated in some cases (e.g.,
  180. after reloading the page), you can force an update with this button.<br>
  181. <input type="button" value="Update configuration" onClick="update_conf()">
  182. </form>
  183. <p>
  184. This configuration file can be copied to a text file that
  185. wpa_supplicant will then be asked to use with <i>-c&lt;full path to
  186. configuration file&gt;</i> command line option.
  187. </p>
  188. <div id="exampleconf" class="exampleconf">
  189. # example configuration will be generated here<br>
  190. </div>
  191. <br>
  192. <hr>
  193. <address><a href="mailto:j@w1.fi">Jouni Malinen</a></address>
  194. <!-- Created: Sat Feb 25 17:07:35 PST 2006 -->
  195. <!-- hhmts start -->
  196. Last modified: Sun Feb 26 13:47:30 PST 2006
  197. <!-- hhmts end -->
  198. </body>
  199. </html>