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 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 */ 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 && !(sta->flags & WLAN_STA_MFP)) 61 mlme_deletekeys_request(hapd, sta); 62 } 63 64 65 /** 66 * mlme_deauthenticate_indication - Report the invalidation of an 67 * authentication relationship with a specific peer MAC entity 68 * @hapd: BSS data 69 * @sta: Peer STA data 70 * @reason_code: ReasonCode from Deauthentication frame 71 * 72 * MLME calls this function as a result of the invalidation of an 73 * authentication relationship with a specific peer MAC entity. 74 * 75 * PeerSTAAddress = sta->addr 76 */ 77 void mlme_deauthenticate_indication(struct hostapd_data *hapd, 78 struct sta_info *sta, u16 reason_code) 79 { 80 hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME, 81 HOSTAPD_LEVEL_DEBUG, 82 "MLME-DEAUTHENTICATE.indication(" MACSTR ", %d)", 83 MAC2STR(sta->addr), reason_code); 84 if (!hapd->iface->driver_ap_teardown) 85 mlme_deletekeys_request(hapd, sta); 86 } 87 88 89 /** 90 * mlme_associate_indication - Report the establishment of an association with 91 * a specific peer MAC entity 92 * @hapd: BSS data 93 * @sta: peer STA data 94 * 95 * MLME calls this function as a result of the establishment of an 96 * association with a specific peer MAC entity that resulted from an 97 * association procedure that was initiated by that specific peer MAC entity. 98 * 99 * PeerSTAAddress = sta->addr 100 */ 101 void mlme_associate_indication(struct hostapd_data *hapd, struct sta_info *sta) 102 { 103 hostapd_logger(hapd, sta->addr, HOSTAPD_MODULE_MLME, 104 HOSTAPD_LEVEL_DEBUG, 105 "MLME-ASSOCIATE.indication(" MACSTR ")", 106 MAC2STR(sta->addr)); 107 if (sta->auth_alg != WLAN_AUTH_FT) 108 mlme_deletekeys_request(hapd, sta); 109 } 110 111 112 /** 113 * mlme_reassociate_indication - Report the establishment of an reassociation 114 * with a specific peer MAC entity 115 * @hapd: BSS data 116 * @sta: peer STA data 117 * 118 * MLME calls this function as a result of the establishment of an 119 * reassociation with a specific peer MAC entity that resulted from a 120 * reassociation procedure that was initiated by that specific peer MAC entity. 121 * 122 * PeerSTAAddress = sta->addr 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