4 * fixed EAP-SIM and EAP-AKA message parser to validate attribute
5 lengths properly to avoid potential crash caused by invalid messages
6 * fixed Reassociation Response callback processing when using internal
7 MLME (driver_{hostap,devicescape,test}.c)
8 * fixed EAP-SIM/AKA realm processing to allow decorated usernames to
10 * added a workaround for EAP-SIM/AKA peers that include incorrect null
11 termination in the username
12 * fixed EAP-SIM Start response processing for fast reauthentication
14 * copy optional Proxy-State attributes into RADIUS response when acting
15 as a RADIUS authentication server
18 * updated EAP Generalized Pre-Shared Key (EAP-GPSK) to use the latest
19 draft (draft-ietf-emu-eap-gpsk-07.txt)
20 * fixed debugging code not to use potentially unaligned read to fetch
24 * updated driver_devicescape.c to build with the current
25 wireless-dev.git tree and net/d80211 changes
26 * updated EAP Generalized Pre-Shared Key (EAP-GPSK) to use the latest
27 draft (draft-ietf-emu-eap-gpsk-03.txt)
28 * fixed EAP-MSCHAPv2 server to use a space between S and M parameters
29 in Success Request [Bug 203]
30 * added support for sending EAP-AKA Notifications in error cases
31 * RADIUS server: added support for processing duplicate messages
32 (retransmissions from RADIUS client) by replying with the previous
36 * updated EAP-SAKE to RFC 4763 and the IANA-allocated EAP type 48
37 * updated EAP-PSK to use the IANA-allocated EAP type 47
38 * fixed EAP-PSK bit ordering of the Flags field
39 * fixed configuration reloading (SIGHUP) to re-initialize WPA PSKs
40 by reading wpa_psk_file [Bug 181]
41 * fixed EAP-TTLS AVP parser processing for too short AVP lengths
42 * fixed IPv6 connection to RADIUS accounting server
45 * added support for configuring and controlling multiple BSSes per
46 radio interface (bss=<ifname> in hostapd.conf); this is only
47 available with Devicescape and test driver interfaces
48 * fixed PMKSA cache update in the end of successful RSN
50 * added support for dynamic VLAN configuration (i.e., selecting VLAN-ID
51 for each STA based on RADIUS Access-Accept attributes); this requires
52 VLAN support from the kernel driver/802.11 stack and this is
53 currently only available with Devicescape and test driver interfaces
54 * driver_madwifi: fixed configuration of unencrypted modes (plaintext
55 and IEEE 802.1X without WEP)
56 * removed STAKey handshake since PeerKey handshake has replaced it in
57 IEEE 802.11ma and there are no known deployments of STAKey
58 * updated EAP Generalized Pre-Shared Key (EAP-GPSK) to use the latest
59 draft (draft-ietf-emu-eap-gpsk-01.txt)
60 * added preliminary implementation of IEEE 802.11w/D1.0 (management
62 (Note: this requires driver support to work properly.)
63 (Note2: IEEE 802.11w is an unapproved draft and subject to change.)
64 * hlr_auc_gw: added support for GSM-Milenage (for EAP-SIM)
65 * hlr_auc_gw: added support for reading per-IMSI Milenage keys and
66 parameters from a text file to make it possible to implement proper
67 GSM/UMTS authentication server for multiple SIM/USIM cards using
69 * fixed session timeout processing with drivers that do not use
70 ieee802_11.c (e.g., madwifi)
73 * added 'hostapd_cli new_sta <addr>' command for adding a new STA into
74 hostapd (e.g., to initialize wired network authentication based on an
76 * fixed hostapd to add PMKID KDE into 4-Way Handshake Message 1 when
77 using WPA2 even if PMKSA caching is not used
78 * added -P<pid file> argument for hostapd to write the current process
80 * added support for RADIUS Authentication Server MIB (RFC 2619)
83 * fixed nt_password_hash build [Bug 144]
84 * added PeerKey handshake implementation for IEEE 802.11e
85 direct link setup (DLS) to replace STAKey handshake
86 * added support for EAP Generalized Pre-Shared Key (EAP-GPSK,
87 draft-clancy-emu-eap-shared-secret-00.txt)
88 * fixed a segmentation fault when RSN pre-authentication was completed
89 successfully [Bug 152]
92 * do not build nt_password_hash and hlr_auc_gw by default to avoid
93 requiring a TLS library for a successful build; these programs can be
94 build with 'make nt_password_hash' and 'make hlr_auc_gw'
95 * added a new configuration option, eapol_version, that can be used to
96 set EAPOL version to 1 (default is 2) to work around broken client
97 implementations that drop EAPOL frames which use version number 2
99 * added support for EAP-SAKE (no EAP method number allocated yet, so
100 this is using the same experimental type 255 as EAP-PSK)
101 * fixed EAP-MSCHAPv2 message length validation
104 * fixed stdarg use in hostapd_logger(): if both stdout and syslog
105 logging was enabled, hostapd could trigger a segmentation fault in
106 vsyslog on some CPU -- C library combinations
107 * moved HLR/AuC gateway implementation for EAP-SIM/AKA into an external
108 program to make it easier to use for implementing real SS7 gateway;
109 eap_sim_db is not anymore used as a file name for GSM authentication
110 triplets; instead, it is path to UNIX domain socket that will be used
111 to communicate with the external gateway program (e.g., hlr_auc_gw)
112 * added example HLR/AuC gateway implementation, hlr_auc_gw, that uses
113 local information (GSM authentication triplets from a text file and
114 hardcoded AKA authentication data); this can be used to test EAP-SIM
116 * added Milenage algorithm (example 3GPP AKA algorithm) to hlr_auc_gw
117 to make it possible to test EAP-AKA with real USIM cards (this is
118 disabled by default; define AKA_USE_MILENAGE when building hlr_auc_gw
120 * driver_madwifi: added support for getting station RSN IE from
121 madwifi-ng svn r1453 and newer; this fixes RSN that was apparently
122 broken with earlier change (r1357) in the driver
123 * changed EAP method registration to use a dynamic list of methods
124 instead of a static list generated at build time
125 * fixed WPA message 3/4 not to encrypt Key Data field (WPA IE)
127 * added ap_max_inactivity configuration parameter
130 * driver_test: added better support for multiple APs and STAs by using
131 a directory with sockets that include MAC address for each device in
132 the name (test_socket=DIR:/tmp/test)
133 * added support for EAP expanded type (vendor specific EAP methods)
135 2005-12-18 - v0.5.0 (beginning of 0.5.x development releases)
136 * added experimental STAKey handshake implementation for IEEE 802.11e
137 direct link setup (DLS); note: this is disabled by default in both
138 build and runtime configuration (can be enabled with CONFIG_STAKEY=y
140 * added support for EAP methods to use callbacks to external programs
141 by buffering a pending request and processing it after the EAP method
143 * improved EAP-SIM database interface to allow external request to GSM
144 HLR/AuC without blocking hostapd process
145 * added support for using EAP-SIM pseudonyms and fast re-authentication
146 * added support for EAP-AKA in the integrated EAP authenticator
147 * added support for matching EAP identity prefixes (e.g., "1"*) in EAP
148 user database to allow EAP-SIM/AKA selection without extra roundtrip
149 for EAP-Nak negotiation
150 * added support for storing EAP user password as NtPasswordHash instead
151 of plaintext password when using MSCHAP or MSCHAPv2 for
152 authentication (hash:<16-octet hex value>); added nt_password_hash
153 tool for hashing password to generate NtPasswordHash
155 2005-11-20 - v0.4.7 (beginning of 0.4.x stable releases)
156 * driver_wired: fixed EAPOL sending to optionally use PAE group address
157 as the destination instead of supplicant MAC address; this is
158 disabled by default, but should be enabled with use_pae_group_addr=1
159 in configuration file if the wired interface is used by only one
160 device at the time (common switch configuration)
161 * driver_madwifi: configure driver to use TKIP countermeasures in order
162 to get correct behavior (IEEE 802.11 association failing; previously,
163 association succeeded, but hostpad forced disassociation immediately)
164 * driver_madwifi: added support for madwifi-ng
167 * added support for replacing user identity from EAP with RADIUS
168 User-Name attribute from Access-Accept message, if that is included,
169 for the RADIUS accounting messages (e.g., for EAP-PEAP/TTLS to get
170 tunneled identity into accounting messages when the RADIUS server
171 does not support better way of doing this with Class attribute)
172 * driver_madwifi: fixed EAPOL packet receive for configuration where
173 ath# is part of a bridge interface
174 * added a configuration file and log analyzer script for logwatch
175 * fixed EAPOL state machine step function to process all state
176 transitions before processing new events; this resolves a race
177 condition in which EAPOL-Start message could trigger hostapd to send
178 two EAP-Response/Identity frames to the authentication server
181 * added client CA list to the TLS certificate request in order to make
182 it easier for the client to select which certificate to use
183 * added experimental support for EAP-PSK
184 * added support for WE-19 (hostap, madwifi)
187 * fixed build without CONFIG_RSN_PREAUTH
188 * fixed FreeBSD build
191 * fixed PMKSA caching to copy User-Name and Class attributes so that
192 RADIUS accounting gets correct information
193 * start RADIUS accounting only after successful completion of WPA
194 4-Way Handshake if WPA-PSK is used
195 * fixed PMKSA caching for the case where STA (re)associates without
199 * EAP-PAX is now registered as EAP type 46
200 * fixed EAP-PAX MAC calculation
201 * fixed EAP-PAX CK and ICK key derivation
202 * renamed eap_authenticator configuration variable to eap_server to
203 better match with RFC 3748 (EAP) terminology
204 * driver_test: added support for testing hostapd with wpa_supplicant
205 by using test driver interface without any kernel drivers or network
209 * fixed RADIUS server initialization when only auth or acct server
210 is configured and the other one is left empty
211 * driver_madwifi: added support for RADIUS accounting
212 * driver_madwifi: added preliminary support for compiling against 'BSD'
213 branch of madwifi CVS tree
214 * driver_madwifi: fixed pairwise key removal to allow WPA reauth
215 without disassociation
216 * added support for reading additional certificates from PKCS#12 files
217 and adding them to the certificate chain
218 * fixed RADIUS Class attribute processing to only use Access-Accept
219 packets to update Class; previously, other RADIUS authentication
220 packets could have cleared Class attribute
221 * added support for more than one Class attribute in RADIUS packets
222 * added support for verifying certificate revocation list (CRL) when
223 using integrated EAP authenticator for EAP-TLS; new hostapd.conf
224 options 'check_crl'; CRL must be included in the ca_cert file for now
226 2005-04-25 - v0.4.0 (beginning of 0.4.x development releases)
227 * added support for including network information into
228 EAP-Request/Identity message (ASCII-0 (nul) in eap_message)
229 (e.g., to implement draft-adrange-eap-network-discovery-07.txt)
230 * fixed a bug which caused some RSN pre-authentication cases to use
231 freed memory and potentially crash hostapd
232 * fixed private key loading for cases where passphrase is not set
233 * added support for sending TLS alerts and aborting authentication
234 when receiving a TLS alert
235 * fixed WPA2 to add PMKSA cache entry when using integrated EAP
237 * fixed PMKSA caching (EAP authentication was not skipped correctly
238 with the new state machine changes from IEEE 802.1X draft)
239 * added support for RADIUS over IPv6; own_ip_addr, auth_server_addr,
240 and acct_server_addr can now be IPv6 addresses (CONFIG_IPV6=y needs
241 to be added to .config to include IPv6 support); for RADIUS server,
242 radius_server_ipv6=1 needs to be set in hostapd.conf and addresses
243 in RADIUS clients file can then use IPv6 format
244 * added experimental support for EAP-PAX
245 * replaced hostapd control interface library (hostapd_ctrl.[ch]) with
246 the same implementation that wpa_supplicant is using (wpa_ctrl.[ch])
248 2005-02-12 - v0.3.7 (beginning of 0.3.x stable releases)
251 * added support for configuring a forced PEAP version based on the
253 * fixed PEAPv1 to use tunneled EAP-Success/Failure instead of EAP-TLV
254 to terminate authentication
255 * fixed EAP identifier duplicate processing with the new IEEE 802.1X
257 * clear accounting data in the driver when starting a new accounting
259 * driver_madwifi: filter wireless events based on ifindex to allow more
260 than one network interface to be used
261 * fixed WPA message 2/4 processing not to cancel timeout for TimeoutEvt
262 setting if the packet does not pass MIC verification (e.g., due to
263 incorrect PSK); previously, message 1/4 was not tried again if an
264 invalid message 2/4 was received
265 * fixed reconfiguration of RADIUS client retransmission timer when
266 adding a new message to the pending list; previously, timer was not
267 updated at this point and if there was a pending message with long
268 time for the next retry, the new message needed to wait that long for
272 * added support for configuring multiple allowed EAP types for Phase 2
273 authentication (EAP-PEAP, EAP-TTLS)
274 * fixed EAPOL-Start processing to trigger WPA reauthentication
275 (previously, only EAPOL authentication was done)
278 * added support for EAP-PEAP in the integrated EAP authenticator
279 * added support for EAP-GTC in the integrated EAP authenticator
280 * added support for configuring list of EAP methods for Phase 1 so that
281 the integrated EAP authenticator can, e.g., use the wildcard entry
282 for EAP-TLS and EAP-PEAP
283 * added support for EAP-TTLS in the integrated EAP authenticator
284 * added support for EAP-SIM in the integrated EAP authenticator
285 * added support for using hostapd as a RADIUS authentication server
286 with the integrated EAP authenticator taking care of EAP
287 authentication (new hostapd.conf options: radius_server_clients and
288 radius_server_auth_port); this is not included in default build; use
289 CONFIG_RADIUS_SERVER=y in .config to include
292 * removed 'daemonize' configuration file option since it has not really
293 been used at all for more than year
294 * driver_madwifi: fixed group key setup and added get_ssid method
295 * added support for EAP-MSCHAPv2 in the integrated EAP authenticator
298 * added support for integrated EAP-TLS authentication (new hostapd.conf
299 variables: ca_cert, server_cert, private_key, private_key_passwd);
300 this enabled dynamic keying (WPA2/WPA/IEEE 802.1X/WEP) without
301 external RADIUS server
302 * added support for reading PKCS#12 (PFX) files (as a replacement for
303 PEM/DER) to get certificate and private key (CONFIG_PKCS12)
305 2004-12-05 - v0.3.0 (beginning of 0.3.x development releases)
306 * added support for Acct-{Input,Output}-Gigawords
307 * added support for Event-Timestamp (in RADIUS Accounting-Requests)
308 * added support for RADIUS Authentication Client MIB (RFC2618)
309 * added support for RADIUS Accounting Client MIB (RFC2620)
310 * made EAP re-authentication period configurable (eap_reauth_period)
311 * fixed EAPOL reauthentication to trigger WPA/WPA2 reauthentication
312 * fixed EAPOL state machine to stop if STA is removed during
313 eapol_sm_step(); this fixes at least one segfault triggering bug with
314 IEEE 802.11i pre-authentication
315 * added support for multiple WPA pre-shared keys (e.g., one for each
316 client MAC address or keys shared by a group of clients);
317 new hostapd.conf field wpa_psk_file for setting path to a text file
318 containing PSKs, see hostapd.wpa_psk for an example
319 * added support for multiple driver interfaces to allow hostapd to be
320 used with other drivers
321 * added wired authenticator driver interface (driver=wired in
322 hostapd.conf, see wired.conf for example configuration)
323 * added madwifi driver interface (driver=madwifi in hostapd.conf, see
324 madwifi.conf for example configuration; Note: include files from
325 madwifi project is needed for building and a configuration file,
326 .config, needs to be created in hostapd directory with
327 CONFIG_DRIVER_MADWIFI=y to include this driver interface in hostapd
329 * fixed an alignment issue that could cause SHA-1 to fail on some
330 platforms (e.g., Intel ixp425 with a compiler that does not 32-bit
332 * fixed RADIUS reconnection after an error in sending interim
334 * added hostapd control interface for external programs and an example
335 CLI, hostapd_cli (like wpa_cli for wpa_supplicant)
336 * started adding dot11, dot1x, radius MIBs ('hostapd_cli mib',
337 'hostapd_cli sta <addr>')
338 * finished update from IEEE 802.1X-2001 to IEEE 802.1X-REV (now d11)
339 * added support for strict GTK rekeying (wpa_strict_rekey in
341 * updated IAPP to use UDP port 3517 and multicast address 224.0.1.178
342 (instead of broadcast) for IAPP ADD-notify (moved from draft 3 to
344 * added Prism54 driver interface (driver=prism54 in hostapd.conf;
345 note: .config needs to be created in hostapd directory with
346 CONFIG_DRIVER_PRISM54=y to include this driver interface in hostapd
348 * dual-licensed hostapd (GPLv2 and BSD licenses)
349 * fixed RADIUS accounting to generate a new session id for cases where
350 a station reassociates without first being complete deauthenticated
351 * fixed STA disassociation handler to mark next timeout state to
352 deauthenticate the station, i.e., skip long wait for inactivity poll
353 and extra disassociation, if the STA disassociates without
355 * added integrated EAP authenticator that can be used instead of
356 external RADIUS authentication server; currently, only EAP-MD5 is
357 supported, so this cannot yet be used for key distribution; the EAP
358 method interface is generic, though, so adding new EAP methods should
359 be straightforward; new hostapd.conf variables: 'eap_authenticator'
360 and 'eap_user_file'; this obsoletes "minimal authentication server"
361 ('minimal_eap' in hostapd.conf) which is now removed
362 * added support for FreeBSD and driver interface for the BSD net80211
363 layer (driver=bsd in hostapd.conf and CONFIG_DRIVER_BSD=y in
364 .config); please note that some of the required kernel mods have not
367 2004-07-17 - v0.2.4 (beginning of 0.2.x stable releases)
368 * fixed some accounting cases where Accounting-Start was sent when
369 IEEE 802.1X port was being deauthorized
372 * modified RADIUS client to re-connect the socket in case of certain
373 error codes that are generated when a network interface state is
374 changes (e.g., when IP address changes or the interface is set UP)
375 * fixed couple of cases where EAPOL state for a station was freed
376 twice causing a segfault for hostapd
377 * fixed couple of bugs in processing WPA deauthentication (freed data
381 * fixed WPA/WPA2 group rekeying to use key index correctly (GN/GM)
382 * fixed group rekeying to send zero TSC in EAPOL-Key messages to fix
383 cases where STAs dropped multicast frames as replay attacks
384 * added support for copying RADIUS Attribute 'Class' from
385 authentication messages into accounting messages
386 * send canned EAP failure if RADIUS server sends Access-Reject without
387 EAP message (previously, Supplicant was not notified in this case)
388 * fixed mixed WPA-PSK and WPA-EAP mode to work with WPA-PSK (i.e., do
389 not start EAPOL state machines if the STA selected to use WPA-PSK)
392 * added WPA and IEEE 802.11i/RSN (WPA2) Authenticator functionality
393 - based on IEEE 802.11i/D10.0 but modified to interoperate with WPA
394 (i.e., IEEE 802.11i/D3.0)
395 - supports WPA-only, RSN-only, and mixed WPA/RSN mode
396 - both WPA-PSK and WPA-RADIUS/EAP are supported
397 - PMKSA caching and pre-authentication
398 - new hostapd.conf variables: wpa, wpa_psk, wpa_passphrase,
399 wpa_key_mgmt, wpa_pairwise, wpa_group_rekey, wpa_gmk_rekey,
400 rsn_preauth, rsn_preauth_interfaces
401 * fixed interim accounting to remove any pending accounting messages
402 to the STA before sending a new one
405 * added support for Acct-Interim-Interval:
406 - draft-ietf-radius-acct-interim-01.txt
407 - use Acct-Interim-Interval attribute from Access-Accept if local
408 'radius_acct_interim_interval' is not set
409 - allow different update intervals for each STA
410 * fixed event loop to call signal handlers only after returning from
411 the real signal handler
412 * reset sta->timeout_next after successful association to make sure
413 that the previously registered inactivity timer will not remove the
414 STA immediately (e.g., if STA deauthenticates and re-associates
415 before the timer is triggered).
416 * added new hostapd.conf variable, nas_identifier, that can be used to
417 add an optional RADIUS Attribute, NAS-Identifier, into authentication
418 and accounting messages
419 * added support for Accounting-On and Accounting-Off messages
420 * fixed accounting session handling to send Accounting-Start only once
421 per session and not to send Accounting-Stop if the session was not
423 * fixed Accounting-Stop statistics in cases where the message was
424 previously sent after the kernel entry for the STA (and/or IEEE
425 802.1X data) was removed
430 Older changes up to and including v0.1.0 are included in the ChangeLog
431 of the Host AP driver.