xref: /freebsd/contrib/wpa/wpa_supplicant/eap_testing.txt (revision 924226fba12cc9a228c73b956e1b7fa24c60b055)
1Automatic regression and interoperability testing of wpa_supplicant's
2IEEE 802.1X/EAPOL authentication
3
4Test program:
5- Linked some parts of IEEE 802.1X Authenticator implementation from
6  hostapd (RADIUS client and RADIUS processing, EAP<->RADIUS
7  encapsulation/decapsulation) into wpa_supplicant.
8- Replaced wpa_supplicant.c and wpa.c with test code that trigger
9  IEEE 802.1X authentication automatically without need for wireless
10  client card or AP.
11- For EAP methods that generate keying material, the key derived by the
12  Supplicant is verified to match with the one received by the (now
13  integrated) Authenticator.
14
15The full automated test suite can now be run in couple of seconds, but
16I'm more than willing to add new RADIUS authentication servers to make
17this take a bit more time.. ;-) As an extra bonus, this can also be
18seen as automatic regression/interoperability testing for the RADIUS
19server, too.
20
21In order for me to be able to use a new authentication server, the
22server need to be available from Internet (at least from one static IP
23address) and I will need to get suitable user name/password pairs,
24certificates, and private keys for testing use. Other alternative
25would be to get an evaluation version of the server so that I can
26install it on my own test setup. If you are interested in providing
27either server access or evaluation version, please contact me
28(j@w1.fi).
29
30
31Test matrix
32
33+) tested successfully
34F) failed
35-) server did not support
36?) not tested
37
38Cisco ACS ----------------------------------------------------------.
39hostapd --------------------------------------------------------.   |
40Cisco Aironet 1200 AP (local RADIUS server) ----------------.   |   |
41Periodik Labs Elektron ---------------------------------.   |   |   |
42Lucent NavisRadius ---------------------------------.   |   |   |   |
43Interlink RAD-Series ---------------------------.   |   |   |   |   |
44Radiator -----------------------------------.   |   |   |   |   |   |
45Meetinghouse Aegis ---------------------.   |   |   |   |   |   |   |
46Funk Steel-Belted ------------------.   |   |   |   |   |   |   |   |
47Funk Odyssey -------------------.   |   |   |   |   |   |   |   |   |
48Microsoft IAS --------------.   |   |   |   |   |   |   |   |   |   |
49FreeRADIUS -------------.   |   |   |   |   |   |   |   |   |   |   |
50			|   |   |   |   |   |   |   |   |   |   |   |
51
52EAP-MD5			+   -   -   +   +   +   +   +   -   -   +   +
53EAP-GTC			+   -   -   ?   +   +   +   +   -   -   +   -
54EAP-OTP			-   -   -   -   -   +   -   -   -   -   -   -
55EAP-MSCHAPv2		+   -   -   +   +   +   +   +   -   -   +   -
56EAP-TLS			+   +   +   +   +   +   +   +   -   -   +   +
57EAP-PEAPv0/MSCHAPv2	+   +   +   +   +   +   +   +   +   -   +   +
58EAP-PEAPv0/GTC		+   -   +   -   +   +   +   +   -   -   +   +
59EAP-PEAPv0/OTP		-   -   -   -   -   +   -   -   -   -   -   -
60EAP-PEAPv0/MD5		+   -   -   +   +   +   +   +   -   -   +   -
61EAP-PEAPv0/TLS		+   +   -   +   +   +   F   +   -   -   +   +
62EAP-PEAPv0/SIM		-   -   -   -   -   -   -   -   -   -   +   -
63EAP-PEAPv0/AKA		-   -   -   -   -   -   -   -   -   -   +   -
64EAP-PEAPv0/PSK		-   -   -   -   -   -   -   -   -   -   +   -
65EAP-PEAPv0/PAX		-   -   -   -   -   -   -   -   -   -   +   -
66EAP-PEAPv0/SAKE		-   -   -   -   -   -   -   -   -   -   +   -
67EAP-PEAPv0/GPSK		-   -   -   -   -   -   -   -   -   -   +   -
68EAP-PEAPv1/MSCHAPv2	-   -   +   +   +   +1  +   +5  +8  -   +   +
69EAP-PEAPv1/GTC		-   -   +   +   +   +1  +   +5  +8  -   +   +
70EAP-PEAPv1/OTP		-   -   -   -   -   +1  -   -   -   -   -   -
71EAP-PEAPv1/MD5		-   -   -   +   +   +1  +   +5  -   -   +   -
72EAP-PEAPv1/TLS		-   -   -   +   +   +1  F   +5  -   -   +   +
73EAP-PEAPv1/SIM		-   -   -   -   -   -   -   -   -   -   +   -
74EAP-PEAPv1/AKA		-   -   -   -   -   -   -   -   -   -   +   -
75EAP-PEAPv1/PSK		-   -   -   -   -   -   -   -   -   -   +   -
76EAP-PEAPv1/PAX		-   -   -   -   -   -   -   -   -   -   +   -
77EAP-PEAPv1/SAKE		-   -   -   -   -   -   -   -   -   -   +   -
78EAP-PEAPv1/GPSK		-   -   -   -   -   -   -   -   -   -   +   -
79EAP-TTLS/CHAP		+   -   +2  +   +   +   +   +   +   -   +   -
80EAP-TTLS/MSCHAP		+   -   +   +   +   +   +   +   +   -   +   -
81EAP-TTLS/MSCHAPv2	+   -   +   +   +   +   +   +   +   -   +   -
82EAP-TTLS/PAP		+   -   +   +   +   +   +   +   +   -   +   -
83EAP-TTLS/EAP-MD5	+   -   +2  +   +   +   +   +   +   -   +   -
84EAP-TTLS/EAP-GTC	+   -   +2  ?   +   +   +   +   -   -   +   -
85EAP-TTLS/EAP-OTP	-   -   -   -   -   +   -   -   -   -   -   -
86EAP-TTLS/EAP-MSCHAPv2	+   -   +2  +   +   +   +   +   +   -   +   -
87EAP-TTLS/EAP-TLS	+   -   +2  +   F   +   +   +   -   -   +   -
88EAP-TTLS/EAP-SIM	-   -   -   -   -   -   -   -   -   -   +   -
89EAP-TTLS/EAP-AKA	-   -   -   -   -   -   -   -   -   -   +   -
90EAP-TTLS/EAP-PSK	-   -   -   -   -   -   -   -   -   -   +   -
91EAP-TTLS/EAP-PAX	-   -   -   -   -   -   -   -   -   -   +   -
92EAP-TTLS/EAP-SAKE	-   -   -   -   -   -   -   -   -   -   +   -
93EAP-TTLS/EAP-GPSK	-   -   -   -   -   -   -   -   -   -   +   -
94EAP-TTLS + TNC		-   -   -   -   -   +   -   -   -   -   +   -
95EAP-SIM			+   -   -   ?   -   +   -   ?   -   -   +   -
96EAP-AKA			-   -   -   -   -   +   -   -   -   -   +   -
97EAP-AKA'		-   -   -   -   -   -   -   -   -   -   +   -
98EAP-PSK			+7  -   -   -   -   +   -   -   -   -   +   -
99EAP-PAX			-   -   -   -   -   +   -   -   -   -   +   -
100EAP-SAKE		-   -   -   -   -   -   -   -   -   -   +   -
101EAP-GPSK		-   -   -   -   -   -   -   -   -   -   +   -
102EAP-FAST/MSCHAPv2(prov)	-   -   -   +   -   +   -   -   -   +   +   +
103EAP-FAST/GTC(auth)	-   -   -   +   -   +   -   -   -   +   +   +
104EAP-FAST/MSCHAPv2(aprov)-   -   -   -   -   +   -   -   -   -   +   +
105EAP-FAST/GTC(aprov)	-   -   -   -   -   +   -   -   -   -   +   +
106EAP-FAST/MD5(aprov)	-   -   -   -   -   +   -   -   -   -   +   -
107EAP-FAST/TLS(aprov)	-   -   -   -   -   -   -   -   -   -   +   +
108EAP-FAST/SIM(aprov)	-   -   -   -   -   -   -   -   -   -   +   -
109EAP-FAST/AKA(aprov)	-   -   -   -   -   -   -   -   -   -   +   -
110EAP-FAST/MSCHAPv2(auth)	-   -   -   -   -   +   -   -   -   -   +   +
111EAP-FAST/MD5(auth)	-   -   -   -   -   +   -   -   -   -   +   -
112EAP-FAST/TLS(auth)	-   -   -   -   -   -   -   -   -   -   +   +
113EAP-FAST/SIM(auth)	-   -   -   -   -   -   -   -   -   -   +   -
114EAP-FAST/AKA(auth)	-   -   -   -   -   -   -   -   -   -   +   -
115EAP-FAST + TNC		-   -   -   -   -   -   -   -   -   -   +   -
116LEAP			+   -   +   +   +   +   F   +6  -   +   -   +
117EAP-TNC			+9  -   -   -   -   +   -   -   -   -   +   -
118EAP-IKEv2		+10 -   -   -   -   -   -   -   -   -   +   -
119
1201) PEAPv1 required new label, "client PEAP encryption" instead of "client EAP
121   encryption", during key derivation (requires phase1="peaplabel=1" in the
122   network configuration in wpa_supplicant.conf)
1232) used FreeRADIUS as inner auth server
1245) PEAPv1 required termination of negotiation on tunneled EAP-Success and new
125   label in key deriviation
126   (phase1="peap_outer_success=0 peaplabel=1") (in "IETF Draft 5" mode)
1276) Authenticator simulator required patching for handling Access-Accept within
128   negotiation (for the first EAP-Success of LEAP)
1297) tested only with an older (incompatible) draft of EAP-PSK; FreeRADIUS does
130   not support the current EAP-PSK (RFC) specification
1318) PEAPv1 used non-standard version negotiation (client had to force v1 even
132   though server reported v0 as the highest supported version)
1339) only EAP-TTLS/EAP-TNC tested, i.e., test did not include proper sequence of
134   client authentication followed by TNC inside the tunnel
13510) worked only with special compatibility code to match the IKEv2 server
136    implementation
137
138
139Automated tests:
140
141FreeRADIUS (2.0-beta/CVS snapshot)
142- EAP-MD5-Challenge
143- EAP-GTC
144- EAP-MSCHAPv2
145- EAP-TLS
146- EAP-PEAPv0 / MSCHAPv2
147- EAP-PEAPv0 / GTC
148- EAP-PEAPv0 / MD5-Challenge
149- EAP-PEAPv0 / TLS
150- EAP-TTLS / EAP-MD5-Challenge
151- EAP-TTLS / EAP-GTC
152- EAP-TTLS / EAP-MSCHAPv2
153- EAP-TTLS / EAP-TLS
154- EAP-TTLS / CHAP
155- EAP-TTLS / PAP
156- EAP-TTLS / MSCHAP
157- EAP-TTLS / MSCHAPv2
158- EAP-TTLS / EAP-TNC (partial support; no authentication sequence)
159- EAP-SIM
160- LEAP
161
162Microsoft Windows Server 2003 / IAS
163- EAP-TLS
164- EAP-PEAPv0 / MSCHAPv2
165- EAP-PEAPv0 / TLS
166- EAP-MD5
167* IAS does not seem to support other EAP methods
168
169Funk Odyssey 2.01.00.653
170- EAP-TLS
171- EAP-PEAPv0 / MSCHAPv2
172- EAP-PEAPv0 / GTC
173- EAP-PEAPv1 / MSCHAPv2
174- EAP-PEAPv1 / GTC
175  Note: PEAPv1 requires TLS key derivation to use label "client EAP encryption"
176- EAP-TTLS / CHAP (using FreeRADIUS as inner auth srv)
177- EAP-TTLS / MSCHAP
178- EAP-TTLS / MSCHAPv2
179- EAP-TTLS / PAP
180- EAP-TTLS / EAP-MD5-Challenge (using FreeRADIUS as inner auth srv)
181- EAP-TTLS / EAP-GTC (using FreeRADIUS as inner auth srv)
182- EAP-TTLS / EAP-MSCHAPv2 (using FreeRADIUS as inner auth srv)
183- EAP-TTLS / EAP-TLS (using FreeRADIUS as inner auth srv)
184* not supported in Odyssey:
185  - EAP-MD5-Challenge
186  - EAP-GTC
187  - EAP-MSCHAPv2
188  - EAP-PEAP / MD5-Challenge
189  - EAP-PEAP / TLS
190
191Funk Steel-Belted Radius Enterprise Edition v4.71.739
192- EAP-MD5-Challenge
193- EAP-MSCHAPv2
194- EAP-TLS
195- EAP-PEAPv0 / MSCHAPv2
196- EAP-PEAPv0 / MD5
197- EAP-PEAPv0 / TLS
198- EAP-PEAPv1 / MSCHAPv2
199- EAP-PEAPv1 / MD5
200- EAP-PEAPv1 / GTC
201- EAP-PEAPv1 / TLS
202  Note: PEAPv1 requires TLS key derivation to use label "client EAP encryption"
203- EAP-TTLS / CHAP
204- EAP-TTLS / MSCHAP
205- EAP-TTLS / MSCHAPv2
206- EAP-TTLS / PAP
207- EAP-TTLS / EAP-MD5-Challenge
208- EAP-TTLS / EAP-MSCHAPv2
209- EAP-TTLS / EAP-TLS
210
211Meetinghouse Aegis 1.1.4
212- EAP-MD5-Challenge
213- EAP-GTC
214- EAP-MSCHAPv2
215- EAP-TLS
216- EAP-PEAPv0 / MSCHAPv2
217- EAP-PEAPv0 / TLS
218- EAP-PEAPv0 / GTC
219- EAP-PEAPv0 / MD5-Challenge
220- EAP-PEAPv1 / MSCHAPv2
221- EAP-PEAPv1 / TLS
222- EAP-PEAPv1 / GTC
223- EAP-PEAPv1 / MD5-Challenge
224  Note: PEAPv1 requires TLS key derivation to use label "client EAP encryption"
225- EAP-TTLS / CHAP
226- EAP-TTLS / MSCHAP
227- EAP-TTLS / MSCHAPv2
228- EAP-TTLS / PAP
229- EAP-TTLS / EAP-MD5-Challenge
230- EAP-TTLS / EAP-GTC
231- EAP-TTLS / EAP-MSCHAPv2
232* did not work
233  - EAP-TTLS / EAP-TLS
234    (Server rejects authentication without any reason in debug log. It
235     looks like the inner TLS negotiation starts properly and the last
236     packet from Supplicant looks like the one sent in the Phase 1. The
237     server generates a valid looking reply in the same way as in Phase
238     1, but then ends up sending Access-Reject. Maybe an issue with TTLS
239     fragmentation in the Aegis server(?) The packet seems to include
240     1328 bytes of EAP-Message and this may go beyond the fragmentation
241     limit with AVP encapsulation and TLS tunneling. Note: EAP-PEAP/TLS
242     did work, so this issue seems to be with something TTLS specific.)
243
244Radiator 3.17.1 (eval, with all patches up to and including 2007-05-25)
245- EAP-MD5-Challenge
246- EAP-GTC
247- EAP-OTP
248- EAP-MSCHAPv2
249- EAP-TLS
250- EAP-PEAPv0 / MSCHAPv2
251- EAP-PEAPv0 / GTC
252- EAP-PEAPv0 / OTP
253- EAP-PEAPv0 / MD5-Challenge
254- EAP-PEAPv0 / TLS
255  Note: Needed to use unknown identity in outer auth and some times the server
256	seems to get confused and fails to send proper Phase 2 data.
257- EAP-PEAPv1 / MSCHAPv2
258- EAP-PEAPv1 / GTC
259- EAP-PEAPv1 / OTP
260- EAP-PEAPv1 / MD5-Challenge
261- EAP-PEAPv1 / TLS
262  Note: This has some additional requirements for EAPTLS_MaxFragmentSize.
263        Using 1300 for outer auth and 500 for inner auth seemed to work.
264  Note: Needed to use unknown identity in outer auth and some times the server
265	seems to get confused and fails to send proper Phase 2 data.
266- EAP-TTLS / CHAP
267- EAP-TTLS / MSCHAP
268- EAP-TTLS / MSCHAPv2
269- EAP-TTLS / PAP
270- EAP-TTLS / EAP-MD5-Challenge
271- EAP-TTLS / EAP-GTC
272- EAP-TTLS / EAP-OTP
273- EAP-TTLS / EAP-MSCHAPv2
274- EAP-TTLS / EAP-TLS
275  Note: This has some additional requirements for EAPTLS_MaxFragmentSize.
276        Using 1300 for outer auth and 500 for inner auth seemed to work.
277- EAP-SIM
278- EAP-AKA
279- EAP-PSK
280- EAP-PAX
281- EAP-TNC
282
283Interlink Networks RAD-Series 6.1.2.7
284- EAP-MD5-Challenge
285- EAP-GTC
286- EAP-MSCHAPv2
287- EAP-TLS
288- EAP-PEAPv0 / MSCHAPv2
289- EAP-PEAPv0 / GTC
290- EAP-PEAPv0 / MD5-Challenge
291- EAP-PEAPv1 / MSCHAPv2
292- EAP-PEAPv1 / GTC
293- EAP-PEAPv1 / MD5-Challenge
294  Note: PEAPv1 requires TLS key derivation to use label "client EAP encryption"
295- EAP-TTLS / CHAP
296- EAP-TTLS / MSCHAP
297- EAP-TTLS / MSCHAPv2
298- EAP-TTLS / PAP
299- EAP-TTLS / EAP-MD5-Challenge
300- EAP-TTLS / EAP-GTC
301- EAP-TTLS / EAP-MSCHAPv2
302- EAP-TTLS / EAP-TLS
303* did not work
304  - EAP-PEAPv0 / TLS
305  - EAP-PEAPv1 / TLS
306    (Failed to decrypt Phase 2 data)
307
308Lucent NavisRadius 4.4.0
309- EAP-MD5-Challenge
310- EAP-GTC
311- EAP-MSCHAPv2
312- EAP-TLS
313- EAP-PEAPv0 / MD5-Challenge
314- EAP-PEAPv0 / MSCHAPv2
315- EAP-PEAPv0 / GTC
316- EAP-PEAPv0 / TLS
317- EAP-PEAPv1 / MD5-Challenge
318- EAP-PEAPv1 / MSCHAPv2
319- EAP-PEAPv1 / GTC
320- EAP-PEAPv1 / TLS
321  "IETF Draft 5" mode requires phase1="peap_outer_success=0 peaplabel=1"
322  'Cisco ACU 5.05' mode works without phase1 configuration
323- EAP-TTLS / CHAP
324- EAP-TTLS / MSCHAP
325- EAP-TTLS / MSCHAPv2
326- EAP-TTLS / PAP
327- EAP-TTLS / EAP-MD5-Challenge
328- EAP-TTLS / EAP-MSCHAPv2
329- EAP-TTLS / EAP-GTC
330- EAP-TTLS / EAP-TLS
331
332Note: user certificate from NavisRadius had private key in a format
333that wpa_supplicant could not use. Converting this to PKCS#12 and then
334back to PEM allowed wpa_supplicant to use the key.
335
336
337hostapd v0.3.3
338- EAP-MD5-Challenge
339- EAP-GTC
340- EAP-MSCHAPv2
341- EAP-TLS
342- EAP-PEAPv0 / MSCHAPv2
343- EAP-PEAPv0 / GTC
344- EAP-PEAPv0 / MD5-Challenge
345- EAP-PEAPv1 / MSCHAPv2
346- EAP-PEAPv1 / GTC
347- EAP-PEAPv1 / MD5-Challenge
348- EAP-TTLS / CHAP
349- EAP-TTLS / MSCHAP
350- EAP-TTLS / MSCHAPv2
351- EAP-TTLS / PAP
352- EAP-TTLS / EAP-MD5-Challenge
353- EAP-TTLS / EAP-GTC
354- EAP-TTLS / EAP-MSCHAPv2
355- EAP-SIM
356- EAP-PAX
357
358PEAPv1:
359
360Funk Odyssey 2.01.00.653:
361- uses tunneled EAP-Success, expects reply in tunnel or TLS ACK, sends MPPE
362  keys with outer EAP-Success message after this
363- uses label "client EAP encryption"
364- (peap_outer_success 1 and 2 work)
365
366Funk Steel-Belted Radius Enterprise Edition v4.71.739
367- uses tunneled EAP-Success, expects reply in tunnel or TLS ACK, sends MPPE
368  keys with outer EAP-Success message after this
369- uses label "client EAP encryption"
370- (peap_outer_success 1 and 2 work)
371
372Radiator 3.9:
373- uses TLV Success and Reply, sends MPPE keys with outer EAP-Success message
374  after this
375- uses label "client PEAP encryption"
376
377Lucent NavisRadius 4.4.0 (in "IETF Draft 5" mode):
378- sends tunneled EAP-Success with MPPE keys and expects the authentication to
379  terminate at this point (gets somewhat confused with reply to this)
380- uses label "client PEAP encryption"
381- phase1="peap_outer_success=0 peaplabel=1"
382
383Lucent NavisRadius 4.4.0 (in "Cisco ACU 5.05" mode):
384- sends tunneled EAP-Success with MPPE keys and expects to receive TLS ACK
385  as a reply
386- uses label "client EAP encryption"
387
388Meetinghouse Aegis 1.1.4
389- uses tunneled EAP-Success, expects reply in tunnel or TLS ACK, sends MPPE
390  keys with outer EAP-Success message after this
391- uses label "client EAP encryption"
392- peap_outer_success 1 and 2 work
393