www/hostapd/index.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
   2 <html>
   3   <head>
   4     <title>hostapd: IEEE 802.11 AP, IEEE 802.1X/WPA/WPA2/EAP/RADIUS Authenticator</title>
   5     <meta name="description" content="hostapd (IEEE 802.1X, WPA, WPA2, RSN, IEEE 802.11i Authenticator and RADIUS authentication server)">
   6     <meta name="keywords" content="WPA, WPA2, IEEE 802.11i, IEEE 802.1X, WPA Authenticator, hostapd, TKIP, CCMP, EAP-PEAP, EAP-TLS, EAP-TTLS, EAP-SIM, EAP-AKA, EAP-GTC, EAP-MSCHAPv2, EAP-MD5, EAP-PAX, EAP-PSK, EAP-FAST, IEEE 802.1X Supplicant, IEEE 802.1aa, EAPOL, RSN, pre-authentication, PMKSA caching, BSD WPA Authenticator, FreeBSD WPA Authenticator, RADIUS authentication server, EAP authenticator, EAP server, EAP-TNC, TNCS, IF-IMV, IF-TNCCS">
   7     <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   8   </head>
   9
  10   <body>
  11     <h2>hostapd: IEEE 802.11 AP, IEEE 802.1X/WPA/WPA2/EAP/RADIUS Authenticator</h2>
  12
  13 <p>hostapd is a user space daemon for access point and authentication
  14 servers. It implements IEEE 802.11 access point management, IEEE
  15 802.1X/WPA/WPA2/EAP Authenticators, RADIUS client, EAP server, and
  16 RADIUS authentication server. The current version supports Linux (Host
  17 AP, madwifi, Prism54 drivers) and FreeBSD (net80211).</p>
  18
  19 <p>hostapd is designed to be a "daemon" program that runs in the
  20 background and acts as the backend component controlling
  21 authentication.  hostapd supports separate frontend programs and an
  22 example text-based frontend, hostapd_cli, is included with
  23 hostapd.</p>
  24
  25 <h4>Supported WPA/IEEE 802.11i/EAP/IEEE 802.1X features</h4>
  26
  27 <ul>
  28 <li>WPA-PSK ("WPA-Personal")</li>
  29 <li>WPA with EAP (with integrated EAP server or an external
  30 RADIUS backend authentication server) ("WPA-Enterprise")</li>
  31 <li>key management for CCMP, TKIP, WEP104, WEP40</li>
  32 <li>WPA and full IEEE 802.11i/RSN/WPA2</li>
  33 <li>RSN: PMKSA caching, pre-authentication</li>
  34 <li>RADIUS accounting</li>
  35 <li>RADIUS authentication server with EAP</li>
  36 </ul>
  37
  38 <h4>Supported EAP methods (integrated EAP server and RADIUS authentication server)</h4>
  39
  40 <ul>
  41 <li>EAP-TLS</li>
  42 <li>EAP-PEAP/MSCHAPv2 (both PEAPv0 and PEAPv1)</li>
  43 <li>EAP-PEAP/TLS (both PEAPv0 and PEAPv1)</li>
  44 <li>EAP-PEAP/GTC (both PEAPv0 and PEAPv1)</li>
  45 <li>EAP-PEAP/MD5-Challenge (both PEAPv0 and PEAPv1)</li>
  46 <li>EAP-TTLS/EAP-MD5-Challenge</li>
  47 <li>EAP-TTLS/EAP-GTC</li>
  48 <li>EAP-TTLS/EAP-MSCHAPv2</li>
  49 <li>EAP-TTLS/MSCHAPv2</li>
  50 <li>EAP-TTLS/EAP-TLS</li>
  51 <li>EAP-TTLS/MSCHAP</li>
  52 <li>EAP-TTLS/PAP</li>
  53 <li>EAP-TTLS/CHAP</li>
  54 <li>EAP-SIM</li>
  55 <li>EAP-AKA</li>
  56 <li>EAP-AKA'</li>
  57 <li>EAP-PAX</li>
  58 <li>EAP-PSK</li>
  59 <li>EAP-SAKE</li>
  60 <li>EAP-FAST</li>
  61 <li>EAP-IKEv2</li>
  62 <li>EAP-GPSK (experimental)</li>
  63 </ul>
  64
  65 <p>Following methods are also supported, but since they do not generate keying
  66 material, they cannot be used with WPA or IEEE 802.1X WEP keying.</p>
  67
  68 <ul>
  69 <li>EAP-MD5-Challenge</li>
  70 <li>EAP-MSCHAPv2</li>
  71 <li>EAP-GTC</li>
  72 <li>EAP-TNC (Trusted Network Connect; TNCS, IF-IMV, IF-T, IF-TNCCS)</li>
  73 </ul>
  74
  75 <p>More information about EAP methods and interoperability testing is
  76 available in <a href="/gitweb/gitweb.cgi?p=hostap.git;a=blob_plain;f=hostapd/eap_testing.txt">eap_testing.txt</a>.</p>
  77
  78
  79 <h4>Supported wireless cards/drivers</h4>
  80
  81 <ul>
  82 <li><a href="http://hostap.epitest.fi/">Host AP driver for Prism2/2.5/3</a></li>
  83 <li><a href="http://sourceforge.net/projects/madwifi/">madwifi (Atheros ar521x)</a></li>
  84 <li><a href="http://www.prism54.org/">Prism54.org (Prism GT/Duette/Indigo)</a></li>
  85 <li>BSD net80211 layer (e.g., Atheros driver) (FreeBSD 6-CURRENT)</li>
  86 </ul>
  87
  88 <h3><a name="download">Download</a></h3>
  89
  90 <p>
  91 <b>hostapd</b><br>
  92 Copyright (c) 2002-2008, Jouni Malinen &lt;j@w1.fi&gt;
  93 and contributors.
  94 </p>
  95
  96 <p>
  97 This program is free software; you can redistribute it and/or modify
  98 it under the terms of the GNU General Public License version 2 as
  99 published by the Free Software Foundation. See
 100 <a href="/gitweb/gitweb.cgi?p=hostap.git;a=blob_plain;f=COPYING">COPYING</a>
 101 for more details.
 102 </p>
 103
 104 <p>Alternatively, this software may be distributed, used, and modified
 105 under the terms of BSD license. See <a href="/gitweb/gitweb.cgi?p=hostap.git;a=blob_plain;f=hostapd/README">README</a>
 106 for more details.</p>
 107
 108 <p>
 109 <b>Please see
 110 <a href="/gitweb/gitweb.cgi?p=hostap.git;a=blob_plain;f=hostapd/README">README</a>
 111 for the current documentation.</b></p>
 112
 113
 114 <ul>
 115 <li><a href="../releases.html">Release graph</a></li>
 116 <li>Latest stable release:
 117 <ul>
 118 <li><a href="../releases/hostapd-0.5.11.tar.gz">hostapd-0.5.11.tar.gz</a></li>
 119 </ul>
 120 <li>Older stable release:
 121 <ul>
 122 <li><a href="../releases/hostapd-0.4.11.tar.gz">hostapd-0.4.11.tar.gz</a></li>
 123 </ul>
 124 <li>Older stable release:
 125 <ul>
 126 <li><a href="../releases/hostapd-0.3.11.tar.gz">hostapd-0.3.11.tar.gz</a></li>
 127 </ul>
 128 <li>Obsolete stable release<BR>
 129 (note: 0.2.x branch is not supported anymore - please upgrade to 0.4.x or 0.5.x):
 130 <ul>
 131 <li><a href="../releases/hostapd-0.2.8.tar.gz">hostapd-0.2.8.tar.gz</a></li>
 132 </ul>
 133 <li>Latest development release:
 134 <ul>
 135 <li><a href="../releases/hostapd-0.6.6.tar.gz">hostapd-0.6.6.tar.gz</a></li>
 136 </ul>
 137 <li>ChangeLog:
 138 <ul>
 139 <li><a href="/gitweb/gitweb.cgi?p=hostap.git;a=blob_plain;f=hostapd/ChangeLog">development branch</a></li>
 140 <li><a href="/cgi-bin/viewcvs.cgi/*checkout*/hostap/hostapd/ChangeLog?rev=stable&amp;content-type=text/plain">stable branch</a>
 141 </ul>
 142 <li><a href="../releases/">Old releases</a></li>
 143 <li><a href="http://lists.shmoo.com/mailman/listinfo/hostap">Mailing list</a></li>
 144 <li><a href="http://lists.shmoo.com/pipermail/hostap/">New mailing list archives</a></li>
 145 <li><a href="/gitweb/gitweb.cgi">Web interface to GIT repository (0.6.x and newer)</a></li>
 146 <li><a href="/cgi-bin/viewcvs.cgi/hostap/">Web interface to CVS repository (0.5.x and older)</a></li>
 147 <li><a href="../releases/snapshots/">Snapshot releases from all active branches</a>
 148 <li><a href="../cvs.html">GIT and read-only anonymous CVS access (pserver)</a></li>
 149 <li><a href="../bugz/">Bug and feature request tracking</a></li>
 150 <li><a href="devel/">Developers' documentation for hostapd</a></li>
 151 </ul>
 152
 153 <h3>WPA</h3>
 154
 155 <p>The original security mechanism of IEEE 802.11 standard was not
 156 designed to be strong and has proven to be insufficient for most
 157 networks that require some kind of security. Task group I (Security)
 158 of <a href="http://www.ieee802.org/11/">IEEE 802.11 working group</a>
 159 has worked to address the flaws of the base standard and in
 160 practice completed its work in May 2004. The IEEE 802.11i amendment to
 161 the IEEE 802.11 standard was approved in June 2004 and published in
 162 July 2004.</p>
 163
 164 <p><a href="http://www.wi-fi.org/">Wi-Fi Alliance</a> used a draft
 165 version of the IEEE 802.11i work (draft 3.0) to define a subset of the
 166 security enhancements that can be implemented with existing wlan
 167 hardware. This is called Wi-Fi Protected Access (WPA). This has
 168 now become a mandatory component of interoperability testing and
 169 certification done by Wi-Fi Alliance. Wi-Fi has
 170 <a href="http://www.wi-fi.org/OpenSection/protected_access.asp">information
 171 about WPA</a> at its web site.</p>
 172
 173 <p>IEEE 802.11 standard defined wired equivalent privacy (WEP) algorithm
 174 for protecting wireless networks. WEP uses RC4 with 40-bit keys,
 175 24-bit initialization vector (IV), and CRC32 to protect against packet
 176 forgery. All these choices have proven to be insufficient: key space is
 177 too small against current attacks, RC4 key scheduling is insufficient
 178 (beginning of the pseudorandom stream should be skipped), IV space is
 179 too small and IV reuse makes attacks easier, there is no replay
 180 protection, and non-keyed authentication does not protect against bit
 181 flipping packet data.</p>
 182
 183 <p>WPA is an intermediate solution for the security issues. It uses
 184 Temporal Key Integrity Protocol (TKIP) to replace WEP. TKIP is a
 185 compromise on strong security and possibility to use existing
 186 hardware. It still uses RC4 for the encryption like WEP, but with
 187 per-packet RC4 keys. In addition, it implements replay protection,
 188 keyed packet authentication mechanism (Michael MIC).</p>
 189
 190 <p>Keys can be managed using two different mechanisms. WPA can either use
 191 an external authentication server (e.g., RADIUS) and EAP just like
 192 IEEE 802.1X is using or pre-shared keys without need for additional
 193 servers. Wi-Fi calls these "WPA-Enterprise" and "WPA-Personal",
 194 respectively. Both mechanisms will generate a master session key for
 195 the Authenticator (AP) and Supplicant (client station).</p>
 196
 197 <p>WPA implements a new key handshake (4-Way Handshake and Group Key
 198 Handshake) for generating and exchanging data encryption keys between
 199 the Authenticator and Supplicant. This handshake is also used to
 200 verify that both Authenticator and Supplicant know the master session
 201 key. These handshakes are identical regardless of the selected key
 202 management mechanism (only the method for generating master session
 203 key changes).</p>
 204
 205
 206 <h3>IEEE 802.11i / RSN / WPA2</h3>
 207
 208 <p>The design for parts of IEEE 802.11i that were not included in WPA
 209 has finished (May 2004) and this amendment to IEEE 802.11 was approved
 210 in June 2004. Wi-Fi Alliance is using the final IEEE 802.11i as a new
 211 version of WPA called WPA2. This included, e.g., support for more
 212 robust encryption algorithm (CCMP: AES in Counter mode with CBC-MAC)
 213 to replace TKIP, optimizations for handoff (reduced number of messages
 214 in initial key handshake, pre-authentication, and PMKSA caching).</p>
 215
 216 <h4>Configuration file</h4>
 217
 218 <p>hostapd is configured using a text file that lists all the configuration
 219 parameters. See an example configuration file,
 220 <a href="/gitweb/gitweb.cgi?p=hostap.git;a=blob_plain;f=hostapd/hostapd.conf">hostapd.conf</a>,
 221 for detailed information about the configuration format and supported
 222 fields.</p>
 223
 224 <h3>Feedback, comments, mailing list</h3>
 225
 226 <p>
 227 Any comments, reports on success/failure, ideas for further
 228 improvement, feature requests, etc. are welcome at j@w1.fi.
 229 Please note, that I often receive more email than I have time to answer.
 230 Unfortunately, some messages may not get a reply, but I'll try to go
 231 through my mail whenever time permits.
 232 </p>
 233
 234 <p>
 235 Host AP mailing list can also be used for topics related to
 236 hostapd. Since this list has a broader audience, your likelyhood of
 237 getting responses is higher. This list is recommended for general
 238 questions about hostapd and its development. In addition, I
 239 will send release notes to it whenever a new version is available.
 240 </p>
 241
 242 <p>
 243 The mailing list information and web archive is at <a
 244 href="http://lists.shmoo.com/mailman/listinfo/hostap">http://lists.shmoo.com/mailman/listinfo/hostap</a>.
 245 Messages to hostap@shmoo.com will be delivered to the
 246 subscribers. Please note, that due to large number of spam and virus
 247 messages sent to the list address, the list is configured to accept
 248 messages only from subscribed addresses. Messages from unsubscribed addresses
 249 may be accepted manually, but their delivery will be delayed.
 250 </p>
 251
 252 <p>
 253 If you want to make sure your bug report of feature request does not
 254 get lost, please report it through the bug tracking system as
 255 <a href="../bugz/enter_bug.cgi">a new
 256 bug/feature request</a>.
 257 </p>
 258
 259 <hr>
 260
 261 The server and hosting for hostap.epitest.fi is kindly provided by
 262 Internet Systems Consortium (ISC).
 263 <a href="http://www.isc.org/"><img src="../isc.png" border="0"></a>
 264
 265     <hr>
 266     <div>
 267     <address><a href="mailto:j@w1.fi">Jouni Malinen</a></address>
 268 <!-- Created: Sun Jan  2 17:20:17 PST 2005 -->
 269 <!-- hhmts start -->
 270 Last modified: Sun Dec  7 19:24:25 EET 2008
 271 <!-- hhmts end -->
 272     </div>
 273   </body>
 274 </html>