2
* hostapd / EAP-MSCHAPv2 (draft-kamath-pppext-eap-mschapv2-00.txt) server
3
* Copyright (c) 2004-2007, Jouni Malinen <j@w1.fi>
5
* This program is free software; you can redistribute it and/or modify
6
* it under the terms of the GNU General Public License version 2 as
7
* published by the Free Software Foundation.
9
* Alternatively, this software may be distributed under the terms of BSD
12
* See README and COPYING for more details.
22
struct eap_mschapv2_hdr {
23
u8 op_code; /* MSCHAPV2_OP_* */
24
u8 mschapv2_id; /* must be changed for challenges, but not for
26
u8 ms_length[2]; /* Note: misaligned; length - 5 */
27
/* followed by data */
30
#define MSCHAPV2_OP_CHALLENGE 1
31
#define MSCHAPV2_OP_RESPONSE 2
32
#define MSCHAPV2_OP_SUCCESS 3
33
#define MSCHAPV2_OP_FAILURE 4
34
#define MSCHAPV2_OP_CHANGE_PASSWORD 7
36
#define MSCHAPV2_RESP_LEN 49
38
#define ERROR_RESTRICTED_LOGON_HOURS 646
39
#define ERROR_ACCT_DISABLED 647
40
#define ERROR_PASSWD_EXPIRED 648
41
#define ERROR_NO_DIALIN_PERMISSION 649
42
#define ERROR_AUTHENTICATION_FAILURE 691
43
#define ERROR_CHANGING_PASSWORD 709
45
#define PASSWD_CHANGE_CHAL_LEN 16
46
#define MSCHAPV2_KEY_LEN 16
49
#define CHALLENGE_LEN 16
51
struct eap_mschapv2_data {
52
u8 auth_challenge[CHALLENGE_LEN];
54
enum { CHALLENGE, SUCCESS_REQ, FAILURE_REQ, SUCCESS, FAILURE } state;
61
static void * eap_mschapv2_init(struct eap_sm *sm)
63
struct eap_mschapv2_data *data;
65
data = os_zalloc(sizeof(*data));
68
data->state = CHALLENGE;
74
static void eap_mschapv2_reset(struct eap_sm *sm, void *priv)
76
struct eap_mschapv2_data *data = priv;
81
static u8 * eap_mschapv2_build_challenge(struct eap_sm *sm,
82
struct eap_mschapv2_data *data,
83
int id, size_t *reqDataLen)
86
struct eap_mschapv2_hdr *ms;
88
char *name = "hostapd"; /* TODO: make this configurable */
91
if (hostapd_get_rand(data->auth_challenge, CHALLENGE_LEN)) {
92
wpa_printf(MSG_ERROR, "EAP-MSCHAPV2: Failed to get random "
94
data->state = FAILURE;
98
ms_len = sizeof(*ms) + 1 + CHALLENGE_LEN + strlen(name);
99
req = eap_msg_alloc(EAP_VENDOR_IETF, EAP_TYPE_MSCHAPV2, reqDataLen,
100
ms_len, EAP_CODE_REQUEST, id, &pos);
102
wpa_printf(MSG_ERROR, "EAP-MSCHAPV2: Failed to allocate memory"
104
data->state = FAILURE;
108
ms = (struct eap_mschapv2_hdr *) pos;
109
ms->op_code = MSCHAPV2_OP_CHALLENGE;
110
ms->mschapv2_id = id;
111
WPA_PUT_BE16(ms->ms_length, ms_len);
113
pos = (u8 *) (ms + 1);
114
*pos++ = CHALLENGE_LEN;
115
memcpy(pos, data->auth_challenge, CHALLENGE_LEN);
116
wpa_hexdump(MSG_MSGDUMP, "EAP-MSCHAPV2: Challenge", pos,
118
pos += CHALLENGE_LEN;
119
memcpy(pos, name, strlen(name));
125
static u8 * eap_mschapv2_build_success_req(struct eap_sm *sm,
126
struct eap_mschapv2_data *data,
127
int id, size_t *reqDataLen)
130
struct eap_mschapv2_hdr *ms;
132
char *message = "OK";
135
ms_len = sizeof(*ms) + 2 + 2 * sizeof(data->auth_response) + 1 + 2 +
137
req = eap_msg_alloc(EAP_VENDOR_IETF, EAP_TYPE_MSCHAPV2, reqDataLen,
138
ms_len, EAP_CODE_REQUEST, id, &pos);
140
wpa_printf(MSG_ERROR, "EAP-MSCHAPV2: Failed to allocate memory"
142
data->state = FAILURE;
146
ms = (struct eap_mschapv2_hdr *) pos;
147
ms->op_code = MSCHAPV2_OP_SUCCESS;
148
ms->mschapv2_id = data->resp_mschapv2_id;
149
WPA_PUT_BE16(ms->ms_length, ms_len);
151
msg = pos = (u8 *) (ms + 1);
154
pos += wpa_snprintf_hex_uppercase((char *) pos,
155
sizeof(data->auth_response) * 2 + 1,
157
sizeof(data->auth_response));
161
memcpy(pos, message, strlen(message));
163
wpa_hexdump_ascii(MSG_MSGDUMP, "EAP-MSCHAPV2: Success Request Message",
164
msg, ms_len - sizeof(*ms));
170
static u8 * eap_mschapv2_build_failure_req(struct eap_sm *sm,
171
struct eap_mschapv2_data *data,
172
int id, size_t *reqDataLen)
175
struct eap_mschapv2_hdr *ms;
177
char *message = "E=691 R=0 C=00000000000000000000000000000000 V=3 "
181
ms_len = sizeof(*ms) + strlen(message);
182
req = eap_msg_alloc(EAP_VENDOR_IETF, EAP_TYPE_MSCHAPV2, reqDataLen,
183
ms_len, EAP_CODE_REQUEST, id, &pos);
185
wpa_printf(MSG_ERROR, "EAP-MSCHAPV2: Failed to allocate memory"
187
data->state = FAILURE;
191
ms = (struct eap_mschapv2_hdr *) pos;
192
ms->op_code = MSCHAPV2_OP_FAILURE;
193
ms->mschapv2_id = data->resp_mschapv2_id;
194
WPA_PUT_BE16(ms->ms_length, ms_len);
196
memcpy((u8 *) (ms + 1), message, strlen(message));
198
wpa_hexdump_ascii(MSG_MSGDUMP, "EAP-MSCHAPV2: Failure Request Message",
199
(u8 *) message, strlen(message));
205
static u8 * eap_mschapv2_buildReq(struct eap_sm *sm, void *priv, int id,
208
struct eap_mschapv2_data *data = priv;
210
switch (data->state) {
212
return eap_mschapv2_build_challenge(sm, data, id, reqDataLen);
214
return eap_mschapv2_build_success_req(sm, data, id,
217
return eap_mschapv2_build_failure_req(sm, data, id,
220
wpa_printf(MSG_DEBUG, "EAP-MSCHAPV2: Unknown state %d in "
221
"buildReq", data->state);
228
static Boolean eap_mschapv2_check(struct eap_sm *sm, void *priv,
229
u8 *respData, size_t respDataLen)
231
struct eap_mschapv2_data *data = priv;
232
struct eap_mschapv2_hdr *resp;
236
pos = eap_hdr_validate(EAP_VENDOR_IETF, EAP_TYPE_MSCHAPV2,
237
respData, respDataLen, &len);
238
if (pos == NULL || len < 1) {
239
wpa_printf(MSG_INFO, "EAP-MSCHAPV2: Invalid frame");
243
resp = (struct eap_mschapv2_hdr *) pos;
244
if (data->state == CHALLENGE &&
245
resp->op_code != MSCHAPV2_OP_RESPONSE) {
246
wpa_printf(MSG_DEBUG, "EAP-MSCHAPV2: Expected Response - "
247
"ignore op %d", resp->op_code);
251
if (data->state == SUCCESS_REQ &&
252
resp->op_code != MSCHAPV2_OP_SUCCESS &&
253
resp->op_code != MSCHAPV2_OP_FAILURE) {
254
wpa_printf(MSG_DEBUG, "EAP-MSCHAPV2: Expected Success or "
255
"Failure - ignore op %d", resp->op_code);
259
if (data->state == FAILURE_REQ &&
260
resp->op_code != MSCHAPV2_OP_FAILURE) {
261
wpa_printf(MSG_DEBUG, "EAP-MSCHAPV2: Expected Failure "
262
"- ignore op %d", resp->op_code);
270
static void eap_mschapv2_process_response(struct eap_sm *sm,
271
struct eap_mschapv2_data *data,
272
u8 *respData, size_t respDataLen)
274
struct eap_mschapv2_hdr *resp;
275
const u8 *pos, *end, *peer_challenge, *nt_response, *name;
277
size_t len, name_len, i;
279
const u8 *username, *user;
280
size_t username_len, user_len;
282
pos = eap_hdr_validate(EAP_VENDOR_IETF, EAP_TYPE_MSCHAPV2,
283
respData, respDataLen, &len);
284
if (pos == NULL || len < 1)
285
return; /* Should not happen - frame already validated */
288
resp = (struct eap_mschapv2_hdr *) pos;
289
pos = (u8 *) (resp + 1);
291
if (len < sizeof(*resp) + 1 + 49 ||
292
resp->op_code != MSCHAPV2_OP_RESPONSE ||
294
wpa_hexdump(MSG_DEBUG, "EAP-MSCHAPV2: Invalid response",
295
respData, respDataLen);
296
data->state = FAILURE;
299
data->resp_mschapv2_id = resp->mschapv2_id;
301
peer_challenge = pos;
307
name_len = end - name;
309
wpa_hexdump(MSG_MSGDUMP, "EAP-MSCHAPV2: Peer-Challenge",
311
wpa_hexdump(MSG_MSGDUMP, "EAP-MSCHAPV2: NT-Response", nt_response, 24);
312
wpa_printf(MSG_MSGDUMP, "EAP-MSCHAPV2: Flags 0x%x", flags);
313
wpa_hexdump_ascii(MSG_MSGDUMP, "EAP-MSCHAPV2: Name", name, name_len);
315
/* MSCHAPv2 does not include optional domain name in the
316
* challenge-response calculation, so remove domain prefix
318
username = sm->identity;
319
username_len = sm->identity_len;
320
for (i = 0; i < username_len; i++) {
321
if (username[i] == '\\') {
322
username_len -= i + 1;
330
for (i = 0; i < user_len; i++) {
331
if (user[i] == '\\') {
338
if (username_len != user_len ||
339
memcmp(username, user, username_len) != 0) {
340
wpa_printf(MSG_DEBUG, "EAP-MSCHAPV2: Mismatch in user names");
341
wpa_hexdump_ascii(MSG_DEBUG, "EAP-MSCHAPV2: Expected user "
342
"name", username, username_len);
343
wpa_hexdump_ascii(MSG_DEBUG, "EAP-MSCHAPV2: Received user "
344
"name", user, user_len);
345
data->state = FAILURE;
349
wpa_hexdump_ascii(MSG_MSGDUMP, "EAP-MSCHAPV2: User name",
350
username, username_len);
352
if (sm->user->password_hash) {
353
generate_nt_response_pwhash(data->auth_challenge,
355
username, username_len,
359
generate_nt_response(data->auth_challenge, peer_challenge,
360
username, username_len,
362
sm->user->password_len,
366
if (memcmp(nt_response, expected, 24) == 0) {
368
u8 pw_hash_buf[16], pw_hash_hash[16];
370
wpa_printf(MSG_DEBUG, "EAP-MSCHAPV2: Correct NT-Response");
371
data->state = SUCCESS_REQ;
373
/* Authenticator response is not really needed yet, but
374
* calculate it here so that peer_challenge and username need
376
if (sm->user->password_hash) {
377
pw_hash = sm->user->password;
378
generate_authenticator_response_pwhash(
379
sm->user->password, peer_challenge,
380
data->auth_challenge, username, username_len,
381
nt_response, data->auth_response);
383
nt_password_hash(sm->user->password,
384
sm->user->password_len,
386
pw_hash = pw_hash_buf;
387
generate_authenticator_response(sm->user->password,
388
sm->user->password_len,
390
data->auth_challenge,
391
username, username_len,
393
data->auth_response);
396
hash_nt_password_hash(pw_hash, pw_hash_hash);
397
get_master_key(pw_hash_hash, nt_response, data->master_key);
398
data->master_key_valid = 1;
399
wpa_hexdump_key(MSG_DEBUG, "EAP-MSCHAPV2: Derived Master Key",
400
data->master_key, MSCHAPV2_KEY_LEN);
402
wpa_hexdump(MSG_MSGDUMP, "EAP-MSCHAPV2: Expected NT-Response",
404
wpa_printf(MSG_DEBUG, "EAP-MSCHAPV2: Invalid NT-Response");
405
data->state = FAILURE_REQ;
410
static void eap_mschapv2_process_success_resp(struct eap_sm *sm,
411
struct eap_mschapv2_data *data,
412
u8 *respData, size_t respDataLen)
414
struct eap_mschapv2_hdr *resp;
418
pos = eap_hdr_validate(EAP_VENDOR_IETF, EAP_TYPE_MSCHAPV2,
419
respData, respDataLen, &len);
420
if (pos == NULL || len < 1)
421
return; /* Should not happen - frame already validated */
423
resp = (struct eap_mschapv2_hdr *) pos;
425
if (resp->op_code == MSCHAPV2_OP_SUCCESS) {
426
wpa_printf(MSG_DEBUG, "EAP-MSCHAPV2: Received Success Response"
427
" - authentication completed successfully");
428
data->state = SUCCESS;
430
wpa_printf(MSG_DEBUG, "EAP-MSCHAPV2: Did not receive Success "
431
"Response - peer rejected authentication");
432
data->state = FAILURE;
437
static void eap_mschapv2_process_failure_resp(struct eap_sm *sm,
438
struct eap_mschapv2_data *data,
439
u8 *respData, size_t respDataLen)
441
struct eap_mschapv2_hdr *resp;
445
pos = eap_hdr_validate(EAP_VENDOR_IETF, EAP_TYPE_MSCHAPV2,
446
respData, respDataLen, &len);
447
if (pos == NULL || len < 1)
448
return; /* Should not happen - frame already validated */
450
resp = (struct eap_mschapv2_hdr *) pos;
452
if (resp->op_code == MSCHAPV2_OP_FAILURE) {
453
wpa_printf(MSG_DEBUG, "EAP-MSCHAPV2: Received Failure Response"
454
" - authentication failed");
456
wpa_printf(MSG_DEBUG, "EAP-MSCHAPV2: Did not receive Failure "
457
"Response - authentication failed");
460
data->state = FAILURE;
464
static void eap_mschapv2_process(struct eap_sm *sm, void *priv,
465
u8 *respData, size_t respDataLen)
467
struct eap_mschapv2_data *data = priv;
469
if (sm->user == NULL || sm->user->password == NULL) {
470
wpa_printf(MSG_INFO, "EAP-MSCHAPV2: Password not configured");
471
data->state = FAILURE;
475
switch (data->state) {
477
eap_mschapv2_process_response(sm, data, respData, respDataLen);
480
eap_mschapv2_process_success_resp(sm, data, respData,
484
eap_mschapv2_process_failure_resp(sm, data, respData,
488
wpa_printf(MSG_DEBUG, "EAP-MSCHAPV2: Unknown state %d in "
489
"process", data->state);
495
static Boolean eap_mschapv2_isDone(struct eap_sm *sm, void *priv)
497
struct eap_mschapv2_data *data = priv;
498
return data->state == SUCCESS || data->state == FAILURE;
502
static u8 * eap_mschapv2_getKey(struct eap_sm *sm, void *priv, size_t *len)
504
struct eap_mschapv2_data *data = priv;
507
if (data->state != SUCCESS || !data->master_key_valid)
510
*len = 2 * MSCHAPV2_KEY_LEN;
514
get_asymetric_start_key(data->master_key, key, MSCHAPV2_KEY_LEN, 0, 0);
515
get_asymetric_start_key(data->master_key, key + MSCHAPV2_KEY_LEN,
516
MSCHAPV2_KEY_LEN, 1, 0);
517
wpa_hexdump_key(MSG_DEBUG, "EAP-MSCHAPV2: Derived key", key, *len);
523
static Boolean eap_mschapv2_isSuccess(struct eap_sm *sm, void *priv)
525
struct eap_mschapv2_data *data = priv;
526
return data->state == SUCCESS;
530
int eap_server_mschapv2_register(void)
532
struct eap_method *eap;
535
eap = eap_server_method_alloc(EAP_SERVER_METHOD_INTERFACE_VERSION,
536
EAP_VENDOR_IETF, EAP_TYPE_MSCHAPV2,
541
eap->init = eap_mschapv2_init;
542
eap->reset = eap_mschapv2_reset;
543
eap->buildReq = eap_mschapv2_buildReq;
544
eap->check = eap_mschapv2_check;
545
eap->process = eap_mschapv2_process;
546
eap->isDone = eap_mschapv2_isDone;
547
eap->getKey = eap_mschapv2_getKey;
548
eap->isSuccess = eap_mschapv2_isSuccess;
550
ret = eap_server_method_register(eap);
552
eap_server_method_free(eap);