contrib/wpa/src/ap/ap_mlme.c

   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 &&
  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  */
  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  */
 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  */
 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  */
 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
 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
 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 }