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 20 21 #ifndef CONFIG_NO_HOSTAPD_LOGGER 22 static const char * mlme_auth_alg_str(int alg) 23 { 24 switch (alg) { 25 case WLAN_AUTH_OPEN: 26 return "OPEN_SYSTEM"; 27 case WLAN_AUTH_SHARED_KEY: 28 return "SHARED_KEY"; 29 case WLAN_AUTH_FT: 30 return "FT"; 31 } 32 33 return "unknown"; 34 } 35 #endif /* CONFIG_NO_HOSTAPD_LOGGER */ 36 37 38 /** 39 * mlme_authenticate_indication - Report the establishment of an authentication 40 * relationship with a specific peer MAC entity 41 * @hapd: BSS data 42 * @sta: peer STA data 43 * 44 * MLME calls this function as a result of the establishment of an 45 * authentication relationship with a specific peer MAC entity that 46 * resulted from an authentication procedure that was initiated by 47 * that specific peer MAC entity. 48 * 49 * PeerSTAAddress = sta->addr 50 * AuthenticationType = sta->auth_alg (WLAN_AUTH_OPEN / WLAN_AUTH_SHARED_KEY) 51 */ 52 void mlme_authenticate_indication(struct hostapd_data *hapd, 53 struct sta_info *sta) 54 { 55 hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME, 56 HOSTAPD_LEVEL_DEBUG, 57 "MLME-AUTHENTICATE.indication(" MACSTR ", %s)", 58 MAC2STR(sta->addr), mlme_auth_alg_str(sta->auth_alg)); 59 if (sta->auth_alg != WLAN_AUTH_FT && !(sta->flags & WLAN_STA_MFP)) 60 mlme_deletekeys_request(hapd, sta); 61 } 62 63 64 /** 65 * mlme_deauthenticate_indication - Report the invalidation of an 66 * authentication relationship with a specific peer MAC entity 67 * @hapd: BSS data 68 * @sta: Peer STA data 69 * @reason_code: ReasonCode from Deauthentication frame 70 * 71 * MLME calls this function as a result of the invalidation of an 72 * authentication relationship with a specific peer MAC entity. 73 * 74 * PeerSTAAddress = sta->addr 75 */ 76 void mlme_deauthenticate_indication(struct hostapd_data *hapd, 77 struct sta_info *sta, u16 reason_code) 78 { 79 hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME, 80 HOSTAPD_LEVEL_DEBUG, 81 "MLME-DEAUTHENTICATE.indication(" MACSTR ", %d)", 82 MAC2STR(sta->addr), reason_code); 83 mlme_deletekeys_request(hapd, sta); 84 } 85 86 87 /** 88 * mlme_associate_indication - Report the establishment of an association with 89 * a specific peer MAC entity 90 * @hapd: BSS data 91 * @sta: peer STA data 92 * 93 * MLME calls this function as a result of the establishment of an 94 * association with a specific peer MAC entity that resulted from an 95 * association procedure that was initiated by that specific peer MAC entity. 96 * 97 * PeerSTAAddress = sta->addr 98 */ 99 void mlme_associate_indication(struct hostapd_data *hapd, struct sta_info *sta) 100 { 101 hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME, 102 HOSTAPD_LEVEL_DEBUG, 103 "MLME-ASSOCIATE.indication(" MACSTR ")", 104 MAC2STR(sta->addr)); 105 if (sta->auth_alg != WLAN_AUTH_FT) 106 mlme_deletekeys_request(hapd, sta); 107 } 108 109 110 /** 111 * mlme_reassociate_indication - Report the establishment of an reassociation 112 * with a specific peer MAC entity 113 * @hapd: BSS data 114 * @sta: peer STA data 115 * 116 * MLME calls this function as a result of the establishment of an 117 * reassociation with a specific peer MAC entity that resulted from a 118 * reassociation procedure that was initiated by that specific peer MAC entity. 119 * 120 * PeerSTAAddress = sta->addr 121 * 122 * sta->previous_ap contains the "Current AP" information from ReassocReq. 123 */ 124 void mlme_reassociate_indication(struct hostapd_data *hapd, 125 struct sta_info *sta) 126 { 127 hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME, 128 HOSTAPD_LEVEL_DEBUG, 129 "MLME-REASSOCIATE.indication(" MACSTR ")", 130 MAC2STR(sta->addr)); 131 if (sta->auth_alg != WLAN_AUTH_FT) 132 mlme_deletekeys_request(hapd, sta); 133 } 134 135 136 /** 137 * mlme_disassociate_indication - Report disassociation with a specific peer 138 * MAC entity 139 * @hapd: BSS data 140 * @sta: Peer STA data 141 * @reason_code: ReasonCode from Disassociation frame 142 * 143 * MLME calls this function as a result of the invalidation of an association 144 * relationship with a specific peer MAC entity. 145 * 146 * PeerSTAAddress = sta->addr 147 */ 148 void mlme_disassociate_indication(struct hostapd_data *hapd, 149 struct sta_info *sta, u16 reason_code) 150 { 151 hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME, 152 HOSTAPD_LEVEL_DEBUG, 153 "MLME-DISASSOCIATE.indication(" MACSTR ", %d)", 154 MAC2STR(sta->addr), reason_code); 155 mlme_deletekeys_request(hapd, sta); 156 } 157 158 159 void mlme_michaelmicfailure_indication(struct hostapd_data *hapd, 160 const u8 *addr) 161 { 162 hostapd_logger(hapd, addr, HOSTAPD_MODULE_MLME, 163 HOSTAPD_LEVEL_DEBUG, 164 "MLME-MichaelMICFailure.indication(" MACSTR ")", 165 MAC2STR(addr)); 166 } 167 168 169 void mlme_deletekeys_request(struct hostapd_data *hapd, struct sta_info *sta) 170 { 171 hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME, 172 HOSTAPD_LEVEL_DEBUG, 173 "MLME-DELETEKEYS.request(" MACSTR ")", 174 MAC2STR(sta->addr)); 175 176 if (sta->wpa_sm) 177 wpa_remove_ptk(sta->wpa_sm); 178 } 179