1
ChangeLog for wpa_supplicant
4
* updated driver_wext.c to build with the current wireless-dev.git tree
6
* updated EAP Generalized Pre-Shared Key (EAP-GPSK) to use the latest
7
draft (draft-ietf-emu-eap-gpsk-03.txt)
9
* fixed EAP-TTLS implementation not to crash on use of freed memory
10
if TLS library initialization fails
11
* fixed EAP-AKA Notification processing to allow Notification to be
12
processed after AKA Challenge response has been sent
15
* updated EAP-SAKE to RFC 4763 and the IANA-allocated EAP type 48
16
* updated EAP-PSK to use the IANA-allocated EAP type 47
17
* fixed EAP-PAX key derivation
18
* fixed EAP-PSK bit ordering of the Flags field
19
* fixed EAP-PEAP/TTLS/FAST to use the correct EAP identifier in
20
tunnelled identity request (previously, the identifier from the outer
21
method was used, not the tunnelled identifier which could be
23
* fixed EAP-TTLS AVP parser processing for too short AVP lengths
24
* added support for EAP-FAST authentication with inner methods that
25
generate MSK (e.g., EAP-MSCHAPv2 that was previously only supported
27
* fixed dbus ctrl_iface to validate message interface before
28
dispatching to avoid a possible segfault [Bug 190]
29
* fixed PeerKey key derivation to use the correct PRF label
30
* updated Windows binary build to link against OpenSSL 0.9.8d and
31
added support for EAP-FAST
34
* added experimental, integrated TLSv1 client implementation with the
35
needed X.509/ASN.1/RSA/bignum processing (this can be enabled by
36
setting CONFIG_TLS=internal and CONFIG_INTERNAL_LIBTOMMATH=y in
37
.config); this can be useful, e.g., if the target system does not
38
have a suitable TLS library and a minimal code size is required
39
(total size of this internal TLS/crypto code is bit under 50 kB on
40
x86 and the crypto code is shared by rest of the supplicant so some
41
of it was already required; TLSv1/X.509/ASN.1/RSA added about 25 kB)
42
* removed STAKey handshake since PeerKey handshake has replaced it in
43
IEEE 802.11ma and there are no known deployments of STAKey
44
* updated EAP Generalized Pre-Shared Key (EAP-GPSK) to use the latest
45
draft (draft-ietf-emu-eap-gpsk-01.txt)
46
* added preliminary implementation of IEEE 802.11w/D1.0 (management
48
(Note: this requires driver support to work properly.)
49
(Note2: IEEE 802.11w is an unapproved draft and subject to change.)
50
* fixed Windows named pipes ctrl_iface to not stop listening for
51
commands if client program opens a named pipe and closes it
52
immediately without sending a command
53
* fixed USIM PIN status determination for the case that PIN is not
54
needed (this allows EAP-AKA to be used with USIM cards that do not
56
* added support for reading 3G USIM AID from EF_DIR to allow EAP-AKA to
57
be used with cards that do not support file selection based on
59
* added support for matching the subjectAltName of the authentication
60
server certificate against multiple name components (e.g.,
61
altsubject_match="DNS:server.example.com;DNS:server2.example.com")
62
* fixed EAP-SIM/AKA key derivation for re-authentication case (only
63
affects IEEE 802.1X with dynamic WEP keys)
64
* changed ctrl_iface network configuration 'get' operations to not
65
return password/key material; if these fields are requested, "*"
66
will be returned if the password/key is set, but the value of the
67
parameter is not exposed
70
* added support for building Windows version with UNICODE defined
72
* driver_ndis: fixed static WEP configuration to avoid race condition
73
issues with some NDIS drivers between association and setting WEP
75
* driver_ndis: added validation for IELength value in scan results to
76
avoid crashes when using buggy NDIS drivers [Bug 165]
77
* fixed Release|Win32 target in the Visual Studio project files
78
(previously, only Debug|Win32 target was set properly)
79
* changed control interface API call wpa_ctrl_pending() to allow it to
80
return -1 on error (e.g., connection lost); control interface clients
81
will need to make sure that they verify that the value is indeed >0
82
when determining whether there are pending messages
83
* added an alternative control interface backend for Windows targets:
84
Named Pipe (CONFIG_CTRL_IFACE=named_pipe); this is now the default
85
control interface mechanism for Windows builds (previously, UDP to
87
* changed ctrl_interface configuration for UNIX domain sockets:
88
- deprecated ctrl_interface_group variable (it may be removed in
90
- allow both directory and group be configured with ctrl_interface
91
in following format: DIR=/var/run/wpa_supplicant GROUP=wheel
92
- ctrl_interface=/var/run/wpa_supplicant is still supported for the
93
case when group is not changed
94
* added support for controlling more than one interface per process in
96
* added a workaround for a case where the AP is using unknown address
97
(e.g., MAC address of the wired interface) as the source address for
98
EAPOL-Key frames; previously, that source address was used as the
99
destination for EAPOL-Key frames and in key derivation; now, BSSID is
100
used even if the source address does not match with it
101
(this resolves an interoperability issue with Thomson SpeedTouch 580)
102
* added a workaround for UDP-based control interface (which was used in
103
Windows builds before this release) to prevent packets with forged
104
addresses from being accepted as local control requests
105
* removed ndis_events.cpp and possibility of using external
106
ndis_events.exe; C version (ndis_events.c) is fully functional and
107
there is no desire to maintain two separate versions of this
109
* ndis_events: Changed NDIS event notification design to use WMI to
110
learn the adapter description through Win32_PnPEntity class; this
111
should fix some cases where the adapter name was not recognized
112
correctly (e.g., with some USB WLAN adapters, e.g., Ralink RT2500
114
* fixed selection of the first network in ap_scan=2 mode; previously,
115
wpa_supplicant could get stuck in SCANNING state when only the first
116
network for enabled (e.g., after 'wpa_cli select_network 0')
117
* winsvc: added support for configuring ctrl_interface parameters in
118
registry (ctrl_interface string value in
119
HKLM\SOFTWARE\wpa_supplicant\interfaces\0000 key); this new value is
120
required to enable control interface (previously, this was hardcoded
122
* allow wpa_gui subdirectory to be built with both Qt3 and Qt4
123
* converted wpa_gui-qt4 subdirectory to use Qt4 specific project format
126
* fixed build with CONFIG_STAKEY=y [Bug 143]
127
* added support for doing MLME (IEEE 802.11 management frame
128
processing) in wpa_supplicant when using Devicescape IEEE 802.11
129
stack (wireless-dev.git tree)
130
* added a new network block configuration option, fragment_size, to
131
configure the maximum EAP fragment size
132
* driver_ndis: Disable WZC automatically for the selected interface to
133
avoid conflicts with two programs trying to control the radio; WZC
134
will be re-enabled (if it was enabled originally) when wpa_supplicant
136
* added an experimental TLSv1 client implementation
137
(CONFIG_TLS=internal) that can be used instead of an external TLS
138
library, e.g., to reduce total size requirement on systems that do
139
not include any TLS library by default (this is not yet complete;
140
basic functionality is there, but certificate validation is not yet
142
* added PeerKey handshake implementation for IEEE 802.11e
143
direct link setup (DLS) to replace STAKey handshake
144
* fixed WPA PSK update through ctrl_iface for the case where the old
145
PSK was derived from an ASCII passphrase and the new PSK is set as
146
a raw PSK (hex string)
147
* added new configuration option for identifying which network block
148
was used (id_str in wpa_supplicant.conf; included on
149
WPA_EVENT_CONNECT monitor event and as WPA_ID_STR environmental
150
variable in wpa_cli action scripts; in addition WPA_ID variable is
151
set to the current unique identifier that wpa_supplicant assigned
152
automatically for the network and that can be used with
153
GET_NETWORK/SET_NETWORK ctrl_iface commands)
154
* wpa_cli action script is now called only when the connect/disconnect
155
status changes or when associating with a different network
156
* fixed configuration parser not to remove CCMP from group cipher list
157
if WPA-None (adhoc) is used (pairwise=NONE in that case)
158
* fixed integrated NDIS events processing not to hang the process due
159
to a missed change in eloop_win.c API in v0.5.3 [Bug 155]
160
* added support for EAP Generalized Pre-Shared Key (EAP-GPSK,
161
draft-clancy-emu-eap-shared-secret-00.txt)
162
* added Microsoft Visual Studio 2005 solution and project files for
163
build wpa_supplicant for Windows (see vs2005 subdirectory)
164
* eloop_win: fixed unregistration of Windows events
165
* l2_packet_winpcap: fixed a deadlock in deinitializing l2_packet
166
at the end of RSN pre-authentication and added unregistration of
167
a Windows event to avoid getting eloop_win stuck with an invalid
169
* driver_ndis: added support for selecting AP based on BSSID
170
* added new environmental variable for wpa_cli action scripts:
171
WPA_CTRL_DIR is the current control interface directory
172
* driver_ndis: added support for using NDISUIO instead of WinPcap for
173
OID set/query operations (CONFIG_USE_NDISUIO=y in .config); with new
174
l2_packet_ndis (CONFIG_L2_PACKET=ndis), this can be used to build
175
wpa_supplicant without requiring WinPcap; note that using NDISUIO
176
requires that WZC is disabled (net stop wzcsvc) since NDISUIO allows
177
only one application to open the device
178
* changed NDIS driver naming to only include device GUID, e.g.,
179
{7EE3EFE5-C165-472F-986D-F6FBEDFE8C8D}, instead of including WinPcap
180
specific \Device\NPF_ prefix before the GUID; the prefix is still
181
allowed for backwards compatibility, but it is not required anymore
182
when specifying the interface
183
* driver_ndis: re-initialize driver interface is the adapter is removed
184
and re-inserted [Bug 159]
185
* driver_madwifi: fixed TKIP and CCMP sequence number configuration on
186
big endian hosts [Bug 146]
189
* fixed EAP-GTC response to include correct user identity when run as
190
phase 2 method of EAP-FAST (i.e., EAP-FAST did not work in v0.5.2)
191
* driver_ndis: Fixed encryption mode configuration for unencrypted
192
networks (some NDIS drivers ignored this, but others, e.g., Broadcom,
193
refused to associate with open networks) [Bug 106]
194
* driver_ndis: use BSSID OID polling to detect when IBSS network is
195
formed even when ndis_events code is included since some NDIS drivers
196
do not generate media connect events in IBSS mode
197
* config_winreg: allow global ctrl_interface parameter to be configured
199
* config_winreg: added support for saving configuration data into
201
* added support for controlling network device operational state
202
(dormant/up) for Linux 2.6.17 to improve DHCP processing (see
203
http://www.flamewarmaster.de/software/dhcpclient/ for a DHCP client
204
that can use this information)
205
* driver_wext: added support for WE-21 change to SSID configuration
206
* driver_wext: fixed privacy configuration for static WEP keys mode
208
* added an optional driver_ops callback for MLME-SETPROTECTION.request
210
* added support for EAP-SAKE (no EAP method number allocated yet, so
211
this is using the same experimental type 255 as EAP-PSK)
212
* added support for dynamically loading EAP methods (.so files) instead
213
of requiring them to be statically linked in; this is disabled by
214
default (see CONFIG_DYNAMIC_EAP_METHODS in defconfig for information
218
* do not try to use USIM APDUs when initializing PC/SC for SIM card
219
access for a network that has not enabled EAP-AKA
220
* fixed EAP phase 2 Nak for EAP-{PEAP,TTLS,FAST} (this was broken in
221
v0.5.1 due to the new support for expanded EAP types)
222
* added support for generating EAP Expanded Nak
223
* try to fetch scan results once before requesting new scan when
224
starting up in ap_scan=1 mode (this can speed up initial association
225
a lot with, e.g., madwifi-ng driver)
226
* added support for receiving EAPOL frames from a Linux bridge
227
interface (-bbr0 on command line)
228
* fixed EAPOL re-authentication for sessions that used PMKSA caching
229
* changed EAP method registration to use a dynamic list of methods
230
instead of a static list generated at build time
231
* fixed PMKSA cache deinitialization not to use freed memory when
232
removing PMKSA entries
233
* fixed a memory leak in EAP-TTLS re-authentication
234
* reject WPA/WPA2 message 3/4 if it does not include any valid
236
* driver_wext: added fallback to use SIOCSIWENCODE for setting auth_alg
237
if the driver does not support SIOCSIWAUTH
240
* driver_test: added better support for multiple APs and STAs by using
241
a directory with sockets that include MAC address for each device in
242
the name (driver_param=test_dir=/tmp/test)
243
* added support for EAP expanded type (vendor specific EAP methods)
244
* added AP_SCAN command into ctrl_iface so that ap_scan configuration
245
option can be changed if needed
246
* wpa_cli/wpa_gui: skip non-socket files in control directory when
247
using UNIX domain sockets; this avoids selecting an incorrect
248
interface (e.g., a PID file could be in this directory, even though
249
use of this directory for something else than socket files is not
251
* fixed TLS library deinitialization after RSN pre-authentication not
252
to disable TLS library for normal authentication
253
* driver_wext: Remove null-termination from SSID length if the driver
254
used it; some Linux drivers do this and they were causing problems in
255
wpa_supplicant not finding matching configuration block. This change
256
would break a case where the SSID actually ends in '\0', but that is
257
not likely to happen in real use.
258
* fixed PMKSA cache processing not to trigger deauthentication if the
259
current PMKSA cache entry is replaced with a valid new entry
260
* fixed PC/SC initialization for ap_scan != 1 modes (this fixes
261
EAP-SIM and EAP-AKA with real SIM/USIM card when using ap_scan=0 or
264
2005-12-18 - v0.5.0 (beginning of 0.5.x development releases)
265
* added experimental STAKey handshake implementation for IEEE 802.11e
266
direct link setup (DLS); note: this is disabled by default in both
267
build and runtime configuration (can be enabled with CONFIG_STAKEY=y
269
* fixed EAP-SIM and EAP-AKA pseudonym and fast re-authentication to
270
decrypt AT_ENCR_DATA attributes correctly
271
* fixed EAP-AKA to allow resynchronization within the same session
272
* made code closer to ANSI C89 standard to make it easier to port to
273
other C libraries and compilers
274
* started moving operating system or C library specific functions into
275
wrapper functions defined in os.h and implemented in os_*.c to make
277
* wpa_supplicant can now be built with Microsoft Visual C++
278
(e.g., with the freely available Toolkit 2003 version or Visual
279
C++ 2005 Express Edition and Platform SDK); see nmake.mak for an
280
example makefile for nmake
281
* added support for using Windows registry for command line parameters
282
(CONFIG_MAIN=main_winsvc) and configuration data
283
(CONFIG_BACKEND=winreg); see win_example.reg for an example registry
284
contents; this version can be run both as a Windows service and as a
285
normal application; 'wpasvc.exe app' to start as applicant,
286
'wpasvc.exe reg <full path to wpasvc.exe>' to register a service,
287
'net start wpasvc' to start the service, 'wpasvc.exe unreg' to
289
* made it possible to link ndis_events.exe functionality into
290
wpa_supplicant.exe by defining CONFIG_NDIS_EVENTS_INTEGRATED
291
* added better support for multiple control interface backends
292
(CONFIG_CTRL_IFACE option); currently, 'unix' and 'udp' are supported
293
* fixed PC/SC code to use correct length for GSM AUTH command buffer
294
and to not use pioRecvPci with SCardTransmit() calls; these were not
295
causing visible problems with pcsc-lite, but Windows Winscard.dll
296
refused the previously used parameters; this fixes EAP-SIM and
297
EAP-AKA authentication using SIM/USIM card under Windows
298
* added new event loop implementation for Windows using
299
WaitForMultipleObject() instead of select() in order to allow waiting
300
for non-socket objects; this can be selected with
301
CONFIG_ELOOP=eloop_win in .config
302
* added support for selecting l2_packet implementation in .config
303
(CONFIG_L2_PACKET; following options are available now: linux, pcap,
304
winpcap, freebsd, none)
305
* added new l2_packet implementation for WinPcap
306
(CONFIG_L2_PACKET=winpcap) that uses a separate receive thread to
307
reduce latency in EAPOL receive processing from about 100 ms to about
309
* added support for EAP-FAST key derivation using other ciphers than
310
RC4-128-SHA for authentication and AES128-SHA for provisioning
311
* added support for configuring CA certificate as DER file and as a
313
* fixed private key configuration as configuration blob and added
314
support for using PKCS#12 as a blob
315
* tls_gnutls: added support for using PKCS#12 files; added support for
317
* added support for loading trusted CA certificates from Windows
318
certificate store: ca_cert="cert_store://<name>", where <name> is
319
likely CA (Intermediate CA certificates) or ROOT (root certificates)
320
* added C version of ndis_events.cpp and made it possible to build this
321
with MinGW so that CONFIG_NDIS_EVENTS_INTEGRATED can be used more
322
easily on cross-compilation builds
323
* added wpasvc.exe into Windows binary release; this is an alternative
324
version of wpa_supplicant.exe with configuration backend using
325
Windows registry and with the entry point designed to run as a
327
* integrated ndis_events.exe functionality into wpa_supplicant.exe and
328
wpasvc.exe and removed this additional tool from the Windows binary
329
release since it is not needed anymore
330
* load winscard.dll functions dynamically when building with MinGW
331
since MinGW does not yet include winscard library
333
2005-11-20 - v0.4.7 (beginning of 0.4.x stable releases)
334
* l2_packet_pcap: fixed wired IEEE 802.1X authentication with libpcap
335
and WinPcap to receive frames sent to PAE group address
336
* disable EAP state machine when IEEE 802.1X authentication is not used
337
in order to get rid of bogus "EAP failed" messages
338
* fixed OpenSSL error reporting to go through all pending errors to
339
avoid confusing reports of old errors being reported at later point
341
* fixed configuration file updating to not write empty variables
342
(e.g., proto or key_mgmt) that the file parser would not accept
343
* fixed ADD_NETWORK ctrl_iface command to use the same default values
344
for variables as empty network definitions read from config file
346
* fixed EAP state machine to not discard EAP-Failure messages in many
347
cases (e.g., during TLS handshake)
348
* fixed a infinite loop in private key reading if the configured file
349
cannot be parsed successfully
350
* driver_madwifi: added support for madwifi-ng
351
* wpa_gui: do not display password/PSK field contents
352
* wpa_gui: added CA certificate configuration
353
* driver_ndis: fixed scan request in ap_scan=2 mode not to change SSID
354
* driver_ndis: include Beacon IEs in AssocInfo in order to notice if
355
the new AP is using different WPA/RSN IE
356
* use longer timeout for IEEE 802.11 association to avoid problems with
357
drivers that may take more than five second to associate
360
* allow fallback to WPA, if mixed WPA+WPA2 networks have mismatch in
361
RSN IE, but WPA IE would match with wpa_supplicant configuration
362
* added support for named configuration blobs in order to avoid having
363
to use file system for external files (e.g., certificates);
364
variables can be set to "blob://<blob name>" instead of file path to
365
use a named blob; supported fields: pac_file, client_cert,
367
* fixed RSN pre-authentication (it was broken in the clean up of WPA
368
state machine interface in v0.4.5)
369
* driver_madwifi: set IEEE80211_KEY_GROUP flag for group keys to make
370
sure the driver configures broadcast decryption correctly
371
* added ca_path (and ca_path2) configuration variables that can be used
372
to configure OpenSSL CA path, e.g., /etc/ssl/certs, for using the
373
system-wide trusted CA list
374
* added support for starting wpa_supplicant without a configuration
375
file (-C argument must be used to set ctrl_interface parameter for
376
this case; in addition, -p argument can be used to provide
377
driver_param; these new arguments can also be used with a
378
configuration to override the values from the configuration)
379
* added global control interface that can be optionally used for adding
380
and removing network interfaces dynamically (-g command line argument
381
for both wpa_supplicant and wpa_cli) without having to restart
382
wpa_supplicant process
384
- try to save configuration whenever something is modified
385
- added WEP key configuration
386
- added possibility to edit the current network configuration
387
* driver_ndis: fixed driver polling not to increase frequency on each
388
received EAPOL frame due to incorrectly cancelled timeout
389
* added simple configuration file examples (in examples subdirectory)
390
* fixed driver_wext.c to filter wireless events based on ifindex to
391
avoid interfaces receiving events from other interfaces
392
* delay sending initial EAPOL-Start couple of seconds to speed up
393
authentication for the most common case of Authenticator starting
394
EAP authentication immediately after association
397
* added a workaround for clearing keys with ndiswrapper to allow
398
roaming from WPA enabled AP to plaintext one
399
* added docbook documentation (doc/docbook) that can be used to
400
generate, e.g., man pages
401
* l2_packet_linux: use socket type SOCK_DGRAM instead of SOCK_RAW for
402
PF_PACKET in order to prepare for network devices that do not use
403
Ethernet headers (e.g., network stack with native IEEE 802.11 frames)
404
* use receipt of EAPOL-Key frame as a lower layer success indication
405
for EAP state machine to allow recovery from dropped EAP-Success
407
* cleaned up internal EAPOL frame processing by not including link
408
layer (Ethernet) header during WPA and EAPOL/EAP processing; this
409
header is added only when transmitted the frame; this makes it easier
410
to use wpa_supplicant on link layers that use different header than
412
* updated EAP-PSK to use draft 9 by default since this can now be
413
tested with hostapd; removed support for draft 3, including
414
server_nai configuration option from network blocks
415
* driver_wired: add PAE address to the multicast address list in order
416
to be able to receive EAPOL frames with drivers that do not include
417
these multicast addresses by default
418
* driver_wext: add support for WE-19
419
* added support for multiple configuration backends (CONFIG_BACKEND
420
option); currently, only 'file' is supported (i.e., the format used
421
in wpa_supplicant.conf)
422
* added support for updating configuration ('wpa_cli save_config');
423
this is disabled by default and can be enabled with global
424
update_config=1 variable in wpa_supplicant.conf; this allows wpa_cli
425
and wpa_gui to store the configuration changes in a permanent store
426
* added GET_NETWORK ctrl_iface command
427
(e.g., 'wpa_cli get_network 0 ssid')
430
* replaced OpenSSL patch for EAP-FAST support
431
(openssl-tls-extensions.patch) with a more generic and correct
432
patch (the new patch is not compatible with the previous one, so the
433
OpenSSL library will need to be patched with the new patch in order
434
to be able to build wpa_supplicant with EAP-FAST support)
435
* added support for using Windows certificate store (through CryptoAPI)
436
for client certificate and private key operations (EAP-TLS)
437
(see wpa_supplicant.conf for more information on how to configure
438
this with private_key)
439
* ported wpa_gui to Windows
440
* added Qt4 version of wpa_gui (wpa_gui-qt4 directory); this can be
441
built with the open source version of the Qt4 for Windows
442
* allow non-WPA modes (e.g., IEEE 802.1X with dynamic WEP) to be used
443
with drivers that do not support WPA
444
* ndis_events: fixed Windows 2000 support
445
* added support for enabling/disabling networks from the list of all
446
configured networks ('wpa_cli enable_network <network id>' and
447
'wpa_cli disable_network <network id>')
448
* added support for adding and removing network from the current
449
configuration ('wpa_cli add_network' and 'wpa_cli remove_network
450
<network id>'); added networks are disabled by default and they can
451
be enabled with enable_network command once the configuration is done
452
for the new network; note: configuration file is not yet updated, so
453
these new networks are lost when wpa_supplicant is restarted
454
* added support for setting network configuration parameters through
455
the control interface, for example:
456
wpa_cli set_network 0 ssid "\"my network\""
457
* fixed parsing of strings that include both " and # within double
458
quoted area (e.g., "start"#end")
459
* added EAP workaround for PEAP session resumption: allow outer,
460
i.e., not tunneled, EAP-Success to terminate session since; this can
461
be disabled with eap_workaround=0
462
(this was allowed for PEAPv1 before, but now it is also allowed for
463
PEAPv0 since at least one RADIUS authentication server seems to be
464
doing this for PEAPv0, too)
465
* wpa_gui: added preliminary support for adding new networks to the
466
wpa_supplicant configuration (double click on the scan results to
467
open network configuration)
470
* removed interface for external EAPOL/EAP supplicant (e.g.,
471
Xsupplicant), (CONFIG_XSUPPLICANT_IFACE) since it is not required
472
anymore and is unlikely to be used by anyone
473
* driver_ndis: fixed WinPcap 3.0 support
474
* fixed build with CONFIG_DNET_PCAP=y on Linux
475
* l2_packet: moved different implementations into separate files
479
* driver_ipw: updated driver structures to match with ipw2200-1.0.4
480
(note: ipw2100-1.1.0 is likely to require an update to work with
482
* added support for using ap_scan=2 mode with multiple network blocks;
483
wpa_supplicant will go through the networks one by one until the
484
driver reports a successful association; this uses the same order for
485
networks as scan_ssid=1 scans, i.e., the priority field is ignored
486
and the network block order in the file is used instead
487
* fixed a potential issue in RSN pre-authentication ending up using
488
freed memory if pre-authentication times out
489
* added support for matching alternative subject name extensions of the
490
authentication server certificate; new configuration variables
491
altsubject_match and altsubject_match2
492
* driver_ndis: added support for IEEE 802.1X authentication with wired
494
* added support for querying private key password (EAP-TLS) through the
495
control interface (wpa_cli/wpa_gui) if one is not included in the
497
* driver_broadcom: fixed couple of memory leaks in scan result
499
* EAP-PAX is now registered as EAP type 46
500
* fixed EAP-PAX MAC calculation
501
* fixed EAP-PAX CK and ICK key derivation
502
* added support for using password with EAP-PAX (as an alternative to
503
entering key with eappsk); SHA-1 hash of the password will be used as
505
* added support for arbitrary driver interface parameters through the
506
configuration file with a new driver_param field; this adds a new
507
driver_ops function set_param()
508
* added possibility to override l2_packet module with driver interface
509
API (new send_eapol handler); this can be used to implement driver
510
specific TX/RX functions for EAPOL frames
511
* fixed ctrl_interface_group processing for the case where gid is
512
entered as a number, not group name
513
* driver_test: added support for testing hostapd with wpa_supplicant
514
by using test driver interface without any kernel drivers or network
518
* driver_madwifi: fixed WPA/WPA2 mode configuration to allow EAPOL
519
packets to be encrypted; this was apparently broken by the changed
520
ioctl order in v0.4.0
521
* driver_madwifi: added preliminary support for compiling against 'BSD'
522
branch of madwifi CVS tree
523
* added support for EAP-MSCHAPv2 password retries within the same EAP
524
authentication session
525
* added support for password changes with EAP-MSCHAPv2 (used when the
526
password has expired)
527
* added support for reading additional certificates from PKCS#12 files
528
and adding them to the certificate chain
529
* fixed association with IEEE 802.1X (no WPA) when dynamic WEP keys
531
* fixed a possible double free in EAP-TTLS fast-reauthentication when
532
identity or password is entered through control interface
533
* display EAP Notification messages to user through control interface
534
with "CTRL-EVENT-EAP-NOTIFICATION" prefix
535
* added GUI version of wpa_cli, wpa_gui; this is not build
536
automatically with 'make'; use 'make wpa_gui' to build (this requires
537
Qt development tools)
538
* added 'disconnect' command to control interface for setting
539
wpa_supplicant in state where it will not associate before
540
'reassociate' command has been used
541
* added support for selecting a network from the list of all configured
542
networks ('wpa_cli select_network <network id>'; this disabled all
543
other networks; to re-enable, 'wpa_cli select_network any')
544
* added support for getting scan results through control interface
545
* added EAP workaround for PEAPv1 session resumption: allow outer,
546
i.e., not tunneled, EAP-Success to terminate session since; this can
547
be disabled with eap_workaround=0
549
2005-04-25 - v0.4.0 (beginning of 0.4.x development releases)
550
* added a new build time option, CONFIG_NO_STDOUT_DEBUG, that can be
551
used to reduce the size of the wpa_supplicant considerably if
552
debugging code is not needed
553
* fixed EAPOL-Key validation to drop packets with invalid Key Data
554
Length; such frames could have crashed wpa_supplicant due to buffer
556
* added support for wired authentication (IEEE 802.1X on wired
557
Ethernet); driver interface 'wired'
558
* obsoleted set_wpa() handler in the driver interface API (it can be
559
replaced by moving enable/disable functionality into init()/deinit())
560
(calls to set_wpa() are still present for backwards compatibility,
561
but they may be removed in the future)
562
* driver_madwifi: fixed association in plaintext mode
563
* modified the EAP workaround that accepts EAP-Success with incorrect
564
Identifier to be even less strict about verification in order to
565
interoperate with some authentication servers
566
* added support for sending TLS alerts
567
* added support for 'any' SSID wildcard; if ssid is not configured or
568
is set to an empty string, any SSID will be accepted for non-WPA AP
569
* added support for asking PIN (for SIM) from frontends (e.g.,
570
wpa_cli); if a PIN is needed, but not included in the configuration
571
file, a control interface request is sent and EAP processing is
572
delayed until the PIN is available
573
* added support for using external devices (e.g., a smartcard) for
574
private key operations in EAP-TLS (CONFIG_SMARTCARD=y in .config);
575
new wpa_supplicant.conf variables:
576
- global: opensc_engine_path, pkcs11_engine_path, pkcs11_module_path
577
- network: engine, engine_id, key_id
578
* added experimental support for EAP-PAX
579
* added monitor mode for wpa_cli (-a<path to a program to run>) that
580
allows external commands (e.g., shell scripts) to be run based on
581
wpa_supplicant events, e.g., when authentication has been completed
582
and data connection is ready; other related wpa_cli arguments:
583
-B (run in background), -P (write PID file); wpa_supplicant has a new
584
command line argument (-W) that can be used to make it wait until a
585
control interface command is received in order to avoid missing
587
* added support for opportunistic WPA2 PMKSA key caching (disabled by
588
default, can be enabled with proactive_key_caching=1)
589
* fixed RSN IE in 4-Way Handshake message 2/4 for the case where
590
Authenticator rejects PMKSA caching attempt and the driver is not
591
using assoc_info events
592
* added -P<pid file> argument for wpa_supplicant to write the current
593
process id into a file
595
2005-02-12 - v0.3.7 (beginning of 0.3.x stable releases)
596
* added new phase1 option parameter, include_tls_length=1, to force
597
wpa_supplicant to add TLS Message Length field to all TLS messages
598
even if the packet is not fragmented; this may be needed with some
599
authentication servers
600
* fixed WPA/RSN IE verification in message 3 of 4-Way Handshake when
601
using drivers that take care of AP selection (e.g., when using
603
* fixed reprocessing of pending request after ctrl_iface requests for
604
identity/password/otp
605
* fixed ctrl_iface requests for identity/password/otp in Phase 2 of
606
EAP-PEAP and EAP-TTLS
607
* all drivers using driver_wext: set interface up and select Managed
608
mode when starting wpa_supplicant; set interface down when exiting
609
* renamed driver_ipw2100.c to driver_ipw.c since it now supports both
610
ipw2100 and ipw2200; please note that this also changed the
611
configuration variable in .config to CONFIG_DRIVER_IPW
614
* fixed a busy loop introduced in v0.3.5 for scan result processing
615
when no matching AP is found
618
* added a workaround for an interoperability issue with a Cisco AP
620
* fixed non-WPA IEEE 802.1X to use the same authentication timeout as
621
WPA with IEEE 802.1X (i.e., timeout 10 -> 70 sec to allow
622
retransmission of dropped frames)
623
* fixed issues with 64-bit CPUs and SHA1 cleanup in previous version
624
(e.g., segfault when processing EAPOL-Key frames)
625
* fixed EAP workaround and fast reauthentication configuration for
626
RSN pre-authentication; previously these were disabled and
627
pre-authentication would fail if the used authentication server
628
requires EAP workarounds
629
* added support for blacklisting APs that fail or timeout
630
authentication in ap_scan=1 mode so that all APs are tried in cases
631
where the ones with strongest signal level are failing authentication
632
* fixed CA certificate loading after a failed EAP-TLS/PEAP/TTLS
633
authentication attempt
634
* allow EAP-PEAP/TTLS fast reauthentication only if Phase 2 succeeded
635
in the previous authentication (previously, only Phase 1 success was
639
* added preliminary support for IBSS (ad-hoc) mode configuration
640
(mode=1 in network block); this included a new key_mgmt mode
641
WPA-NONE, i.e., TKIP or CCMP with a fixed key (based on psk) and no
642
key management; see wpa_supplicant.conf for more details and an
643
example on how to configure this (note: this is currently implemented
644
only for driver_hostapd.c, but the changes should be trivial to add
645
in associate() handler for other drivers, too (assuming the driver
647
* added preliminary port for native Windows (i.e., no cygwin) using
651
* added optional support for GNU Readline and History Libraries for
652
wpa_cli (CONFIG_READLINE)
653
* cleaned up EAP state machine <-> method interface and number of
654
small problems with error case processing not terminating on
655
EAP-Failure but waiting for timeout
656
* added couple of workarounds for interoperability issues with a
657
Cisco AP when using WPA2
658
* added support for EAP-FAST (draft-cam-winget-eap-fast-00.txt);
659
Note: This requires a patch for openssl to add support for TLS
660
extensions and number of workarounds for operations without
661
certificates. Proof of concept type of experimental patch is
662
included in openssl-tls-extensions.patch.
665
* fixed private key loading for cases where passphrase is not set
666
* fixed Windows/cygwin L2 packet handler freeing; previous version
667
could cause a segfault when RSN pre-authentication was completed
668
* added support for PMKSA caching with drivers that generate RSN IEs
669
(e.g., NDIS); currently, this is only implemented in driver_ndis.c,
670
but similar code can be easily added to driver_ndiswrapper.c once
671
ndiswrapper gets full support for RSN PMKSA caching
672
* improved recovery from PMKID mismatches by requesting full EAP
673
authentication in case of failed PMKSA caching attempt
674
* driver_ndis: added support for NDIS NdisMIncidateStatus() events
675
(this requires that ndis_events is ran while wpa_supplicant is
677
* driver_ndis: use ADD_WEP/REMOVE_WEP when configuring WEP keys
678
* added support for driver interfaces to replace the interface name
679
based on driver/OS specific mapping, e.g., in case of driver_ndis,
680
this allows the beginning of the adapter description to be used as
682
* added support for CR+LF (Windows-style) line ends in configuration
684
* driver_ndis: enable radio before starting scanning, disable radio
686
* modified association event handler to set portEnabled = FALSE before
687
clearing port Valid in order to reset EAP state machine and avoid
688
problems with new authentication getting ignored because of state
689
machines ending up in AUTHENTICATED/SUCCESS state based on old
691
* added support for driver events to add PMKID candidates in order to
692
allow drivers to give priority to most likely roaming candidates
693
* driver_hostap: moved PrivacyInvoked configuration to associate()
694
function so that this will not be set for plaintext connections
695
* added KEY_MGMT_802_1X_NO_WPA as a new key_mgmt type so that driver
696
interface can distinguish plaintext and IEEE 802.1X (no WPA)
698
* fixed static WEP key configuration to use broadcast/default type for
699
all keys (previously, the default TX key was configured as pairwise/
701
* driver_ndis: added legacy WPA capability detection for non-WPA2
703
* added support for setting static WEP keys for IEEE 802.1X without
704
dynamic WEP keying (eapol_flags=0)
707
* added support for reading PKCS#12 (PFX) files (as a replacement for
708
PEM/DER) to get certificate and private key (CONFIG_PKCS12)
709
* fixed compilation with CONFIG_PCSC=y
710
* added new ap_scan mode, ap_scan=2, for drivers that take care of
711
association, but need to be configured with security policy and SSID,
712
e.g., ndiswrapper and NDIS driver; this mode should allow such
713
drivers to work with hidden SSIDs and optimized roaming; when
714
ap_scan=2 is used, only the first network block in the configuration
715
file is used and this configuration should have explicit security
716
policy (i.e., only one option in the lists) for key_mgmt, pairwise,
717
group, proto variables
718
* added experimental port of wpa_supplicant for Windows
719
- driver_ndis.c driver interface (NDIS OIDs)
720
- currently, this requires cygwin and WinPcap
721
- small utility, win_if_list, can be used to get interface name
722
* control interface can now be removed at build time; add
723
CONFIG_CTRL_IFACE=y to .config to maintain old functionality
724
* optional Xsupplicant interface can now be removed at build time;
725
(CONFIG_XSUPPLICANT_IFACE=y in .config to bring it back)
726
* added auth_alg to driver interface associate() parameters to make it
727
easier for drivers to configure authentication algorithm as part of
730
2004-12-05 - v0.3.0 (beginning of 0.3.x development releases)
731
* driver_broadcom: added new driver interface for Broadcom wl.o driver
732
(a generic driver for Broadcom IEEE 802.11a/g cards)
733
* wpa_cli: fixed parsing of -p <path> command line argument
734
* PEAPv1: fixed tunneled EAP-Success reply handling to reply with TLS
735
ACK, not tunneled EAP-Success (of which only the first byte was
736
actually send due to a bug in previous code); this seems to
737
interoperate with most RADIUS servers that implements PEAPv1
738
* PEAPv1: added support for terminating PEAP authentication on tunneled
739
EAP-Success message; this can be configured by adding
740
peap_outer_success=0 on phase1 parameters in wpa_supplicant.conf
741
(some RADIUS servers require this whereas others require a tunneled
743
* PEAPv1: changed phase1 option peaplabel to use default to 0, i.e., to
744
the old label for key derivation; previously, the default was 1,
745
but it looks like most existing PEAPv1 implementations use the old
746
label which is thus more suitable default option
747
* added support for EAP-PSK (draft-bersani-eap-psk-03.txt)
748
* fixed parsing of wep_tx_keyidx
749
* added support for configuring list of allowed Phase 2 EAP types
750
(for both EAP-PEAP and EAP-TTLS) instead of only one type
751
* added support for configuring IEEE 802.11 authentication algorithm
752
(auth_alg; mainly for using Shared Key authentication with static
754
* added support for EAP-AKA (with UMTS SIM)
755
* fixed couple of errors in PCSC handling that could have caused
756
random-looking errors for EAP-SIM
757
* added support for EAP-SIM pseudonyms and fast re-authentication
758
* added support for EAP-TLS/PEAP/TTLS fast re-authentication (TLS
760
* added support for EAP-SIM with two challanges
761
(phase1="sim_min_num_chal=3" can be used to require three challenges)
762
* added support for configuring DH/DSA parameters for an ephemeral DH
763
key exchange (EAP-TLS/PEAP/TTLS) using new configuration parameters
764
dh_file and dh_file2 (phase 2); this adds support for using DSA keys
765
and optional DH key exchange to achieve forward secracy with RSA keys
766
* added support for matching subject of the authentication server
767
certificate with a substring when using EAP-TLS/PEAP/TTLS; new
768
configuration variables subject_match and subject_match2
769
* changed SSID configuration in driver_wext.c (used by many driver
770
interfaces) to use ssid_len+1 as the length for SSID since some Linux
772
* fixed couple of unaligned reads in scan result parsing to fix WPA
773
connection on some platforms (e.g., ARM)
774
* added driver interface for Intel ipw2100 driver
775
* added support for LEAP with WPA
776
* added support for larger scan results report (old limit was 4 kB of
777
data, i.e., about 35 or so APs) when using Linux wireless extensions
779
* fixed a bug in PMKSA cache processing: skip sending of EAPOL-Start
780
only if there is a PMKSA cache entry for the current AP
781
* fixed error handling for case where reading of scan results fails:
782
must schedule a new scan or wpa_supplicant will remain waiting
784
* changed debug output to remove shared password/key material by
785
default; all key information can be included with -K command line
786
argument to match the previous behavior
787
* added support for timestamping debug log messages (disabled by
788
default, can be enabled with -t command line argument)
789
* set pairwise/group cipher suite for non-WPA IEEE 802.1X to WEP-104
790
if keys are not configured to be used; this fixes IEEE 802.1X mode
791
with drivers that use this information to configure whether Privacy
792
bit can be in Beacon frames (e.g., ndiswrapper)
793
* avoid clearing driver keys if no keys have been configured since last
794
key clear request; this seems to improve reliability of group key
795
handshake for ndiswrapper & NDIS driver which seems to be suffering
796
of some kind of timing issue when the keys are cleared again after
798
* changed driver interface API:
799
- WPA_SUPPLICANT_DRIVER_VERSION define can be used to determine which
800
version is being used (now, this is set to 2; previously, it was
802
- pass pointer to private data structure to all calls
803
- the new API is not backwards compatible; all in-tree driver
804
interfaces has been converted to the new API
805
* added support for controlling multiple interfaces (radios) per
806
wpa_supplicant process; each interface needs to be listed on the
807
command line (-c, -i, -D arguments) with -N as a separator
808
(-cwpa1.conf -iwlan0 -Dhostap -N -cwpa2.conf -iath0 -Dmadwifi)
809
* added a workaround for EAP servers that incorrectly use same Id for
810
sequential EAP packets
811
* changed libpcap/libdnet configuration to use .config variable,
812
CONFIG_DNET_PCAP, instead of requiring Makefile modification
813
* improved downgrade attack detection in IE verification of msg 3/4:
814
verify both WPA and RSN IEs, if present, not only the selected one;
815
reject the AP if an RSN IE is found in msg 3/4, but not in Beacon or
816
Probe Response frame, and RSN is enabled in wpa_supplicant
818
* fixed WPA msg 3/4 processing to allow Key Data field contain other
819
IEs than just one WPA IE
820
* added support for FreeBSD and driver interface for the BSD net80211
821
layer (CONFIG_DRIVER_BSD=y in .config); please note that some of the
822
required kernel mods have not yet been committed
823
* made EAP workarounds configurable; enabled by default, can be
824
disabled with network block option eap_workaround=0
826
2004-07-17 - v0.2.4 (beginning of 0.2.x stable releases)
827
* resolved couple of interoperability issues with EAP-PEAPv1 and
828
Phase 2 (inner EAP) fragment reassembly
829
* driver_madwifi: fixed WEP key configuration for IEEE 802.1X when the
830
AP is using non-zero key index for the unicast key and key index zero
831
for the broadcast key
832
* driver_hostap: fixed IEEE 802.1X WEP key updates and
833
re-authentication by allowing unencrypted EAPOL frames when not using
835
* added a new driver interface, 'wext', which uses only standard,
836
driver independent functionality in Linux wireless extensions;
837
currently, this can be used only for non-WPA IEEE 802.1X mode, but
838
eventually, this is to be extended to support full WPA/WPA2 once
839
Linux wireless extensions get support for this
840
* added support for mode in which the driver is responsible for AP
841
scanning and selection; this is disabled by default and can be
842
enabled with global ap_scan=0 variable in wpa_supplicant.conf;
843
this mode can be used, e.g., with generic 'wext' driver interface to
844
use wpa_supplicant as IEEE 802.1X Supplicant with any Linux driver
845
supporting wireless extensions.
846
* driver_madwifi: fixed WPA2 configuration and scan_ssid=1 (e.g.,
847
operation with an AP that does not include SSID in the Beacon frames)
848
* added support for new EAP authentication methods:
849
EAP-TTLS/EAP-OTP, EAP-PEAPv0/OTP, EAP-PEAPv1/OTP, EAP-OTP
850
* added support for asking one-time-passwords from frontends (e.g.,
851
wpa_cli); this 'otp' command works otherwise like 'password' command,
852
but the password is used only once and the frontend will be asked for
853
a new password whenever a request from authenticator requires a
854
password; this can be used with both EAP-OTP and EAP-GTC
855
* changed wpa_cli to automatically re-establish connection so that it
856
does not need to be re-started when wpa_supplicant is terminated and
858
* improved user data (identity/password/otp) requests through
859
frontends: process pending EAPOL packets after getting new
860
information so that full authentication does not need to be
861
restarted; in addition, send pending requests again whenever a new
863
* changed control frontends to use a new directory for socket files to
864
make it easier for wpa_cli to automatically select between interfaces
865
and to provide access control for the control interface;
866
wpa_supplicant.conf: ctrl_interface is now a path
867
(/var/run/wpa_supplicant is the recommended path) and
868
ctrl_interface_group can be used to select which group gets access to
869
the control interface;
870
wpa_cli: by default, try to connect to the first interface available
871
in /var/run/wpa_supplicant; this path can be overriden with -p option
872
and an interface can be selected with -i option (i.e., in most common
873
cases, wpa_cli does not need to get any arguments)
874
* added support for LEAP
875
* added driver interface for Linux ndiswrapper
876
* added priority option for network blocks in the configuration file;
877
this allows networks to be grouped based on priority (the scan
878
results are searched for matches with network blocks in this order)
881
* sort scan results to improve AP selection
882
* fixed control interface socket removal for some error cases
883
* improved scan requesting and authentication timeout
884
* small improvements/bug fixes for EAP-MSCHAPv2, EAP-PEAP, and
886
* PEAP version can now be forced with phase1="peapver=<ver>"
887
(mostly for testing; by default, the highest version supported by
888
both the Supplicant and Authentication Server is selected
890
* added support for madwifi driver (Atheros ar521x)
891
* added a workaround for cases where AP sets Install Tx/Rx bit for
892
WPA Group Key messages when pairwise keys are used (without this,
893
the Group Key would be used for Tx and the AP would drop frames
895
* added GSM SIM/USIM interface for GSM authentication algorithm for
896
EAP-SIM; this requires pcsc-lite
897
* added support for ATMEL AT76C5XXx driver
898
* fixed IEEE 802.1X WEP key derivation in the case where Authenticator
899
does not include key data in the EAPOL-Key frame (i.e., part of
900
EAP keying material is used as data encryption key)
901
* added support for using plaintext and static WEP networks
905
* added support for new EAP authentication methods:
906
EAP-TTLS/EAP-MD5-Challenge
908
EAP-TTLS/EAP-MSCHAPv2
916
EAP-PEAP/MD5-Challenge
918
EAP-SIM (not yet complete; needs GSM/SIM authentication interface)
919
* added support for anonymous identity (to be used when identity is
920
sent in plaintext; real identity will be used within TLS protected
921
tunnel (e.g., with EAP-TTLS)
922
* added event messages from wpa_supplicant to frontends, e.g., wpa_cli
923
* added support for requesting identity and password information using
924
control interface; in other words, the password for EAP-PEAP or
925
EAP-TTLS does not need to be included in the configuration file since
926
a frontand (e.g., wpa_cli) can ask it from the user
927
* improved RSN pre-authentication to use a candidate list and process
928
all candidates from each scan; not only one per scan
929
* fixed RSN IE and WPA IE capabilities field parsing
930
* ignore Tx bit in GTK IE when Pairwise keys are used
931
* avoid making new scan requests during IEEE 802.1X negotiation
932
* use openssl/libcrypto for MD5 and SHA-1 when compiling wpa_supplicant
933
with TLS support (this replaces the included implementation with
934
library code to save about 8 kB since the library code is needed
936
* fixed WPA-PSK only mode when compiled without IEEE 802.1X support
937
(i.e., without CONFIG_IEEE8021X_EAPOL=y in .config)
940
* added support for internal IEEE 802.1X (actually, IEEE 802.1aa/D6.1)
942
- EAPOL state machines for Supplicant [IEEE 802.1aa/D6.1]
943
- EAP peer state machine [draft-ietf-eap-statemachine-02.pdf]
944
- EAP-MD5 (cannot be used with WPA-RADIUS)
945
[draft-ietf-eap-rfc2284bis-09.txt]
947
- EAP-MSCHAPv2 (currently used only with EAP-PEAP)
948
- EAP-PEAP/MSCHAPv2 [draft-josefsson-pppext-eap-tls-eap-07.txt]
949
[draft-kamath-pppext-eap-mschapv2-00.txt]
950
(PEAP version 0, 1, and parts of 2; only 0 and 1 are enabled by
951
default; tested with FreeRADIUS, Microsoft IAS, and Funk Odyssey)
952
- new configuration file options: eap, identity, password, ca_cert,
953
client_cert, privatekey, private_key_passwd
954
- Xsupplicant is not required anymore, but it can be used by
955
disabling the internal IEEE 802.1X Supplicant with -e command line
957
- this code is not included in the default build; Makefile need to
958
be edited for this (uncomment lines for selected functionality)
959
- EAP-TLS and EAP-PEAP require openssl libraries
960
* use module prefix in debug messages (WPA, EAP, EAP-TLS, ..)
961
* added support for non-WPA IEEE 802.1X mode with dynamic WEP keys
962
(i.e., complete IEEE 802.1X/EAP authentication and use IEEE 802.1X
963
EAPOL-Key frames instead of WPA key handshakes)
964
* added support for IEEE 802.11i/RSN (WPA2)
965
- improved PTK Key Handshake
966
- PMKSA caching, pre-authentication
967
* fixed wpa_supplicant to ignore possible extra data after WPA
968
EAPOL-Key packets (this fixes 'Invalid EAPOL-Key MIC when using
969
TPTK' error from message 3 of 4-Way Handshake in case the AP
970
includes extra data after the EAPOL-Key)
971
* added interface for external programs (frontends) to control
973
- CLI example (wpa_cli) with interactive mode and command line
975
- replaced SIGUSR1 status/statistics with the new control interface
976
* made some feature compile time configurable
977
- .config file for make
978
- driver interfaces (hostap, hermes, ..)
979
- EAPOL/EAP functions
982
* Initial version of wpa_supplicant
added
removed
ChangeLog
