2 * EAP peer method: EAP-PSK (RFC 4764)
3 * Copyright (c) 2004-2008, Jouni Malinen <j@w1.fi>
5 * This software may be distributed under the terms of the BSD license.
6 * See README for more details.
8 * Note: EAP-PSK is an EAP authentication method and as such, completely
9 * different from WPA-PSK. This file is not needed for WPA-PSK functionality.
15 #include "crypto/aes_wrap.h"
16 #include "crypto/random.h"
17 #include "eap_common/eap_psk_common.h"
22 enum { PSK_INIT, PSK_MAC_SENT, PSK_DONE } state;
23 u8 rand_p[EAP_PSK_RAND_LEN];
24 u8 rand_s[EAP_PSK_RAND_LEN];
25 u8 ak[EAP_PSK_AK_LEN], kdk[EAP_PSK_KDK_LEN], tek[EAP_PSK_TEK_LEN];
27 size_t id_s_len, id_p_len;
29 u8 emsk[EAP_EMSK_LEN];
33 static void * eap_psk_init(struct eap_sm *sm)
35 struct eap_psk_data *data;
36 const u8 *identity, *password;
37 size_t identity_len, password_len;
39 password = eap_get_config_password(sm, &password_len);
40 if (!password || password_len != 16) {
41 wpa_printf(MSG_INFO, "EAP-PSK: 16-octet pre-shared key not "
46 data = os_zalloc(sizeof(*data));
49 if (eap_psk_key_setup(password, data->ak, data->kdk)) {
53 wpa_hexdump_key(MSG_DEBUG, "EAP-PSK: AK", data->ak, EAP_PSK_AK_LEN);
54 wpa_hexdump_key(MSG_DEBUG, "EAP-PSK: KDK", data->kdk, EAP_PSK_KDK_LEN);
55 data->state = PSK_INIT;
57 identity = eap_get_config_identity(sm, &identity_len);
59 data->id_p = os_malloc(identity_len);
61 os_memcpy(data->id_p, identity, identity_len);
62 data->id_p_len = identity_len;
64 if (data->id_p == NULL) {
65 wpa_printf(MSG_INFO, "EAP-PSK: could not get own identity");
74 static void eap_psk_deinit(struct eap_sm *sm, void *priv)
76 struct eap_psk_data *data = priv;
79 bin_clear_free(data, sizeof(*data));
83 static struct wpabuf * eap_psk_process_1(struct eap_psk_data *data,
84 struct eap_method_ret *ret,
85 const struct wpabuf *reqData)
87 const struct eap_psk_hdr_1 *hdr1;
88 struct eap_psk_hdr_2 *hdr2;
94 wpa_printf(MSG_DEBUG, "EAP-PSK: in INIT state");
96 cpos = eap_hdr_validate(EAP_VENDOR_IETF, EAP_TYPE_PSK, reqData, &len);
97 hdr1 = (const struct eap_psk_hdr_1 *) cpos;
98 if (cpos == NULL || len < sizeof(*hdr1)) {
99 wpa_printf(MSG_INFO, "EAP-PSK: Invalid first message "
100 "length (%lu; expected %lu or more)",
102 (unsigned long) sizeof(*hdr1));
106 wpa_printf(MSG_DEBUG, "EAP-PSK: Flags=0x%x", hdr1->flags);
107 if (EAP_PSK_FLAGS_GET_T(hdr1->flags) != 0) {
108 wpa_printf(MSG_INFO, "EAP-PSK: Unexpected T=%d (expected 0)",
109 EAP_PSK_FLAGS_GET_T(hdr1->flags));
110 ret->methodState = METHOD_DONE;
111 ret->decision = DECISION_FAIL;
114 wpa_hexdump(MSG_DEBUG, "EAP-PSK: RAND_S", hdr1->rand_s,
116 os_memcpy(data->rand_s, hdr1->rand_s, EAP_PSK_RAND_LEN);
118 data->id_s_len = len - sizeof(*hdr1);
119 data->id_s = os_memdup(hdr1 + 1, data->id_s_len);
120 if (data->id_s == NULL) {
121 wpa_printf(MSG_ERROR, "EAP-PSK: Failed to allocate memory for "
122 "ID_S (len=%lu)", (unsigned long) data->id_s_len);
126 wpa_hexdump_ascii(MSG_DEBUG, "EAP-PSK: ID_S",
127 data->id_s, data->id_s_len);
129 if (random_get_bytes(data->rand_p, EAP_PSK_RAND_LEN)) {
130 wpa_printf(MSG_ERROR, "EAP-PSK: Failed to get random data");
135 resp = eap_msg_alloc(EAP_VENDOR_IETF, EAP_TYPE_PSK,
136 sizeof(*hdr2) + data->id_p_len, EAP_CODE_RESPONSE,
137 eap_get_id(reqData));
140 hdr2 = wpabuf_put(resp, sizeof(*hdr2));
141 hdr2->flags = EAP_PSK_FLAGS_SET_T(1); /* T=1 */
142 os_memcpy(hdr2->rand_s, hdr1->rand_s, EAP_PSK_RAND_LEN);
143 os_memcpy(hdr2->rand_p, data->rand_p, EAP_PSK_RAND_LEN);
144 wpabuf_put_data(resp, data->id_p, data->id_p_len);
145 /* MAC_P = OMAC1-AES-128(AK, ID_P||ID_S||RAND_S||RAND_P) */
146 buflen = data->id_p_len + data->id_s_len + 2 * EAP_PSK_RAND_LEN;
147 buf = os_malloc(buflen);
152 os_memcpy(buf, data->id_p, data->id_p_len);
153 pos = buf + data->id_p_len;
154 os_memcpy(pos, data->id_s, data->id_s_len);
155 pos += data->id_s_len;
156 os_memcpy(pos, hdr1->rand_s, EAP_PSK_RAND_LEN);
157 pos += EAP_PSK_RAND_LEN;
158 os_memcpy(pos, data->rand_p, EAP_PSK_RAND_LEN);
159 if (omac1_aes_128(data->ak, buf, buflen, hdr2->mac_p)) {
165 wpa_hexdump(MSG_DEBUG, "EAP-PSK: RAND_P", hdr2->rand_p,
167 wpa_hexdump(MSG_DEBUG, "EAP-PSK: MAC_P", hdr2->mac_p, EAP_PSK_MAC_LEN);
168 wpa_hexdump_ascii(MSG_DEBUG, "EAP-PSK: ID_P",
169 data->id_p, data->id_p_len);
171 data->state = PSK_MAC_SENT;
177 static struct wpabuf * eap_psk_process_3(struct eap_psk_data *data,
178 struct eap_method_ret *ret,
179 const struct wpabuf *reqData)
181 const struct eap_psk_hdr_3 *hdr3;
182 struct eap_psk_hdr_4 *hdr4;
184 u8 *buf, *rpchannel, nonce[16], *decrypted;
185 const u8 *pchannel, *tag, *msg;
186 u8 mac[EAP_PSK_MAC_LEN];
187 size_t buflen, left, data_len, len, plen;
191 wpa_printf(MSG_DEBUG, "EAP-PSK: in MAC_SENT state");
193 pos = eap_hdr_validate(EAP_VENDOR_IETF, EAP_TYPE_PSK,
195 hdr3 = (const struct eap_psk_hdr_3 *) pos;
196 if (pos == NULL || len < sizeof(*hdr3)) {
197 wpa_printf(MSG_INFO, "EAP-PSK: Invalid third message "
198 "length (%lu; expected %lu or more)",
200 (unsigned long) sizeof(*hdr3));
204 left = len - sizeof(*hdr3);
205 pchannel = (const u8 *) (hdr3 + 1);
206 wpa_printf(MSG_DEBUG, "EAP-PSK: Flags=0x%x", hdr3->flags);
207 if (EAP_PSK_FLAGS_GET_T(hdr3->flags) != 2) {
208 wpa_printf(MSG_INFO, "EAP-PSK: Unexpected T=%d (expected 2)",
209 EAP_PSK_FLAGS_GET_T(hdr3->flags));
210 ret->methodState = METHOD_DONE;
211 ret->decision = DECISION_FAIL;
214 wpa_hexdump(MSG_DEBUG, "EAP-PSK: RAND_S", hdr3->rand_s,
216 wpa_hexdump(MSG_DEBUG, "EAP-PSK: MAC_S", hdr3->mac_s, EAP_PSK_MAC_LEN);
217 wpa_hexdump(MSG_DEBUG, "EAP-PSK: PCHANNEL", pchannel, left);
219 if (left < 4 + 16 + 1) {
220 wpa_printf(MSG_INFO, "EAP-PSK: Too short PCHANNEL data in "
221 "third message (len=%lu, expected 21)",
222 (unsigned long) left);
227 /* MAC_S = OMAC1-AES-128(AK, ID_S||RAND_P) */
228 buflen = data->id_s_len + EAP_PSK_RAND_LEN;
229 buf = os_malloc(buflen);
232 os_memcpy(buf, data->id_s, data->id_s_len);
233 os_memcpy(buf + data->id_s_len, data->rand_p, EAP_PSK_RAND_LEN);
234 if (omac1_aes_128(data->ak, buf, buflen, mac)) {
239 if (os_memcmp_const(mac, hdr3->mac_s, EAP_PSK_MAC_LEN) != 0) {
240 wpa_printf(MSG_WARNING, "EAP-PSK: Invalid MAC_S in third "
242 ret->methodState = METHOD_DONE;
243 ret->decision = DECISION_FAIL;
246 wpa_printf(MSG_DEBUG, "EAP-PSK: MAC_S verified successfully");
248 if (eap_psk_derive_keys(data->kdk, data->rand_p, data->tek,
249 data->msk, data->emsk)) {
250 ret->methodState = METHOD_DONE;
251 ret->decision = DECISION_FAIL;
254 wpa_hexdump_key(MSG_DEBUG, "EAP-PSK: TEK", data->tek, EAP_PSK_TEK_LEN);
255 wpa_hexdump_key(MSG_DEBUG, "EAP-PSK: MSK", data->msk, EAP_MSK_LEN);
256 wpa_hexdump_key(MSG_DEBUG, "EAP-PSK: EMSK", data->emsk, EAP_EMSK_LEN);
258 os_memset(nonce, 0, 12);
259 os_memcpy(nonce + 12, pchannel, 4);
269 wpa_hexdump(MSG_MSGDUMP, "EAP-PSK: PCHANNEL - nonce",
270 nonce, sizeof(nonce));
271 wpa_hexdump(MSG_MSGDUMP, "EAP-PSK: PCHANNEL - hdr",
272 wpabuf_head(reqData), 5);
273 wpa_hexdump(MSG_MSGDUMP, "EAP-PSK: PCHANNEL - cipher msg", msg, left);
275 decrypted = os_memdup(msg, left);
276 if (decrypted == NULL) {
277 ret->methodState = METHOD_DONE;
278 ret->decision = DECISION_FAIL;
282 if (aes_128_eax_decrypt(data->tek, nonce, sizeof(nonce),
283 wpabuf_head(reqData),
284 sizeof(struct eap_hdr) + 1 +
285 sizeof(*hdr3) - EAP_PSK_MAC_LEN, decrypted,
287 wpa_printf(MSG_WARNING, "EAP-PSK: PCHANNEL decryption failed");
291 wpa_hexdump(MSG_DEBUG, "EAP-PSK: Decrypted PCHANNEL message",
295 switch (decrypted[0] >> 6) {
296 case EAP_PSK_R_FLAG_CONT:
297 wpa_printf(MSG_DEBUG, "EAP-PSK: R flag - CONT - unsupported");
300 case EAP_PSK_R_FLAG_DONE_SUCCESS:
301 wpa_printf(MSG_DEBUG, "EAP-PSK: R flag - DONE_SUCCESS");
303 case EAP_PSK_R_FLAG_DONE_FAILURE:
304 wpa_printf(MSG_DEBUG, "EAP-PSK: R flag - DONE_FAILURE");
305 wpa_printf(MSG_INFO, "EAP-PSK: Authentication server rejected "
312 if ((decrypted[0] & EAP_PSK_E_FLAG) && left > 1)
314 plen = sizeof(*hdr4) + 4 + 16 + data_len;
315 resp = eap_msg_alloc(EAP_VENDOR_IETF, EAP_TYPE_PSK, plen,
316 EAP_CODE_RESPONSE, eap_get_id(reqData));
321 hdr4 = wpabuf_put(resp, sizeof(*hdr4));
322 hdr4->flags = EAP_PSK_FLAGS_SET_T(3); /* T=3 */
323 os_memcpy(hdr4->rand_s, hdr3->rand_s, EAP_PSK_RAND_LEN);
324 rpchannel = wpabuf_put(resp, 4 + 16 + data_len);
327 inc_byte_array(nonce, sizeof(nonce));
328 os_memcpy(rpchannel, nonce + 12, 4);
330 if (decrypted[0] & EAP_PSK_E_FLAG) {
331 wpa_printf(MSG_DEBUG, "EAP-PSK: Unsupported E (Ext) flag");
333 rpchannel[4 + 16] = (EAP_PSK_R_FLAG_DONE_FAILURE << 6) |
336 /* Add empty EXT_Payload with same EXT_Type */
337 rpchannel[4 + 16 + 1] = decrypted[1];
340 rpchannel[4 + 16] = EAP_PSK_R_FLAG_DONE_FAILURE << 6;
342 rpchannel[4 + 16] = EAP_PSK_R_FLAG_DONE_SUCCESS << 6;
344 wpa_hexdump(MSG_DEBUG, "EAP-PSK: reply message (plaintext)",
345 rpchannel + 4 + 16, data_len);
346 if (aes_128_eax_encrypt(data->tek, nonce, sizeof(nonce),
348 sizeof(struct eap_hdr) + 1 + sizeof(*hdr4),
349 rpchannel + 4 + 16, data_len, rpchannel + 4)) {
354 wpa_hexdump(MSG_DEBUG, "EAP-PSK: reply message (PCHANNEL)",
355 rpchannel, 4 + 16 + data_len);
357 wpa_printf(MSG_DEBUG, "EAP-PSK: Completed %ssuccessfully",
359 data->state = PSK_DONE;
360 ret->methodState = METHOD_DONE;
361 ret->decision = failed ? DECISION_FAIL : DECISION_UNCOND_SUCC;
369 static struct wpabuf * eap_psk_process(struct eap_sm *sm, void *priv,
370 struct eap_method_ret *ret,
371 const struct wpabuf *reqData)
373 struct eap_psk_data *data = priv;
375 struct wpabuf *resp = NULL;
378 pos = eap_hdr_validate(EAP_VENDOR_IETF, EAP_TYPE_PSK, reqData, &len);
385 ret->methodState = METHOD_MAY_CONT;
386 ret->decision = DECISION_FAIL;
387 ret->allowNotifications = TRUE;
389 switch (data->state) {
391 resp = eap_psk_process_1(data, ret, reqData);
394 resp = eap_psk_process_3(data, ret, reqData);
397 wpa_printf(MSG_DEBUG, "EAP-PSK: in DONE state - ignore "
398 "unexpected message");
403 if (ret->methodState == METHOD_DONE) {
404 ret->allowNotifications = FALSE;
411 static Boolean eap_psk_isKeyAvailable(struct eap_sm *sm, void *priv)
413 struct eap_psk_data *data = priv;
414 return data->state == PSK_DONE;
418 static u8 * eap_psk_getKey(struct eap_sm *sm, void *priv, size_t *len)
420 struct eap_psk_data *data = priv;
423 if (data->state != PSK_DONE)
426 key = os_memdup(data->msk, EAP_MSK_LEN);
436 static u8 * eap_psk_get_session_id(struct eap_sm *sm, void *priv, size_t *len)
438 struct eap_psk_data *data = priv;
441 if (data->state != PSK_DONE)
444 *len = 1 + 2 * EAP_PSK_RAND_LEN;
445 id = os_malloc(*len);
449 id[0] = EAP_TYPE_PSK;
450 os_memcpy(id + 1, data->rand_p, EAP_PSK_RAND_LEN);
451 os_memcpy(id + 1 + EAP_PSK_RAND_LEN, data->rand_s, EAP_PSK_RAND_LEN);
452 wpa_hexdump(MSG_DEBUG, "EAP-PSK: Derived Session-Id", id, *len);
458 static u8 * eap_psk_get_emsk(struct eap_sm *sm, void *priv, size_t *len)
460 struct eap_psk_data *data = priv;
463 if (data->state != PSK_DONE)
466 key = os_memdup(data->emsk, EAP_EMSK_LEN);
476 int eap_peer_psk_register(void)
478 struct eap_method *eap;
480 eap = eap_peer_method_alloc(EAP_PEER_METHOD_INTERFACE_VERSION,
481 EAP_VENDOR_IETF, EAP_TYPE_PSK, "PSK");
485 eap->init = eap_psk_init;
486 eap->deinit = eap_psk_deinit;
487 eap->process = eap_psk_process;
488 eap->isKeyAvailable = eap_psk_isKeyAvailable;
489 eap->getKey = eap_psk_getKey;
490 eap->getSessionId = eap_psk_get_session_id;
491 eap->get_emsk = eap_psk_get_emsk;
493 return eap_peer_method_register(eap);