4 * added support for SHA-256 as X.509 certificate digest when using the
5 internal X.509/TLSv1 implementation
6 * fixed EAP-FAST PAC-Opaque padding (0.6.4 broke this for some peer
8 * fixed internal TLSv1 implementation for abbreviated handshake (used
10 * added support for setting VLAN ID for STAs based on local MAC ACL
11 (accept_mac_file) as an alternative for RADIUS server-based
13 * updated management frame protection to use IEEE 802.11w/D6.0
14 (adds a new association ping to protect against unauthenticated
15 authenticate or (re)associate request frames dropping association)
16 * added support for using SHA256-based stronger key derivation for WPA2
18 * added new "driver wrapper" for RADIUS-only configuration
19 (driver=none in hostapd.conf; CONFIG_DRIVER_NONE=y in .config)
22 * added peer identity into EAP-FAST PAC-Opaque and skip Phase 2
23 Identity Request if identity is already known
24 * added support for EAP Sequences in EAP-FAST Phase 2
25 * added support for EAP-TNC (Trusted Network Connect)
26 (this version implements the EAP-TNC method and EAP-TTLS/EAP-FAST
27 changes needed to run two methods in sequence (IF-T) and the IF-IMV
28 and IF-TNCCS interfaces from TNCS)
29 * added support for optional cryptobinding with PEAPv0
30 * added fragmentation support for EAP-TNC
31 * added support for fragmenting EAP-TTLS/PEAP/FAST Phase 2 (tunneled)
33 * added support for opportunistic key caching (OKC)
36 * fixed Reassociation Response callback processing when using internal
37 MLME (driver_{hostap,nl80211,test}.c)
38 * updated FT support to use the latest draft, IEEE 802.11r/D9.0
39 * copy optional Proxy-State attributes into RADIUS response when acting
40 as a RADIUS authentication server
41 * fixed EAPOL state machine to handle a case in which no response is
42 received from the RADIUS authentication server; previous version
43 could have triggered a crash in some cases after a timeout
44 * fixed EAP-SIM/AKA realm processing to allow decorated usernames to
46 * added a workaround for EAP-SIM/AKA peers that include incorrect null
47 termination in the username
48 * fixed EAP-SIM/AKA protected result indication to include AT_COUNTER
49 attribute in notification messages only when using fast
51 * fixed EAP-SIM Start response processing for fast reauthentication
53 * added support for pending EAP processing in EAP-{PEAP,TTLS,FAST}
54 phase 2 to allow EAP-SIM and EAP-AKA to be used as the Phase 2 method
57 * fixed EAP-SIM and EAP-AKA message parser to validate attribute
58 lengths properly to avoid potential crash caused by invalid messages
59 * added data structure for storing allocated buffers (struct wpabuf);
60 this does not affect hostapd usage, but many of the APIs changed
61 and various interfaces (e.g., EAP) is not compatible with old
63 * added support for protecting EAP-AKA/Identity messages with
64 AT_CHECKCODE (optional feature in RFC 4187)
65 * added support for protected result indication with AT_RESULT_IND for
66 EAP-SIM and EAP-AKA (eap_sim_aka_result_ind=1)
67 * added support for configuring EAP-TTLS phase 2 non-EAP methods in
68 EAP server configuration; previously all four were enabled for every
69 phase 2 user, now all four are disabled by default and need to be
70 enabled with new method names TTLS-PAP, TTLS-CHAP, TTLS-MSCHAP,
72 * removed old debug printing mechanism and the related 'debug'
73 parameter in the configuration file; debug verbosity is now set with
74 -d (or -dd) command line arguments
75 * added support for EAP-IKEv2 (draft-tschofenig-eap-ikev2-15.txt);
76 only shared key/password authentication is supported in this version
79 * added experimental, integrated TLSv1 server implementation with the
80 needed X.509/ASN.1/RSA/bignum processing (this can be enabled by
81 setting CONFIG_TLS=internal and CONFIG_INTERNAL_LIBTOMMATH=y in
82 .config); this can be useful, e.g., if the target system does not
83 have a suitable TLS library and a minimal code size is required
84 * added support for EAP-FAST server method to the integrated EAP
86 * updated EAP Generalized Pre-Shared Key (EAP-GPSK) to use the latest
87 draft (draft-ietf-emu-eap-gpsk-07.txt)
88 * added a new configuration parameter, rsn_pairwise, to allow different
89 pairwise cipher suites to be enabled for WPA and RSN/WPA2
90 (note: if wpa_pairwise differs from rsn_pairwise, the driver will
91 either need to support this or will have to use the WPA/RSN IEs from
92 hostapd; currently, the included madwifi and bsd driver interfaces do
93 not have support for this)
94 * updated FT support to use the latest draft, IEEE 802.11r/D8.0
97 * added experimental IEEE 802.11r/D6.0 support
98 * updated EAP-SAKE to RFC 4763 and the IANA-allocated EAP type 48
99 * updated EAP-PSK to use the IANA-allocated EAP type 47
100 * fixed EAP-PSK bit ordering of the Flags field
101 * fixed configuration reloading (SIGHUP) to re-initialize WPA PSKs
102 by reading wpa_psk_file [Bug 181]
103 * fixed EAP-TTLS AVP parser processing for too short AVP lengths
104 * fixed IPv6 connection to RADIUS accounting server
105 * updated EAP Generalized Pre-Shared Key (EAP-GPSK) to use the latest
106 draft (draft-ietf-emu-eap-gpsk-04.txt)
107 * hlr_auc_gw: read GSM triplet file into memory and rotate through the
108 entries instead of only using the same three triplets every time
109 (this does not work properly with tests using multiple clients, but
110 provides bit better triplet data for testing a single client; anyway,
111 if a better quality triplets are needed, GSM-Milenage should be used
112 instead of hardcoded triplet file)
113 * fixed EAP-MSCHAPv2 server to use a space between S and M parameters
114 in Success Request [Bug 203]
115 * added support for sending EAP-AKA Notifications in error cases
116 * updated to use IEEE 802.11w/D2.0 for management frame protection
118 * RADIUS server: added support for processing duplicate messages
119 (retransmissions from RADIUS client) by replying with the previous
123 * added support for configuring and controlling multiple BSSes per
124 radio interface (bss=<ifname> in hostapd.conf); this is only
125 available with Devicescape and test driver interfaces
126 * fixed PMKSA cache update in the end of successful RSN
128 * added support for dynamic VLAN configuration (i.e., selecting VLAN-ID
129 for each STA based on RADIUS Access-Accept attributes); this requires
130 VLAN support from the kernel driver/802.11 stack and this is
131 currently only available with Devicescape and test driver interfaces
132 * driver_madwifi: fixed configuration of unencrypted modes (plaintext
133 and IEEE 802.1X without WEP)
134 * removed STAKey handshake since PeerKey handshake has replaced it in
135 IEEE 802.11ma and there are no known deployments of STAKey
136 * updated EAP Generalized Pre-Shared Key (EAP-GPSK) to use the latest
137 draft (draft-ietf-emu-eap-gpsk-01.txt)
138 * added preliminary implementation of IEEE 802.11w/D1.0 (management
140 (Note: this requires driver support to work properly.)
141 (Note2: IEEE 802.11w is an unapproved draft and subject to change.)
142 * hlr_auc_gw: added support for GSM-Milenage (for EAP-SIM)
143 * hlr_auc_gw: added support for reading per-IMSI Milenage keys and
144 parameters from a text file to make it possible to implement proper
145 GSM/UMTS authentication server for multiple SIM/USIM cards using
147 * fixed session timeout processing with drivers that do not use
148 ieee802_11.c (e.g., madwifi)
151 * added 'hostapd_cli new_sta <addr>' command for adding a new STA into
152 hostapd (e.g., to initialize wired network authentication based on an
154 * fixed hostapd to add PMKID KDE into 4-Way Handshake Message 1 when
155 using WPA2 even if PMKSA caching is not used
156 * added -P<pid file> argument for hostapd to write the current process
158 * added support for RADIUS Authentication Server MIB (RFC 2619)
161 * fixed nt_password_hash build [Bug 144]
162 * added PeerKey handshake implementation for IEEE 802.11e
163 direct link setup (DLS) to replace STAKey handshake
164 * added support for EAP Generalized Pre-Shared Key (EAP-GPSK,
165 draft-clancy-emu-eap-shared-secret-00.txt)
166 * fixed a segmentation fault when RSN pre-authentication was completed
167 successfully [Bug 152]
170 * do not build nt_password_hash and hlr_auc_gw by default to avoid
171 requiring a TLS library for a successful build; these programs can be
172 build with 'make nt_password_hash' and 'make hlr_auc_gw'
173 * added a new configuration option, eapol_version, that can be used to
174 set EAPOL version to 1 (default is 2) to work around broken client
175 implementations that drop EAPOL frames which use version number 2
177 * added support for EAP-SAKE (no EAP method number allocated yet, so
178 this is using the same experimental type 255 as EAP-PSK)
179 * fixed EAP-MSCHAPv2 message length validation
182 * fixed stdarg use in hostapd_logger(): if both stdout and syslog
183 logging was enabled, hostapd could trigger a segmentation fault in
184 vsyslog on some CPU -- C library combinations
185 * moved HLR/AuC gateway implementation for EAP-SIM/AKA into an external
186 program to make it easier to use for implementing real SS7 gateway;
187 eap_sim_db is not anymore used as a file name for GSM authentication
188 triplets; instead, it is path to UNIX domain socket that will be used
189 to communicate with the external gateway program (e.g., hlr_auc_gw)
190 * added example HLR/AuC gateway implementation, hlr_auc_gw, that uses
191 local information (GSM authentication triplets from a text file and
192 hardcoded AKA authentication data); this can be used to test EAP-SIM
194 * added Milenage algorithm (example 3GPP AKA algorithm) to hlr_auc_gw
195 to make it possible to test EAP-AKA with real USIM cards (this is
196 disabled by default; define AKA_USE_MILENAGE when building hlr_auc_gw
198 * driver_madwifi: added support for getting station RSN IE from
199 madwifi-ng svn r1453 and newer; this fixes RSN that was apparently
200 broken with earlier change (r1357) in the driver
201 * changed EAP method registration to use a dynamic list of methods
202 instead of a static list generated at build time
203 * fixed WPA message 3/4 not to encrypt Key Data field (WPA IE)
205 * added ap_max_inactivity configuration parameter
208 * driver_test: added better support for multiple APs and STAs by using
209 a directory with sockets that include MAC address for each device in
210 the name (test_socket=DIR:/tmp/test)
211 * added support for EAP expanded type (vendor specific EAP methods)
213 2005-12-18 - v0.5.0 (beginning of 0.5.x development releases)
214 * added experimental STAKey handshake implementation for IEEE 802.11e
215 direct link setup (DLS); note: this is disabled by default in both
216 build and runtime configuration (can be enabled with CONFIG_STAKEY=y
218 * added support for EAP methods to use callbacks to external programs
219 by buffering a pending request and processing it after the EAP method
221 * improved EAP-SIM database interface to allow external request to GSM
222 HLR/AuC without blocking hostapd process
223 * added support for using EAP-SIM pseudonyms and fast re-authentication
224 * added support for EAP-AKA in the integrated EAP authenticator
225 * added support for matching EAP identity prefixes (e.g., "1"*) in EAP
226 user database to allow EAP-SIM/AKA selection without extra roundtrip
227 for EAP-Nak negotiation
228 * added support for storing EAP user password as NtPasswordHash instead
229 of plaintext password when using MSCHAP or MSCHAPv2 for
230 authentication (hash:<16-octet hex value>); added nt_password_hash
231 tool for hashing password to generate NtPasswordHash
233 2005-11-20 - v0.4.7 (beginning of 0.4.x stable releases)
234 * driver_wired: fixed EAPOL sending to optionally use PAE group address
235 as the destination instead of supplicant MAC address; this is
236 disabled by default, but should be enabled with use_pae_group_addr=1
237 in configuration file if the wired interface is used by only one
238 device at the time (common switch configuration)
239 * driver_madwifi: configure driver to use TKIP countermeasures in order
240 to get correct behavior (IEEE 802.11 association failing; previously,
241 association succeeded, but hostpad forced disassociation immediately)
242 * driver_madwifi: added support for madwifi-ng
245 * added support for replacing user identity from EAP with RADIUS
246 User-Name attribute from Access-Accept message, if that is included,
247 for the RADIUS accounting messages (e.g., for EAP-PEAP/TTLS to get
248 tunneled identity into accounting messages when the RADIUS server
249 does not support better way of doing this with Class attribute)
250 * driver_madwifi: fixed EAPOL packet receive for configuration where
251 ath# is part of a bridge interface
252 * added a configuration file and log analyzer script for logwatch
253 * fixed EAPOL state machine step function to process all state
254 transitions before processing new events; this resolves a race
255 condition in which EAPOL-Start message could trigger hostapd to send
256 two EAP-Response/Identity frames to the authentication server
259 * added client CA list to the TLS certificate request in order to make
260 it easier for the client to select which certificate to use
261 * added experimental support for EAP-PSK
262 * added support for WE-19 (hostap, madwifi)
265 * fixed build without CONFIG_RSN_PREAUTH
266 * fixed FreeBSD build
269 * fixed PMKSA caching to copy User-Name and Class attributes so that
270 RADIUS accounting gets correct information
271 * start RADIUS accounting only after successful completion of WPA
272 4-Way Handshake if WPA-PSK is used
273 * fixed PMKSA caching for the case where STA (re)associates without
277 * EAP-PAX is now registered as EAP type 46
278 * fixed EAP-PAX MAC calculation
279 * fixed EAP-PAX CK and ICK key derivation
280 * renamed eap_authenticator configuration variable to eap_server to
281 better match with RFC 3748 (EAP) terminology
282 * driver_test: added support for testing hostapd with wpa_supplicant
283 by using test driver interface without any kernel drivers or network
287 * fixed RADIUS server initialization when only auth or acct server
288 is configured and the other one is left empty
289 * driver_madwifi: added support for RADIUS accounting
290 * driver_madwifi: added preliminary support for compiling against 'BSD'
291 branch of madwifi CVS tree
292 * driver_madwifi: fixed pairwise key removal to allow WPA reauth
293 without disassociation
294 * added support for reading additional certificates from PKCS#12 files
295 and adding them to the certificate chain
296 * fixed RADIUS Class attribute processing to only use Access-Accept
297 packets to update Class; previously, other RADIUS authentication
298 packets could have cleared Class attribute
299 * added support for more than one Class attribute in RADIUS packets
300 * added support for verifying certificate revocation list (CRL) when
301 using integrated EAP authenticator for EAP-TLS; new hostapd.conf
302 options 'check_crl'; CRL must be included in the ca_cert file for now
304 2005-04-25 - v0.4.0 (beginning of 0.4.x development releases)
305 * added support for including network information into
306 EAP-Request/Identity message (ASCII-0 (nul) in eap_message)
307 (e.g., to implement draft-adrange-eap-network-discovery-07.txt)
308 * fixed a bug which caused some RSN pre-authentication cases to use
309 freed memory and potentially crash hostapd
310 * fixed private key loading for cases where passphrase is not set
311 * added support for sending TLS alerts and aborting authentication
312 when receiving a TLS alert
313 * fixed WPA2 to add PMKSA cache entry when using integrated EAP
315 * fixed PMKSA caching (EAP authentication was not skipped correctly
316 with the new state machine changes from IEEE 802.1X draft)
317 * added support for RADIUS over IPv6; own_ip_addr, auth_server_addr,
318 and acct_server_addr can now be IPv6 addresses (CONFIG_IPV6=y needs
319 to be added to .config to include IPv6 support); for RADIUS server,
320 radius_server_ipv6=1 needs to be set in hostapd.conf and addresses
321 in RADIUS clients file can then use IPv6 format
322 * added experimental support for EAP-PAX
323 * replaced hostapd control interface library (hostapd_ctrl.[ch]) with
324 the same implementation that wpa_supplicant is using (wpa_ctrl.[ch])
326 2005-02-12 - v0.3.7 (beginning of 0.3.x stable releases)
329 * added support for configuring a forced PEAP version based on the
331 * fixed PEAPv1 to use tunneled EAP-Success/Failure instead of EAP-TLV
332 to terminate authentication
333 * fixed EAP identifier duplicate processing with the new IEEE 802.1X
335 * clear accounting data in the driver when starting a new accounting
337 * driver_madwifi: filter wireless events based on ifindex to allow more
338 than one network interface to be used
339 * fixed WPA message 2/4 processing not to cancel timeout for TimeoutEvt
340 setting if the packet does not pass MIC verification (e.g., due to
341 incorrect PSK); previously, message 1/4 was not tried again if an
342 invalid message 2/4 was received
343 * fixed reconfiguration of RADIUS client retransmission timer when
344 adding a new message to the pending list; previously, timer was not
345 updated at this point and if there was a pending message with long
346 time for the next retry, the new message needed to wait that long for
350 * added support for configuring multiple allowed EAP types for Phase 2
351 authentication (EAP-PEAP, EAP-TTLS)
352 * fixed EAPOL-Start processing to trigger WPA reauthentication
353 (previously, only EAPOL authentication was done)
356 * added support for EAP-PEAP in the integrated EAP authenticator
357 * added support for EAP-GTC in the integrated EAP authenticator
358 * added support for configuring list of EAP methods for Phase 1 so that
359 the integrated EAP authenticator can, e.g., use the wildcard entry
360 for EAP-TLS and EAP-PEAP
361 * added support for EAP-TTLS in the integrated EAP authenticator
362 * added support for EAP-SIM in the integrated EAP authenticator
363 * added support for using hostapd as a RADIUS authentication server
364 with the integrated EAP authenticator taking care of EAP
365 authentication (new hostapd.conf options: radius_server_clients and
366 radius_server_auth_port); this is not included in default build; use
367 CONFIG_RADIUS_SERVER=y in .config to include
370 * removed 'daemonize' configuration file option since it has not really
371 been used at all for more than year
372 * driver_madwifi: fixed group key setup and added get_ssid method
373 * added support for EAP-MSCHAPv2 in the integrated EAP authenticator
376 * added support for integrated EAP-TLS authentication (new hostapd.conf
377 variables: ca_cert, server_cert, private_key, private_key_passwd);
378 this enabled dynamic keying (WPA2/WPA/IEEE 802.1X/WEP) without
379 external RADIUS server
380 * added support for reading PKCS#12 (PFX) files (as a replacement for
381 PEM/DER) to get certificate and private key (CONFIG_PKCS12)
383 2004-12-05 - v0.3.0 (beginning of 0.3.x development releases)
384 * added support for Acct-{Input,Output}-Gigawords
385 * added support for Event-Timestamp (in RADIUS Accounting-Requests)
386 * added support for RADIUS Authentication Client MIB (RFC2618)
387 * added support for RADIUS Accounting Client MIB (RFC2620)
388 * made EAP re-authentication period configurable (eap_reauth_period)
389 * fixed EAPOL reauthentication to trigger WPA/WPA2 reauthentication
390 * fixed EAPOL state machine to stop if STA is removed during
391 eapol_sm_step(); this fixes at least one segfault triggering bug with
392 IEEE 802.11i pre-authentication
393 * added support for multiple WPA pre-shared keys (e.g., one for each
394 client MAC address or keys shared by a group of clients);
395 new hostapd.conf field wpa_psk_file for setting path to a text file
396 containing PSKs, see hostapd.wpa_psk for an example
397 * added support for multiple driver interfaces to allow hostapd to be
398 used with other drivers
399 * added wired authenticator driver interface (driver=wired in
400 hostapd.conf, see wired.conf for example configuration)
401 * added madwifi driver interface (driver=madwifi in hostapd.conf, see
402 madwifi.conf for example configuration; Note: include files from
403 madwifi project is needed for building and a configuration file,
404 .config, needs to be created in hostapd directory with
405 CONFIG_DRIVER_MADWIFI=y to include this driver interface in hostapd
407 * fixed an alignment issue that could cause SHA-1 to fail on some
408 platforms (e.g., Intel ixp425 with a compiler that does not 32-bit
410 * fixed RADIUS reconnection after an error in sending interim
412 * added hostapd control interface for external programs and an example
413 CLI, hostapd_cli (like wpa_cli for wpa_supplicant)
414 * started adding dot11, dot1x, radius MIBs ('hostapd_cli mib',
415 'hostapd_cli sta <addr>')
416 * finished update from IEEE 802.1X-2001 to IEEE 802.1X-REV (now d11)
417 * added support for strict GTK rekeying (wpa_strict_rekey in
419 * updated IAPP to use UDP port 3517 and multicast address 224.0.1.178
420 (instead of broadcast) for IAPP ADD-notify (moved from draft 3 to
422 * added Prism54 driver interface (driver=prism54 in hostapd.conf;
423 note: .config needs to be created in hostapd directory with
424 CONFIG_DRIVER_PRISM54=y to include this driver interface in hostapd
426 * dual-licensed hostapd (GPLv2 and BSD licenses)
427 * fixed RADIUS accounting to generate a new session id for cases where
428 a station reassociates without first being complete deauthenticated
429 * fixed STA disassociation handler to mark next timeout state to
430 deauthenticate the station, i.e., skip long wait for inactivity poll
431 and extra disassociation, if the STA disassociates without
433 * added integrated EAP authenticator that can be used instead of
434 external RADIUS authentication server; currently, only EAP-MD5 is
435 supported, so this cannot yet be used for key distribution; the EAP
436 method interface is generic, though, so adding new EAP methods should
437 be straightforward; new hostapd.conf variables: 'eap_authenticator'
438 and 'eap_user_file'; this obsoletes "minimal authentication server"
439 ('minimal_eap' in hostapd.conf) which is now removed
440 * added support for FreeBSD and driver interface for the BSD net80211
441 layer (driver=bsd in hostapd.conf and CONFIG_DRIVER_BSD=y in
442 .config); please note that some of the required kernel mods have not
445 2004-07-17 - v0.2.4 (beginning of 0.2.x stable releases)
446 * fixed some accounting cases where Accounting-Start was sent when
447 IEEE 802.1X port was being deauthorized
450 * modified RADIUS client to re-connect the socket in case of certain
451 error codes that are generated when a network interface state is
452 changes (e.g., when IP address changes or the interface is set UP)
453 * fixed couple of cases where EAPOL state for a station was freed
454 twice causing a segfault for hostapd
455 * fixed couple of bugs in processing WPA deauthentication (freed data
459 * fixed WPA/WPA2 group rekeying to use key index correctly (GN/GM)
460 * fixed group rekeying to send zero TSC in EAPOL-Key messages to fix
461 cases where STAs dropped multicast frames as replay attacks
462 * added support for copying RADIUS Attribute 'Class' from
463 authentication messages into accounting messages
464 * send canned EAP failure if RADIUS server sends Access-Reject without
465 EAP message (previously, Supplicant was not notified in this case)
466 * fixed mixed WPA-PSK and WPA-EAP mode to work with WPA-PSK (i.e., do
467 not start EAPOL state machines if the STA selected to use WPA-PSK)
470 * added WPA and IEEE 802.11i/RSN (WPA2) Authenticator functionality
471 - based on IEEE 802.11i/D10.0 but modified to interoperate with WPA
472 (i.e., IEEE 802.11i/D3.0)
473 - supports WPA-only, RSN-only, and mixed WPA/RSN mode
474 - both WPA-PSK and WPA-RADIUS/EAP are supported
475 - PMKSA caching and pre-authentication
476 - new hostapd.conf variables: wpa, wpa_psk, wpa_passphrase,
477 wpa_key_mgmt, wpa_pairwise, wpa_group_rekey, wpa_gmk_rekey,
478 rsn_preauth, rsn_preauth_interfaces
479 * fixed interim accounting to remove any pending accounting messages
480 to the STA before sending a new one
483 * added support for Acct-Interim-Interval:
484 - draft-ietf-radius-acct-interim-01.txt
485 - use Acct-Interim-Interval attribute from Access-Accept if local
486 'radius_acct_interim_interval' is not set
487 - allow different update intervals for each STA
488 * fixed event loop to call signal handlers only after returning from
489 the real signal handler
490 * reset sta->timeout_next after successful association to make sure
491 that the previously registered inactivity timer will not remove the
492 STA immediately (e.g., if STA deauthenticates and re-associates
493 before the timer is triggered).
494 * added new hostapd.conf variable, nas_identifier, that can be used to
495 add an optional RADIUS Attribute, NAS-Identifier, into authentication
496 and accounting messages
497 * added support for Accounting-On and Accounting-Off messages
498 * fixed accounting session handling to send Accounting-Start only once
499 per session and not to send Accounting-Stop if the session was not
501 * fixed Accounting-Stop statistics in cases where the message was
502 previously sent after the kernel entry for the STA (and/or IEEE
503 802.1X data) was removed
508 Older changes up to and including v0.1.0 are included in the ChangeLog
509 of the Host AP driver.