1 /*
2 * hostapd / IEEE 802.11 MLME
3 * Copyright 2003-2006, Jouni Malinen <j@w1.fi>
4 * Copyright 2003-2004, Instant802 Networks, Inc.
5 * Copyright 2005-2006, Devicescape Software, Inc.
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License version 2 as
9 * published by the Free Software Foundation.
10 *
11 * Alternatively, this software may be distributed under the terms of BSD
12 * license.
13 *
14 * See README and COPYING for more details.
15 */
16
17 #include "utils/includes.h"
18
19 #include "utils/common.h"
20 #include "common/ieee802_11_defs.h"
21 #include "ieee802_11.h"
22 #include "wpa_auth.h"
23 #include "sta_info.h"
24 #include "ap_mlme.h"
25
26
27 #ifndef CONFIG_NO_HOSTAPD_LOGGER
mlme_auth_alg_str(int alg)28 static const char * mlme_auth_alg_str(int alg)
29 {
30 switch (alg) {
31 case WLAN_AUTH_OPEN:
32 return "OPEN_SYSTEM";
33 case WLAN_AUTH_SHARED_KEY:
34 return "SHARED_KEY";
35 case WLAN_AUTH_FT:
36 return "FT";
37 }
38
39 return "unknown";
40 }
41 #endif /* CONFIG_NO_HOSTAPD_LOGGER */
42
43
44 /**
45 * mlme_authenticate_indication - Report the establishment of an authentication
46 * relationship with a specific peer MAC entity
47 * @hapd: BSS data
48 * @sta: peer STA data
49 *
50 * MLME calls this function as a result of the establishment of an
51 * authentication relationship with a specific peer MAC entity that
52 * resulted from an authentication procedure that was initiated by
53 * that specific peer MAC entity.
54 *
55 * PeerSTAAddress = sta->addr
56 * AuthenticationType = sta->auth_alg (WLAN_AUTH_OPEN / WLAN_AUTH_SHARED_KEY)
57 */
mlme_authenticate_indication(struct hostapd_data * hapd,struct sta_info * sta)58 void mlme_authenticate_indication(struct hostapd_data *hapd,
59 struct sta_info *sta)
60 {
61 hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME,
62 HOSTAPD_LEVEL_DEBUG,
63 "MLME-AUTHENTICATE.indication(" MACSTR ", %s)",
64 MAC2STR(sta->addr), mlme_auth_alg_str(sta->auth_alg));
65 if (sta->auth_alg != WLAN_AUTH_FT && !(sta->flags & WLAN_STA_MFP))
66 mlme_deletekeys_request(hapd, sta);
67 }
68
69
70 /**
71 * mlme_deauthenticate_indication - Report the invalidation of an
72 * authentication relationship with a specific peer MAC entity
73 * @hapd: BSS data
74 * @sta: Peer STA data
75 * @reason_code: ReasonCode from Deauthentication frame
76 *
77 * MLME calls this function as a result of the invalidation of an
78 * authentication relationship with a specific peer MAC entity.
79 *
80 * PeerSTAAddress = sta->addr
81 */
mlme_deauthenticate_indication(struct hostapd_data * hapd,struct sta_info * sta,u16 reason_code)82 void mlme_deauthenticate_indication(struct hostapd_data *hapd,
83 struct sta_info *sta, u16 reason_code)
84 {
85 hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME,
86 HOSTAPD_LEVEL_DEBUG,
87 "MLME-DEAUTHENTICATE.indication(" MACSTR ", %d)",
88 MAC2STR(sta->addr), reason_code);
89 mlme_deletekeys_request(hapd, sta);
90 }
91
92
93 /**
94 * mlme_associate_indication - Report the establishment of an association with
95 * a specific peer MAC entity
96 * @hapd: BSS data
97 * @sta: peer STA data
98 *
99 * MLME calls this function as a result of the establishment of an
100 * association with a specific peer MAC entity that resulted from an
101 * association procedure that was initiated by that specific peer MAC entity.
102 *
103 * PeerSTAAddress = sta->addr
104 */
mlme_associate_indication(struct hostapd_data * hapd,struct sta_info * sta)105 void mlme_associate_indication(struct hostapd_data *hapd, struct sta_info *sta)
106 {
107 hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME,
108 HOSTAPD_LEVEL_DEBUG,
109 "MLME-ASSOCIATE.indication(" MACSTR ")",
110 MAC2STR(sta->addr));
111 if (sta->auth_alg != WLAN_AUTH_FT)
112 mlme_deletekeys_request(hapd, sta);
113 }
114
115
116 /**
117 * mlme_reassociate_indication - Report the establishment of an reassociation
118 * with a specific peer MAC entity
119 * @hapd: BSS data
120 * @sta: peer STA data
121 *
122 * MLME calls this function as a result of the establishment of an
123 * reassociation with a specific peer MAC entity that resulted from a
124 * reassociation procedure that was initiated by that specific peer MAC entity.
125 *
126 * PeerSTAAddress = sta->addr
127 *
128 * sta->previous_ap contains the "Current AP" information from ReassocReq.
129 */
mlme_reassociate_indication(struct hostapd_data * hapd,struct sta_info * sta)130 void mlme_reassociate_indication(struct hostapd_data *hapd,
131 struct sta_info *sta)
132 {
133 hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME,
134 HOSTAPD_LEVEL_DEBUG,
135 "MLME-REASSOCIATE.indication(" MACSTR ")",
136 MAC2STR(sta->addr));
137 if (sta->auth_alg != WLAN_AUTH_FT)
138 mlme_deletekeys_request(hapd, sta);
139 }
140
141
142 /**
143 * mlme_disassociate_indication - Report disassociation with a specific peer
144 * MAC entity
145 * @hapd: BSS data
146 * @sta: Peer STA data
147 * @reason_code: ReasonCode from Disassociation frame
148 *
149 * MLME calls this function as a result of the invalidation of an association
150 * relationship with a specific peer MAC entity.
151 *
152 * PeerSTAAddress = sta->addr
153 */
mlme_disassociate_indication(struct hostapd_data * hapd,struct sta_info * sta,u16 reason_code)154 void mlme_disassociate_indication(struct hostapd_data *hapd,
155 struct sta_info *sta, u16 reason_code)
156 {
157 hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME,
158 HOSTAPD_LEVEL_DEBUG,
159 "MLME-DISASSOCIATE.indication(" MACSTR ", %d)",
160 MAC2STR(sta->addr), reason_code);
161 mlme_deletekeys_request(hapd, sta);
162 }
163
164
mlme_michaelmicfailure_indication(struct hostapd_data * hapd,const u8 * addr)165 void mlme_michaelmicfailure_indication(struct hostapd_data *hapd,
166 const u8 *addr)
167 {
168 hostapd_logger(hapd, addr, HOSTAPD_MODULE_MLME,
169 HOSTAPD_LEVEL_DEBUG,
170 "MLME-MichaelMICFailure.indication(" MACSTR ")",
171 MAC2STR(addr));
172 }
173
174
mlme_deletekeys_request(struct hostapd_data * hapd,struct sta_info * sta)175 void mlme_deletekeys_request(struct hostapd_data *hapd, struct sta_info *sta)
176 {
177 hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME,
178 HOSTAPD_LEVEL_DEBUG,
179 "MLME-DELETEKEYS.request(" MACSTR ")",
180 MAC2STR(sta->addr));
181
182 if (sta->wpa_sm)
183 wpa_remove_ptk(sta->wpa_sm);
184 }
185