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 software may be distributed under the terms of the BSD license.
8  * See README for more details.
9  */
10 
11 #include "utils/includes.h"
12 
13 #include "utils/common.h"
14 #include "common/ieee802_11_defs.h"
15 #include "ieee802_11.h"
16 #include "wpa_auth.h"
17 #include "sta_info.h"
18 #include "ap_mlme.h"
19 #include "hostapd.h"
20 
21 
22 #ifndef CONFIG_NO_HOSTAPD_LOGGER
mlme_auth_alg_str(int alg)23 static const char * mlme_auth_alg_str(int alg)
24 {
25 	switch (alg) {
26 	case WLAN_AUTH_OPEN:
27 		return "OPEN_SYSTEM";
28 	case WLAN_AUTH_SHARED_KEY:
29 		return "SHARED_KEY";
30 	case WLAN_AUTH_FT:
31 		return "FT";
32 	}
33 
34 	return "unknown";
35 }
36 #endif /* CONFIG_NO_HOSTAPD_LOGGER */
37 
38 
39 /**
40  * mlme_authenticate_indication - Report the establishment of an authentication
41  * relationship with a specific peer MAC entity
42  * @hapd: BSS data
43  * @sta: peer STA data
44  *
45  * MLME calls this function as a result of the establishment of an
46  * authentication relationship with a specific peer MAC entity that
47  * resulted from an authentication procedure that was initiated by
48  * that specific peer MAC entity.
49  *
50  * PeerSTAAddress = sta->addr
51  * AuthenticationType = sta->auth_alg (WLAN_AUTH_OPEN / WLAN_AUTH_SHARED_KEY)
52  */
mlme_authenticate_indication(struct hostapd_data * hapd,struct sta_info * sta)53 void mlme_authenticate_indication(struct hostapd_data *hapd,
54 				  struct sta_info *sta)
55 {
56 	hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME,
57 		       HOSTAPD_LEVEL_DEBUG,
58 		       "MLME-AUTHENTICATE.indication(" MACSTR ", %s)",
59 		       MAC2STR(sta->addr), mlme_auth_alg_str(sta->auth_alg));
60 	if (sta->auth_alg != WLAN_AUTH_FT &&
61 	    sta->auth_alg != WLAN_AUTH_FILS_SK &&
62 	    sta->auth_alg != WLAN_AUTH_FILS_SK_PFS &&
63 	    sta->auth_alg != WLAN_AUTH_FILS_PK &&
64 	    !(sta->flags & WLAN_STA_MFP))
65 		mlme_deletekeys_request(hapd, sta);
66 	ap_sta_clear_disconnect_timeouts(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 	if (!hapd->iface->driver_ap_teardown)
90 		mlme_deletekeys_request(hapd, sta);
91 }
92 
93 
94 /**
95  * mlme_associate_indication - Report the establishment of an association with
96  * a specific peer MAC entity
97  * @hapd: BSS data
98  * @sta: peer STA data
99  *
100  * MLME calls this function as a result of the establishment of an
101  * association with a specific peer MAC entity that resulted from an
102  * association procedure that was initiated by that specific peer MAC entity.
103  *
104  * PeerSTAAddress = sta->addr
105  */
mlme_associate_indication(struct hostapd_data * hapd,struct sta_info * sta)106 void mlme_associate_indication(struct hostapd_data *hapd, struct sta_info *sta)
107 {
108 	hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME,
109 		       HOSTAPD_LEVEL_DEBUG,
110 		       "MLME-ASSOCIATE.indication(" MACSTR ")",
111 		       MAC2STR(sta->addr));
112 	if (sta->auth_alg != WLAN_AUTH_FT &&
113 	    sta->auth_alg != WLAN_AUTH_FILS_SK &&
114 	    sta->auth_alg != WLAN_AUTH_FILS_SK_PFS &&
115 	    sta->auth_alg != WLAN_AUTH_FILS_PK)
116 		mlme_deletekeys_request(hapd, sta);
117 	ap_sta_clear_disconnect_timeouts(hapd, sta);
118 }
119 
120 
121 /**
122  * mlme_reassociate_indication - Report the establishment of an reassociation
123  * with a specific peer MAC entity
124  * @hapd: BSS data
125  * @sta: peer STA data
126  *
127  * MLME calls this function as a result of the establishment of an
128  * reassociation with a specific peer MAC entity that resulted from a
129  * reassociation procedure that was initiated by that specific peer MAC entity.
130  *
131  * PeerSTAAddress = sta->addr
132  */
mlme_reassociate_indication(struct hostapd_data * hapd,struct sta_info * sta)133 void mlme_reassociate_indication(struct hostapd_data *hapd,
134 				 struct sta_info *sta)
135 {
136 	hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME,
137 		       HOSTAPD_LEVEL_DEBUG,
138 		       "MLME-REASSOCIATE.indication(" MACSTR ")",
139 		       MAC2STR(sta->addr));
140 	if (sta->auth_alg != WLAN_AUTH_FT &&
141 	    sta->auth_alg != WLAN_AUTH_FILS_SK &&
142 	    sta->auth_alg != WLAN_AUTH_FILS_SK_PFS &&
143 	    sta->auth_alg != WLAN_AUTH_FILS_PK)
144 		mlme_deletekeys_request(hapd, sta);
145 	ap_sta_clear_disconnect_timeouts(hapd, sta);
146 }
147 
148 
149 /**
150  * mlme_disassociate_indication - Report disassociation with a specific peer
151  * MAC entity
152  * @hapd: BSS data
153  * @sta: Peer STA data
154  * @reason_code: ReasonCode from Disassociation frame
155  *
156  * MLME calls this function as a result of the invalidation of an association
157  * relationship with a specific peer MAC entity.
158  *
159  * PeerSTAAddress = sta->addr
160  */
mlme_disassociate_indication(struct hostapd_data * hapd,struct sta_info * sta,u16 reason_code)161 void mlme_disassociate_indication(struct hostapd_data *hapd,
162 				  struct sta_info *sta, u16 reason_code)
163 {
164 	hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME,
165 		       HOSTAPD_LEVEL_DEBUG,
166 		       "MLME-DISASSOCIATE.indication(" MACSTR ", %d)",
167 		       MAC2STR(sta->addr), reason_code);
168 	mlme_deletekeys_request(hapd, sta);
169 }
170 
171 
mlme_michaelmicfailure_indication(struct hostapd_data * hapd,const u8 * addr)172 void mlme_michaelmicfailure_indication(struct hostapd_data *hapd,
173 				       const u8 *addr)
174 {
175 	hostapd_logger(hapd, addr, HOSTAPD_MODULE_MLME,
176 		       HOSTAPD_LEVEL_DEBUG,
177 		       "MLME-MichaelMICFailure.indication(" MACSTR ")",
178 		       MAC2STR(addr));
179 }
180 
181 
mlme_deletekeys_request(struct hostapd_data * hapd,struct sta_info * sta)182 void mlme_deletekeys_request(struct hostapd_data *hapd, struct sta_info *sta)
183 {
184 	hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME,
185 		       HOSTAPD_LEVEL_DEBUG,
186 		       "MLME-DELETEKEYS.request(" MACSTR ")",
187 		       MAC2STR(sta->addr));
188 
189 	if (sta->wpa_sm)
190 		wpa_remove_ptk(sta->wpa_sm);
191 }
192