2 * WPA Supplicant - PeerKey for Direct Link Setup (DLS)
3 * Copyright (c) 2006-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.
15 #include "crypto/sha1.h"
16 #include "crypto/sha256.h"
17 #include "crypto/random.h"
18 #include "common/ieee802_11_defs.h"
25 static u8 * wpa_add_ie(u8 *pos, const u8 *ie, size_t ie_len)
27 os_memcpy(pos, ie, ie_len);
32 static u8 * wpa_add_kde(u8 *pos, u32 kde, const u8 *data, size_t data_len)
34 *pos++ = WLAN_EID_VENDOR_SPECIFIC;
35 *pos++ = RSN_SELECTOR_LEN + data_len;
36 RSN_SELECTOR_PUT(pos, kde);
37 pos += RSN_SELECTOR_LEN;
38 os_memcpy(pos, data, data_len);
44 static void wpa_supplicant_smk_timeout(void *eloop_ctx, void *timeout_ctx)
47 struct wpa_sm *sm = eloop_ctx;
48 struct wpa_peerkey *peerkey = timeout_ctx;
50 /* TODO: time out SMK and any STK that was generated using this SMK */
54 static void wpa_supplicant_peerkey_free(struct wpa_sm *sm,
55 struct wpa_peerkey *peerkey)
57 eloop_cancel_timeout(wpa_supplicant_smk_timeout, sm, peerkey);
62 static int wpa_supplicant_send_smk_error(struct wpa_sm *sm, const u8 *dst,
64 u16 mui, u16 error_type, int ver)
67 struct wpa_eapol_key *err;
68 struct rsn_error_kde error;
73 kde_len = 2 + RSN_SELECTOR_LEN + sizeof(error);
75 kde_len += 2 + RSN_SELECTOR_LEN + ETH_ALEN;
77 rbuf = wpa_sm_alloc_eapol(sm, IEEE802_1X_TYPE_EAPOL_KEY,
78 NULL, sizeof(*err) + kde_len, &rlen,
83 err->type = EAPOL_KEY_TYPE_RSN;
84 key_info = ver | WPA_KEY_INFO_SMK_MESSAGE | WPA_KEY_INFO_MIC |
85 WPA_KEY_INFO_SECURE | WPA_KEY_INFO_ERROR |
87 WPA_PUT_BE16(err->key_info, key_info);
88 WPA_PUT_BE16(err->key_length, 0);
89 os_memcpy(err->replay_counter, sm->request_counter,
90 WPA_REPLAY_COUNTER_LEN);
91 inc_byte_array(sm->request_counter, WPA_REPLAY_COUNTER_LEN);
93 WPA_PUT_BE16(err->key_data_length, (u16) kde_len);
94 pos = (u8 *) (err + 1);
97 /* Peer MAC Address KDE */
98 pos = wpa_add_kde(pos, RSN_KEY_DATA_MAC_ADDR, peer, ETH_ALEN);
102 error.mui = host_to_be16(mui);
103 error.error_type = host_to_be16(error_type);
104 wpa_add_kde(pos, RSN_KEY_DATA_ERROR, (u8 *) &error, sizeof(error));
107 wpa_printf(MSG_DEBUG, "RSN: Sending EAPOL-Key SMK Error (peer "
108 MACSTR " mui %d error_type %d)",
109 MAC2STR(peer), mui, error_type);
111 wpa_printf(MSG_DEBUG, "RSN: Sending EAPOL-Key SMK Error "
112 "(mui %d error_type %d)", mui, error_type);
115 wpa_eapol_key_send(sm, sm->ptk.kck, ver, dst, ETH_P_EAPOL,
116 rbuf, rlen, err->key_mic);
122 static int wpa_supplicant_send_smk_m3(struct wpa_sm *sm,
123 const unsigned char *src_addr,
124 const struct wpa_eapol_key *key,
125 int ver, struct wpa_peerkey *peerkey)
128 struct wpa_eapol_key *reply;
133 /* KDEs: Peer RSN IE, Initiator MAC Address, Initiator Nonce */
134 kde_len = peerkey->rsnie_p_len +
135 2 + RSN_SELECTOR_LEN + ETH_ALEN +
136 2 + RSN_SELECTOR_LEN + WPA_NONCE_LEN;
138 rbuf = wpa_sm_alloc_eapol(sm, IEEE802_1X_TYPE_EAPOL_KEY,
139 NULL, sizeof(*reply) + kde_len, &rlen,
144 reply->type = EAPOL_KEY_TYPE_RSN;
145 key_info = ver | WPA_KEY_INFO_SMK_MESSAGE | WPA_KEY_INFO_MIC |
147 WPA_PUT_BE16(reply->key_info, key_info);
148 WPA_PUT_BE16(reply->key_length, 0);
149 os_memcpy(reply->replay_counter, key->replay_counter,
150 WPA_REPLAY_COUNTER_LEN);
152 os_memcpy(reply->key_nonce, peerkey->pnonce, WPA_NONCE_LEN);
154 WPA_PUT_BE16(reply->key_data_length, (u16) kde_len);
155 pos = (u8 *) (reply + 1);
158 pos = wpa_add_ie(pos, peerkey->rsnie_p, peerkey->rsnie_p_len);
160 /* Initiator MAC Address KDE */
161 pos = wpa_add_kde(pos, RSN_KEY_DATA_MAC_ADDR, peerkey->addr, ETH_ALEN);
163 /* Initiator Nonce */
164 wpa_add_kde(pos, RSN_KEY_DATA_NONCE, peerkey->inonce, WPA_NONCE_LEN);
166 wpa_printf(MSG_DEBUG, "RSN: Sending EAPOL-Key SMK M3");
167 wpa_eapol_key_send(sm, sm->ptk.kck, ver, src_addr, ETH_P_EAPOL,
168 rbuf, rlen, reply->key_mic);
174 static int wpa_supplicant_process_smk_m2(
175 struct wpa_sm *sm, const unsigned char *src_addr,
176 const struct wpa_eapol_key *key, size_t extra_len, int ver)
178 struct wpa_peerkey *peerkey;
179 struct wpa_eapol_ie_parse kde;
180 struct wpa_ie_data ie;
182 struct rsn_ie_hdr *hdr;
185 wpa_printf(MSG_DEBUG, "RSN: Received SMK M2");
187 if (!sm->peerkey_enabled || sm->proto != WPA_PROTO_RSN) {
188 wpa_printf(MSG_INFO, "RSN: SMK handshake not allowed for "
189 "the current network");
193 if (wpa_supplicant_parse_ies((const u8 *) (key + 1), extra_len, &kde) <
195 wpa_printf(MSG_INFO, "RSN: Failed to parse KDEs in SMK M2");
199 if (kde.rsn_ie == NULL || kde.mac_addr == NULL ||
200 kde.mac_addr_len < ETH_ALEN) {
201 wpa_printf(MSG_INFO, "RSN: No RSN IE or MAC address KDE in "
206 wpa_printf(MSG_DEBUG, "RSN: SMK M2 - SMK initiator " MACSTR,
207 MAC2STR(kde.mac_addr));
209 if (kde.rsn_ie_len > PEERKEY_MAX_IE_LEN) {
210 wpa_printf(MSG_INFO, "RSN: Too long Initiator RSN IE in SMK "
215 if (wpa_parse_wpa_ie_rsn(kde.rsn_ie, kde.rsn_ie_len, &ie) < 0) {
216 wpa_printf(MSG_INFO, "RSN: Failed to parse RSN IE in SMK M2");
220 cipher = wpa_pick_pairwise_cipher(ie.pairwise_cipher &
221 sm->allowed_pairwise_cipher, 0);
223 wpa_printf(MSG_INFO, "RSN: No acceptable cipher in SMK M2");
224 wpa_supplicant_send_smk_error(sm, src_addr, kde.mac_addr,
225 STK_MUI_SMK, STK_ERR_CPHR_NS,
229 wpa_printf(MSG_DEBUG, "RSN: Using %s for PeerKey",
230 wpa_cipher_txt(cipher));
232 /* TODO: find existing entry and if found, use that instead of adding
233 * a new one; how to handle the case where both ends initiate at the
235 peerkey = os_zalloc(sizeof(*peerkey));
238 os_memcpy(peerkey->addr, kde.mac_addr, ETH_ALEN);
239 os_memcpy(peerkey->inonce, key->key_nonce, WPA_NONCE_LEN);
240 os_memcpy(peerkey->rsnie_i, kde.rsn_ie, kde.rsn_ie_len);
241 peerkey->rsnie_i_len = kde.rsn_ie_len;
242 peerkey->cipher = cipher;
243 #ifdef CONFIG_IEEE80211W
244 if (ie.key_mgmt & (WPA_KEY_MGMT_IEEE8021X_SHA256 |
245 WPA_KEY_MGMT_PSK_SHA256))
246 peerkey->use_sha256 = 1;
247 #endif /* CONFIG_IEEE80211W */
249 if (random_get_bytes(peerkey->pnonce, WPA_NONCE_LEN)) {
250 wpa_msg(sm->ctx->msg_ctx, MSG_WARNING,
251 "WPA: Failed to get random data for PNonce");
252 wpa_supplicant_peerkey_free(sm, peerkey);
256 hdr = (struct rsn_ie_hdr *) peerkey->rsnie_p;
257 hdr->elem_id = WLAN_EID_RSN;
258 WPA_PUT_LE16(hdr->version, RSN_VERSION);
259 pos = (u8 *) (hdr + 1);
260 /* Group Suite can be anything for SMK RSN IE; receiver will just
262 RSN_SELECTOR_PUT(pos, RSN_CIPHER_SUITE_CCMP);
263 pos += RSN_SELECTOR_LEN;
264 /* Include only the selected cipher in pairwise cipher suite */
265 WPA_PUT_LE16(pos, 1);
267 RSN_SELECTOR_PUT(pos, wpa_cipher_to_suite(WPA_PROTO_RSN, cipher));
268 pos += RSN_SELECTOR_LEN;
270 hdr->len = (pos - peerkey->rsnie_p) - 2;
271 peerkey->rsnie_p_len = pos - peerkey->rsnie_p;
272 wpa_hexdump(MSG_DEBUG, "WPA: RSN IE for SMK handshake",
273 peerkey->rsnie_p, peerkey->rsnie_p_len);
275 wpa_supplicant_send_smk_m3(sm, src_addr, key, ver, peerkey);
277 peerkey->next = sm->peerkey;
278 sm->peerkey = peerkey;
285 * rsn_smkid - Derive SMK identifier
286 * @smk: Station master key (32 bytes)
287 * @pnonce: Peer Nonce
288 * @mac_p: Peer MAC address
289 * @inonce: Initiator Nonce
290 * @mac_i: Initiator MAC address
291 * @use_sha256: Whether to use SHA256-based KDF
293 * 8.5.1.4 Station to station (STK) key hierarchy
294 * SMKID = HMAC-SHA1-128(SMK, "SMK Name" || PNonce || MAC_P || INonce || MAC_I)
296 static void rsn_smkid(const u8 *smk, const u8 *pnonce, const u8 *mac_p,
297 const u8 *inonce, const u8 *mac_i, u8 *smkid,
300 char *title = "SMK Name";
302 const size_t len[5] = { 8, WPA_NONCE_LEN, ETH_ALEN, WPA_NONCE_LEN,
304 unsigned char hash[SHA256_MAC_LEN];
306 addr[0] = (u8 *) title;
312 #ifdef CONFIG_IEEE80211W
314 hmac_sha256_vector(smk, PMK_LEN, 5, addr, len, hash);
316 #endif /* CONFIG_IEEE80211W */
317 hmac_sha1_vector(smk, PMK_LEN, 5, addr, len, hash);
318 os_memcpy(smkid, hash, PMKID_LEN);
322 static void wpa_supplicant_send_stk_1_of_4(struct wpa_sm *sm,
323 struct wpa_peerkey *peerkey)
326 struct wpa_eapol_key *msg;
331 kde_len = 2 + RSN_SELECTOR_LEN + PMKID_LEN;
333 mbuf = wpa_sm_alloc_eapol(sm, IEEE802_1X_TYPE_EAPOL_KEY, NULL,
334 sizeof(*msg) + kde_len, &mlen,
339 msg->type = EAPOL_KEY_TYPE_RSN;
341 if (peerkey->cipher != WPA_CIPHER_TKIP)
342 ver = WPA_KEY_INFO_TYPE_HMAC_SHA1_AES;
344 ver = WPA_KEY_INFO_TYPE_HMAC_MD5_RC4;
346 key_info = ver | WPA_KEY_INFO_KEY_TYPE | WPA_KEY_INFO_ACK;
347 WPA_PUT_BE16(msg->key_info, key_info);
349 if (peerkey->cipher != WPA_CIPHER_TKIP)
350 WPA_PUT_BE16(msg->key_length, 16);
352 WPA_PUT_BE16(msg->key_length, 32);
354 os_memcpy(msg->replay_counter, peerkey->replay_counter,
355 WPA_REPLAY_COUNTER_LEN);
356 inc_byte_array(peerkey->replay_counter, WPA_REPLAY_COUNTER_LEN);
358 WPA_PUT_BE16(msg->key_data_length, kde_len);
359 wpa_add_kde((u8 *) (msg + 1), RSN_KEY_DATA_PMKID,
360 peerkey->smkid, PMKID_LEN);
362 if (random_get_bytes(peerkey->inonce, WPA_NONCE_LEN)) {
363 wpa_msg(sm->ctx->msg_ctx, MSG_WARNING,
364 "RSN: Failed to get random data for INonce (STK)");
368 wpa_hexdump(MSG_DEBUG, "RSN: INonce for STK 4-Way Handshake",
369 peerkey->inonce, WPA_NONCE_LEN);
370 os_memcpy(msg->key_nonce, peerkey->inonce, WPA_NONCE_LEN);
372 wpa_printf(MSG_DEBUG, "RSN: Sending EAPOL-Key STK 1/4 to " MACSTR,
373 MAC2STR(peerkey->addr));
374 wpa_eapol_key_send(sm, NULL, ver, peerkey->addr, ETH_P_EAPOL,
379 static void wpa_supplicant_send_stk_3_of_4(struct wpa_sm *sm,
380 struct wpa_peerkey *peerkey)
383 struct wpa_eapol_key *msg;
389 kde_len = peerkey->rsnie_i_len +
390 2 + RSN_SELECTOR_LEN + sizeof(lifetime);
392 mbuf = wpa_sm_alloc_eapol(sm, IEEE802_1X_TYPE_EAPOL_KEY, NULL,
393 sizeof(*msg) + kde_len, &mlen,
398 msg->type = EAPOL_KEY_TYPE_RSN;
400 if (peerkey->cipher != WPA_CIPHER_TKIP)
401 ver = WPA_KEY_INFO_TYPE_HMAC_SHA1_AES;
403 ver = WPA_KEY_INFO_TYPE_HMAC_MD5_RC4;
405 key_info = ver | WPA_KEY_INFO_KEY_TYPE | WPA_KEY_INFO_ACK |
406 WPA_KEY_INFO_MIC | WPA_KEY_INFO_SECURE;
407 WPA_PUT_BE16(msg->key_info, key_info);
409 if (peerkey->cipher != WPA_CIPHER_TKIP)
410 WPA_PUT_BE16(msg->key_length, 16);
412 WPA_PUT_BE16(msg->key_length, 32);
414 os_memcpy(msg->replay_counter, peerkey->replay_counter,
415 WPA_REPLAY_COUNTER_LEN);
416 inc_byte_array(peerkey->replay_counter, WPA_REPLAY_COUNTER_LEN);
418 WPA_PUT_BE16(msg->key_data_length, kde_len);
419 pos = (u8 *) (msg + 1);
420 pos = wpa_add_ie(pos, peerkey->rsnie_i, peerkey->rsnie_i_len);
421 lifetime = host_to_be32(peerkey->lifetime);
422 wpa_add_kde(pos, RSN_KEY_DATA_LIFETIME,
423 (u8 *) &lifetime, sizeof(lifetime));
425 os_memcpy(msg->key_nonce, peerkey->inonce, WPA_NONCE_LEN);
427 wpa_printf(MSG_DEBUG, "RSN: Sending EAPOL-Key STK 3/4 to " MACSTR,
428 MAC2STR(peerkey->addr));
429 wpa_eapol_key_send(sm, peerkey->stk.kck, ver, peerkey->addr,
430 ETH_P_EAPOL, mbuf, mlen, msg->key_mic);
434 static int wpa_supplicant_process_smk_m4(struct wpa_peerkey *peerkey,
435 struct wpa_eapol_ie_parse *kde)
437 wpa_printf(MSG_DEBUG, "RSN: Received SMK M4 (Initiator " MACSTR ")",
438 MAC2STR(kde->mac_addr));
440 if (os_memcmp(kde->smk + PMK_LEN, peerkey->pnonce, WPA_NONCE_LEN) != 0)
442 wpa_printf(MSG_INFO, "RSN: PNonce in SMK KDE does not "
443 "match with the one used in SMK M3");
447 if (os_memcmp(kde->nonce, peerkey->inonce, WPA_NONCE_LEN) != 0) {
448 wpa_printf(MSG_INFO, "RSN: INonce in SMK M4 did not "
449 "match with the one received in SMK M2");
457 static int wpa_supplicant_process_smk_m5(struct wpa_sm *sm,
458 const unsigned char *src_addr,
459 const struct wpa_eapol_key *key,
461 struct wpa_peerkey *peerkey,
462 struct wpa_eapol_ie_parse *kde)
465 struct wpa_ie_data ie;
467 wpa_printf(MSG_DEBUG, "RSN: Received SMK M5 (Peer " MACSTR ")",
468 MAC2STR(kde->mac_addr));
469 if (kde->rsn_ie == NULL || kde->rsn_ie_len > PEERKEY_MAX_IE_LEN ||
470 wpa_parse_wpa_ie_rsn(kde->rsn_ie, kde->rsn_ie_len, &ie) < 0) {
471 wpa_printf(MSG_INFO, "RSN: No RSN IE in SMK M5");
472 /* TODO: abort negotiation */
476 if (os_memcmp(key->key_nonce, peerkey->inonce, WPA_NONCE_LEN) != 0) {
477 wpa_printf(MSG_INFO, "RSN: Key Nonce in SMK M5 does "
478 "not match with INonce used in SMK M1");
482 if (os_memcmp(kde->smk + PMK_LEN, peerkey->inonce, WPA_NONCE_LEN) != 0)
484 wpa_printf(MSG_INFO, "RSN: INonce in SMK KDE does not "
485 "match with the one used in SMK M1");
489 os_memcpy(peerkey->rsnie_p, kde->rsn_ie, kde->rsn_ie_len);
490 peerkey->rsnie_p_len = kde->rsn_ie_len;
491 os_memcpy(peerkey->pnonce, kde->nonce, WPA_NONCE_LEN);
493 cipher = wpa_pick_pairwise_cipher(ie.pairwise_cipher &
494 sm->allowed_pairwise_cipher, 0);
496 wpa_printf(MSG_INFO, "RSN: SMK Peer STA " MACSTR " selected "
497 "unacceptable cipher", MAC2STR(kde->mac_addr));
498 wpa_supplicant_send_smk_error(sm, src_addr, kde->mac_addr,
499 STK_MUI_SMK, STK_ERR_CPHR_NS,
501 /* TODO: abort negotiation */
504 wpa_printf(MSG_DEBUG, "RSN: Using %s for PeerKey",
505 wpa_cipher_txt(cipher));
506 peerkey->cipher = cipher;
512 static int wpa_supplicant_process_smk_m45(
513 struct wpa_sm *sm, const unsigned char *src_addr,
514 const struct wpa_eapol_key *key, size_t extra_len, int ver)
516 struct wpa_peerkey *peerkey;
517 struct wpa_eapol_ie_parse kde;
521 if (!sm->peerkey_enabled || sm->proto != WPA_PROTO_RSN) {
522 wpa_printf(MSG_DEBUG, "RSN: SMK handshake not allowed for "
523 "the current network");
527 if (wpa_supplicant_parse_ies((const u8 *) (key + 1), extra_len, &kde) <
529 wpa_printf(MSG_INFO, "RSN: Failed to parse KDEs in SMK M4/M5");
533 if (kde.mac_addr == NULL || kde.mac_addr_len < ETH_ALEN ||
534 kde.nonce == NULL || kde.nonce_len < WPA_NONCE_LEN ||
535 kde.smk == NULL || kde.smk_len < PMK_LEN + WPA_NONCE_LEN ||
536 kde.lifetime == NULL || kde.lifetime_len < 4) {
537 wpa_printf(MSG_INFO, "RSN: No MAC Address, Nonce, SMK, or "
538 "Lifetime KDE in SMK M4/M5");
542 for (peerkey = sm->peerkey; peerkey; peerkey = peerkey->next) {
543 if (os_memcmp(peerkey->addr, kde.mac_addr, ETH_ALEN) == 0 &&
544 os_memcmp(peerkey->initiator ? peerkey->inonce :
546 key->key_nonce, WPA_NONCE_LEN) == 0)
549 if (peerkey == NULL) {
550 wpa_printf(MSG_INFO, "RSN: No matching SMK handshake found "
551 "for SMK M4/M5: peer " MACSTR,
552 MAC2STR(kde.mac_addr));
556 if (peerkey->initiator) {
557 if (wpa_supplicant_process_smk_m5(sm, src_addr, key, ver,
561 if (wpa_supplicant_process_smk_m4(peerkey, &kde) < 0)
565 os_memcpy(peerkey->smk, kde.smk, PMK_LEN);
566 peerkey->smk_complete = 1;
567 wpa_hexdump_key(MSG_DEBUG, "RSN: SMK", peerkey->smk, PMK_LEN);
568 lifetime = WPA_GET_BE32(kde.lifetime);
569 wpa_printf(MSG_DEBUG, "RSN: SMK lifetime %u seconds", lifetime);
570 if (lifetime > 1000000000)
571 lifetime = 1000000000; /* avoid overflowing expiration time */
572 peerkey->lifetime = lifetime;
574 peerkey->expiration = now.sec + lifetime;
575 eloop_register_timeout(lifetime, 0, wpa_supplicant_smk_timeout,
578 if (peerkey->initiator) {
579 rsn_smkid(peerkey->smk, peerkey->pnonce, peerkey->addr,
580 peerkey->inonce, sm->own_addr, peerkey->smkid,
581 peerkey->use_sha256);
582 wpa_supplicant_send_stk_1_of_4(sm, peerkey);
584 rsn_smkid(peerkey->smk, peerkey->pnonce, sm->own_addr,
585 peerkey->inonce, peerkey->addr, peerkey->smkid,
586 peerkey->use_sha256);
588 wpa_hexdump(MSG_DEBUG, "RSN: SMKID", peerkey->smkid, PMKID_LEN);
594 static int wpa_supplicant_process_smk_error(
595 struct wpa_sm *sm, const unsigned char *src_addr,
596 const struct wpa_eapol_key *key, size_t extra_len)
598 struct wpa_eapol_ie_parse kde;
599 struct rsn_error_kde error;
603 wpa_printf(MSG_DEBUG, "RSN: Received SMK Error");
605 if (!sm->peerkey_enabled || sm->proto != WPA_PROTO_RSN) {
606 wpa_printf(MSG_DEBUG, "RSN: SMK handshake not allowed for "
607 "the current network");
611 if (wpa_supplicant_parse_ies((const u8 *) (key + 1), extra_len, &kde) <
613 wpa_printf(MSG_INFO, "RSN: Failed to parse KDEs in SMK Error");
617 if (kde.error == NULL || kde.error_len < sizeof(error)) {
618 wpa_printf(MSG_INFO, "RSN: No Error KDE in SMK Error");
622 if (kde.mac_addr && kde.mac_addr_len >= ETH_ALEN)
623 os_memcpy(peer, kde.mac_addr, ETH_ALEN);
625 os_memset(peer, 0, ETH_ALEN);
626 os_memcpy(&error, kde.error, sizeof(error));
627 error_type = be_to_host16(error.error_type);
628 wpa_msg(sm->ctx->msg_ctx, MSG_INFO,
629 "RSN: SMK Error KDE received: MUI %d error_type %d peer "
631 be_to_host16(error.mui), error_type,
635 (error_type == STK_ERR_STA_NR || error_type == STK_ERR_STA_NRSN ||
636 error_type == STK_ERR_CPHR_NS)) {
637 struct wpa_peerkey *peerkey;
639 for (peerkey = sm->peerkey; peerkey; peerkey = peerkey->next) {
640 if (os_memcmp(peerkey->addr, kde.mac_addr, ETH_ALEN) ==
644 if (peerkey == NULL) {
645 wpa_printf(MSG_DEBUG, "RSN: No matching SMK handshake "
646 "found for SMK Error");
649 /* TODO: abort SMK/STK handshake and remove all related keys */
656 static void wpa_supplicant_process_stk_1_of_4(struct wpa_sm *sm,
657 struct wpa_peerkey *peerkey,
658 const struct wpa_eapol_key *key,
661 struct wpa_eapol_ie_parse ie;
663 size_t len, kde_buf_len;
665 u8 buf[8], *kde_buf, *pos;
668 wpa_printf(MSG_DEBUG, "RSN: RX message 1 of STK 4-Way Handshake from "
669 MACSTR " (ver=%d)", MAC2STR(peerkey->addr), ver);
671 os_memset(&ie, 0, sizeof(ie));
673 /* RSN: msg 1/4 should contain SMKID for the selected SMK */
674 kde = (const u8 *) (key + 1);
675 len = WPA_GET_BE16(key->key_data_length);
676 wpa_hexdump(MSG_DEBUG, "RSN: msg 1/4 key data", kde, len);
677 if (wpa_supplicant_parse_ies(kde, len, &ie) < 0 || ie.pmkid == NULL) {
678 wpa_printf(MSG_DEBUG, "RSN: No SMKID in STK 1/4");
681 if (os_memcmp(ie.pmkid, peerkey->smkid, PMKID_LEN) != 0) {
682 wpa_hexdump(MSG_DEBUG, "RSN: Unknown SMKID in STK 1/4",
683 ie.pmkid, PMKID_LEN);
687 if (random_get_bytes(peerkey->pnonce, WPA_NONCE_LEN)) {
688 wpa_msg(sm->ctx->msg_ctx, MSG_WARNING,
689 "RSN: Failed to get random data for PNonce");
692 wpa_hexdump(MSG_DEBUG, "WPA: Renewed PNonce",
693 peerkey->pnonce, WPA_NONCE_LEN);
695 /* Calculate STK which will be stored as a temporary STK until it has
696 * been verified when processing message 3/4. */
697 stk = &peerkey->tstk;
698 wpa_pmk_to_ptk(peerkey->smk, PMK_LEN, "Peer key expansion",
699 sm->own_addr, peerkey->addr,
700 peerkey->pnonce, key->key_nonce,
701 (u8 *) stk, sizeof(*stk),
702 peerkey->use_sha256);
703 /* Supplicant: swap tx/rx Mic keys */
704 os_memcpy(buf, stk->u.auth.tx_mic_key, 8);
705 os_memcpy(stk->u.auth.tx_mic_key, stk->u.auth.rx_mic_key, 8);
706 os_memcpy(stk->u.auth.rx_mic_key, buf, 8);
707 peerkey->tstk_set = 1;
709 kde_buf_len = peerkey->rsnie_p_len +
710 2 + RSN_SELECTOR_LEN + sizeof(lifetime) +
711 2 + RSN_SELECTOR_LEN + PMKID_LEN;
712 kde_buf = os_malloc(kde_buf_len);
716 pos = wpa_add_ie(pos, peerkey->rsnie_p, peerkey->rsnie_p_len);
717 lifetime = host_to_be32(peerkey->lifetime);
718 pos = wpa_add_kde(pos, RSN_KEY_DATA_LIFETIME,
719 (u8 *) &lifetime, sizeof(lifetime));
720 wpa_add_kde(pos, RSN_KEY_DATA_PMKID, peerkey->smkid, PMKID_LEN);
722 if (wpa_supplicant_send_2_of_4(sm, peerkey->addr, key, ver,
723 peerkey->pnonce, kde_buf, kde_buf_len,
730 os_memcpy(peerkey->inonce, key->key_nonce, WPA_NONCE_LEN);
734 static void wpa_supplicant_update_smk_lifetime(struct wpa_sm *sm,
735 struct wpa_peerkey *peerkey,
736 struct wpa_eapol_ie_parse *kde)
741 if (kde->lifetime == NULL || kde->lifetime_len < sizeof(lifetime))
744 lifetime = WPA_GET_BE32(kde->lifetime);
746 if (lifetime >= peerkey->lifetime) {
747 wpa_printf(MSG_DEBUG, "RSN: Peer used SMK lifetime %u seconds "
748 "which is larger than or equal to own value %u "
749 "seconds - ignored", lifetime, peerkey->lifetime);
753 wpa_printf(MSG_DEBUG, "RSN: Peer used shorter SMK lifetime %u seconds "
754 "(own was %u seconds) - updated",
755 lifetime, peerkey->lifetime);
756 peerkey->lifetime = lifetime;
759 peerkey->expiration = now.sec + lifetime;
760 eloop_cancel_timeout(wpa_supplicant_smk_timeout, sm, peerkey);
761 eloop_register_timeout(lifetime, 0, wpa_supplicant_smk_timeout,
766 static void wpa_supplicant_process_stk_2_of_4(struct wpa_sm *sm,
767 struct wpa_peerkey *peerkey,
768 const struct wpa_eapol_key *key,
771 struct wpa_eapol_ie_parse kde;
775 wpa_printf(MSG_DEBUG, "RSN: RX message 2 of STK 4-Way Handshake from "
776 MACSTR " (ver=%d)", MAC2STR(peerkey->addr), ver);
778 os_memset(&kde, 0, sizeof(kde));
780 /* RSN: msg 2/4 should contain SMKID for the selected SMK and RSN IE
781 * from the peer. It may also include Lifetime KDE. */
782 keydata = (const u8 *) (key + 1);
783 len = WPA_GET_BE16(key->key_data_length);
784 wpa_hexdump(MSG_DEBUG, "RSN: msg 2/4 key data", keydata, len);
785 if (wpa_supplicant_parse_ies(keydata, len, &kde) < 0 ||
786 kde.pmkid == NULL || kde.rsn_ie == NULL) {
787 wpa_printf(MSG_DEBUG, "RSN: No SMKID or RSN IE in STK 2/4");
791 if (os_memcmp(kde.pmkid, peerkey->smkid, PMKID_LEN) != 0) {
792 wpa_hexdump(MSG_DEBUG, "RSN: Unknown SMKID in STK 2/4",
793 kde.pmkid, PMKID_LEN);
797 if (kde.rsn_ie_len != peerkey->rsnie_p_len ||
798 os_memcmp(kde.rsn_ie, peerkey->rsnie_p, kde.rsn_ie_len) != 0) {
799 wpa_printf(MSG_INFO, "RSN: Peer RSN IE in SMK and STK "
800 "handshakes did not match");
801 wpa_hexdump(MSG_DEBUG, "RSN: Peer RSN IE in SMK handshake",
802 peerkey->rsnie_p, peerkey->rsnie_p_len);
803 wpa_hexdump(MSG_DEBUG, "RSN: Peer RSN IE in STK handshake",
804 kde.rsn_ie, kde.rsn_ie_len);
808 wpa_supplicant_update_smk_lifetime(sm, peerkey, &kde);
810 wpa_supplicant_send_stk_3_of_4(sm, peerkey);
811 os_memcpy(peerkey->pnonce, key->key_nonce, WPA_NONCE_LEN);
815 static void wpa_supplicant_process_stk_3_of_4(struct wpa_sm *sm,
816 struct wpa_peerkey *peerkey,
817 const struct wpa_eapol_key *key,
820 struct wpa_eapol_ie_parse kde;
824 u8 key_buf[32], rsc[6];
826 wpa_printf(MSG_DEBUG, "RSN: RX message 3 of STK 4-Way Handshake from "
827 MACSTR " (ver=%d)", MAC2STR(peerkey->addr), ver);
829 os_memset(&kde, 0, sizeof(kde));
831 /* RSN: msg 3/4 should contain Initiator RSN IE. It may also include
833 keydata = (const u8 *) (key + 1);
834 len = WPA_GET_BE16(key->key_data_length);
835 wpa_hexdump(MSG_DEBUG, "RSN: msg 3/4 key data", keydata, len);
836 if (wpa_supplicant_parse_ies(keydata, len, &kde) < 0) {
837 wpa_printf(MSG_DEBUG, "RSN: Failed to parse key data in "
842 if (kde.rsn_ie_len != peerkey->rsnie_i_len ||
843 os_memcmp(kde.rsn_ie, peerkey->rsnie_i, kde.rsn_ie_len) != 0) {
844 wpa_printf(MSG_INFO, "RSN: Initiator RSN IE in SMK and STK "
845 "handshakes did not match");
846 wpa_hexdump(MSG_DEBUG, "RSN: Initiator RSN IE in SMK "
848 peerkey->rsnie_i, peerkey->rsnie_i_len);
849 wpa_hexdump(MSG_DEBUG, "RSN: Initiator RSN IE in STK "
851 kde.rsn_ie, kde.rsn_ie_len);
855 if (os_memcmp(peerkey->inonce, key->key_nonce, WPA_NONCE_LEN) != 0) {
856 wpa_printf(MSG_WARNING, "RSN: INonce from message 1 of STK "
857 "4-Way Handshake differs from 3 of STK 4-Way "
858 "Handshake - drop packet (src=" MACSTR ")",
859 MAC2STR(peerkey->addr));
863 wpa_supplicant_update_smk_lifetime(sm, peerkey, &kde);
865 if (wpa_supplicant_send_4_of_4(sm, peerkey->addr, key, ver,
866 WPA_GET_BE16(key->key_info),
867 NULL, 0, &peerkey->stk))
870 _key = (u8 *) peerkey->stk.tk1;
871 if (peerkey->cipher == WPA_CIPHER_TKIP) {
872 /* Swap Tx/Rx keys for Michael MIC */
873 os_memcpy(key_buf, _key, 16);
874 os_memcpy(key_buf + 16, peerkey->stk.u.auth.rx_mic_key, 8);
875 os_memcpy(key_buf + 24, peerkey->stk.u.auth.tx_mic_key, 8);
881 os_memset(rsc, 0, 6);
882 if (wpa_sm_set_key(sm, peerkey->cipher, peerkey->addr, 0, 1,
883 rsc, sizeof(rsc), _key, key_len) < 0) {
884 wpa_printf(MSG_WARNING, "RSN: Failed to set STK to the "
891 static void wpa_supplicant_process_stk_4_of_4(struct wpa_sm *sm,
892 struct wpa_peerkey *peerkey,
893 const struct wpa_eapol_key *key,
898 wpa_printf(MSG_DEBUG, "RSN: RX message 4 of STK 4-Way Handshake from "
899 MACSTR " (ver=%d)", MAC2STR(peerkey->addr), ver);
901 os_memset(rsc, 0, 6);
902 if (wpa_sm_set_key(sm, peerkey->cipher, peerkey->addr, 0, 1,
903 rsc, sizeof(rsc), (u8 *) peerkey->stk.tk1,
904 peerkey->cipher == WPA_CIPHER_TKIP ? 32 : 16) < 0) {
905 wpa_printf(MSG_WARNING, "RSN: Failed to set STK to the "
913 * peerkey_verify_eapol_key_mic - Verify PeerKey MIC
914 * @sm: Pointer to WPA state machine data from wpa_sm_init()
915 * @peerkey: Pointer to the PeerKey data for the peer
916 * @key: Pointer to the EAPOL-Key frame header
917 * @ver: Version bits from EAPOL-Key Key Info
918 * @buf: Pointer to the beginning of EAPOL-Key frame
919 * @len: Length of the EAPOL-Key frame
920 * Returns: 0 on success, -1 on failure
922 int peerkey_verify_eapol_key_mic(struct wpa_sm *sm,
923 struct wpa_peerkey *peerkey,
924 struct wpa_eapol_key *key, u16 ver,
925 const u8 *buf, size_t len)
930 if (peerkey->initiator && !peerkey->stk_set) {
931 wpa_pmk_to_ptk(peerkey->smk, PMK_LEN, "Peer key expansion",
932 sm->own_addr, peerkey->addr,
933 peerkey->inonce, key->key_nonce,
934 (u8 *) &peerkey->stk, sizeof(peerkey->stk),
935 peerkey->use_sha256);
936 peerkey->stk_set = 1;
939 os_memcpy(mic, key->key_mic, 16);
940 if (peerkey->tstk_set) {
941 os_memset(key->key_mic, 0, 16);
942 wpa_eapol_key_mic(peerkey->tstk.kck, ver, buf, len,
944 if (os_memcmp(mic, key->key_mic, 16) != 0) {
945 wpa_printf(MSG_WARNING, "RSN: Invalid EAPOL-Key MIC "
946 "when using TSTK - ignoring TSTK");
949 peerkey->tstk_set = 0;
950 peerkey->stk_set = 1;
951 os_memcpy(&peerkey->stk, &peerkey->tstk,
952 sizeof(peerkey->stk));
956 if (!ok && peerkey->stk_set) {
957 os_memset(key->key_mic, 0, 16);
958 wpa_eapol_key_mic(peerkey->stk.kck, ver, buf, len,
960 if (os_memcmp(mic, key->key_mic, 16) != 0) {
961 wpa_printf(MSG_WARNING, "RSN: Invalid EAPOL-Key MIC "
962 "- dropping packet");
969 wpa_printf(MSG_WARNING, "RSN: Could not verify EAPOL-Key MIC "
970 "- dropping packet");
974 os_memcpy(peerkey->replay_counter, key->replay_counter,
975 WPA_REPLAY_COUNTER_LEN);
976 peerkey->replay_counter_set = 1;
982 * wpa_sm_stkstart - Send EAPOL-Key Request for STK handshake (STK M1)
983 * @sm: Pointer to WPA state machine data from wpa_sm_init()
984 * @peer: MAC address of the peer STA
985 * Returns: 0 on success, or -1 on failure
987 * Send an EAPOL-Key Request to the current authenticator to start STK
988 * handshake with the peer.
990 int wpa_sm_stkstart(struct wpa_sm *sm, const u8 *peer)
992 size_t rlen, kde_len;
993 struct wpa_eapol_key *req;
995 u8 bssid[ETH_ALEN], *rbuf, *pos, *count_pos;
997 struct rsn_ie_hdr *hdr;
998 struct wpa_peerkey *peerkey;
999 struct wpa_ie_data ie;
1001 if (sm->proto != WPA_PROTO_RSN || !sm->ptk_set || !sm->peerkey_enabled)
1004 if (sm->ap_rsn_ie &&
1005 wpa_parse_wpa_ie_rsn(sm->ap_rsn_ie, sm->ap_rsn_ie_len, &ie) == 0 &&
1006 !(ie.capabilities & WPA_CAPABILITY_PEERKEY_ENABLED)) {
1007 wpa_printf(MSG_DEBUG, "RSN: Current AP does not support STK");
1011 if (sm->pairwise_cipher != WPA_CIPHER_TKIP)
1012 ver = WPA_KEY_INFO_TYPE_HMAC_SHA1_AES;
1014 ver = WPA_KEY_INFO_TYPE_HMAC_MD5_RC4;
1016 if (wpa_sm_get_bssid(sm, bssid) < 0) {
1017 wpa_printf(MSG_WARNING, "Failed to read BSSID for EAPOL-Key "
1022 /* TODO: find existing entry and if found, use that instead of adding
1024 peerkey = os_zalloc(sizeof(*peerkey));
1025 if (peerkey == NULL)
1027 peerkey->initiator = 1;
1028 os_memcpy(peerkey->addr, peer, ETH_ALEN);
1029 #ifdef CONFIG_IEEE80211W
1030 if (wpa_key_mgmt_sha256(sm->key_mgmt))
1031 peerkey->use_sha256 = 1;
1032 #endif /* CONFIG_IEEE80211W */
1035 * EAPOL-Key(S=1, M=1, A=0, I=0, K=0, SM=1, KeyRSC=0, Nonce=INonce,
1036 * MIC=MIC, DataKDs=(RSNIE_I, MAC_P KDE))
1039 hdr = (struct rsn_ie_hdr *) peerkey->rsnie_i;
1040 hdr->elem_id = WLAN_EID_RSN;
1041 WPA_PUT_LE16(hdr->version, RSN_VERSION);
1042 pos = (u8 *) (hdr + 1);
1043 /* Group Suite can be anything for SMK RSN IE; receiver will just
1045 RSN_SELECTOR_PUT(pos, RSN_CIPHER_SUITE_CCMP);
1046 pos += RSN_SELECTOR_LEN;
1050 count = rsn_cipher_put_suites(pos, sm->allowed_pairwise_cipher);
1051 pos += count * RSN_SELECTOR_LEN;
1052 WPA_PUT_LE16(count_pos, count);
1054 hdr->len = (pos - peerkey->rsnie_i) - 2;
1055 peerkey->rsnie_i_len = pos - peerkey->rsnie_i;
1056 wpa_hexdump(MSG_DEBUG, "WPA: RSN IE for SMK handshake",
1057 peerkey->rsnie_i, peerkey->rsnie_i_len);
1059 kde_len = peerkey->rsnie_i_len + 2 + RSN_SELECTOR_LEN + ETH_ALEN;
1061 rbuf = wpa_sm_alloc_eapol(sm, IEEE802_1X_TYPE_EAPOL_KEY, NULL,
1062 sizeof(*req) + kde_len, &rlen,
1065 wpa_supplicant_peerkey_free(sm, peerkey);
1069 req->type = EAPOL_KEY_TYPE_RSN;
1070 key_info = WPA_KEY_INFO_SMK_MESSAGE | WPA_KEY_INFO_MIC |
1071 WPA_KEY_INFO_SECURE | WPA_KEY_INFO_REQUEST | ver;
1072 WPA_PUT_BE16(req->key_info, key_info);
1073 WPA_PUT_BE16(req->key_length, 0);
1074 os_memcpy(req->replay_counter, sm->request_counter,
1075 WPA_REPLAY_COUNTER_LEN);
1076 inc_byte_array(sm->request_counter, WPA_REPLAY_COUNTER_LEN);
1078 if (random_get_bytes(peerkey->inonce, WPA_NONCE_LEN)) {
1079 wpa_msg(sm->ctx->msg_ctx, MSG_WARNING,
1080 "WPA: Failed to get random data for INonce");
1082 wpa_supplicant_peerkey_free(sm, peerkey);
1085 os_memcpy(req->key_nonce, peerkey->inonce, WPA_NONCE_LEN);
1086 wpa_hexdump(MSG_DEBUG, "WPA: INonce for SMK handshake",
1087 req->key_nonce, WPA_NONCE_LEN);
1089 WPA_PUT_BE16(req->key_data_length, (u16) kde_len);
1090 pos = (u8 *) (req + 1);
1092 /* Initiator RSN IE */
1093 pos = wpa_add_ie(pos, peerkey->rsnie_i, peerkey->rsnie_i_len);
1094 /* Peer MAC address KDE */
1095 wpa_add_kde(pos, RSN_KEY_DATA_MAC_ADDR, peer, ETH_ALEN);
1097 wpa_printf(MSG_INFO, "RSN: Sending EAPOL-Key SMK M1 Request (peer "
1098 MACSTR ")", MAC2STR(peer));
1099 wpa_eapol_key_send(sm, sm->ptk.kck, ver, bssid, ETH_P_EAPOL,
1100 rbuf, rlen, req->key_mic);
1102 peerkey->next = sm->peerkey;
1103 sm->peerkey = peerkey;
1110 * peerkey_deinit - Free PeerKey values
1111 * @sm: Pointer to WPA state machine data from wpa_sm_init()
1113 void peerkey_deinit(struct wpa_sm *sm)
1115 struct wpa_peerkey *prev, *peerkey = sm->peerkey;
1118 peerkey = peerkey->next;
1125 void peerkey_rx_eapol_4way(struct wpa_sm *sm, struct wpa_peerkey *peerkey,
1126 struct wpa_eapol_key *key, u16 key_info, u16 ver)
1128 if ((key_info & (WPA_KEY_INFO_MIC | WPA_KEY_INFO_ACK)) ==
1129 (WPA_KEY_INFO_MIC | WPA_KEY_INFO_ACK)) {
1130 /* 3/4 STK 4-Way Handshake */
1131 wpa_supplicant_process_stk_3_of_4(sm, peerkey, key, ver);
1132 } else if (key_info & WPA_KEY_INFO_ACK) {
1133 /* 1/4 STK 4-Way Handshake */
1134 wpa_supplicant_process_stk_1_of_4(sm, peerkey, key, ver);
1135 } else if (key_info & WPA_KEY_INFO_SECURE) {
1136 /* 4/4 STK 4-Way Handshake */
1137 wpa_supplicant_process_stk_4_of_4(sm, peerkey, key, ver);
1139 /* 2/4 STK 4-Way Handshake */
1140 wpa_supplicant_process_stk_2_of_4(sm, peerkey, key, ver);
1145 void peerkey_rx_eapol_smk(struct wpa_sm *sm, const u8 *src_addr,
1146 struct wpa_eapol_key *key, size_t extra_len,
1147 u16 key_info, u16 ver)
1149 if (key_info & WPA_KEY_INFO_ERROR) {
1151 wpa_supplicant_process_smk_error(sm, src_addr, key, extra_len);
1152 } else if (key_info & WPA_KEY_INFO_ACK) {
1154 wpa_supplicant_process_smk_m2(sm, src_addr, key, extra_len,
1158 wpa_supplicant_process_smk_m45(sm, src_addr, key, extra_len,
1163 #endif /* CONFIG_PEERKEY */