www.project-moonshot.org Git - mech_eap.orig/blob - libeap/src/ap/ieee802_1x.h

   1 /*
   2  * hostapd / IEEE 802.1X-2004 Authenticator
   3  * Copyright (c) 2002-2007, Jouni Malinen <j@w1.fi>
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License version 2 as
   7  * published by the Free Software Foundation.
   8  *
   9  * Alternatively, this software may be distributed under the terms of BSD
  10  * license.
  11  *
  12  * See README and COPYING for more details.
  13  */
  14
  15 #ifndef IEEE802_1X_H
  16 #define IEEE802_1X_H
  17
  18 struct hostapd_data;
  19 struct sta_info;
  20 struct eapol_state_machine;
  21 struct hostapd_config;
  22 struct hostapd_bss_config;
  23
  24 #ifdef _MSC_VER
  25 #pragma pack(push, 1)
  26 #endif /* _MSC_VER */
  27
  28 /* RFC 3580, 4. RC4 EAPOL-Key Frame */
  29
  30 struct ieee802_1x_eapol_key {
  31         u8 type;
  32         u16 key_length;
  33         u8 replay_counter[8]; /* does not repeat within the life of the keying
  34                                * material used to encrypt the Key field;
  35                                * 64-bit NTP timestamp MAY be used here */
  36         u8 key_iv[16]; /* cryptographically random number */
  37         u8 key_index; /* key flag in the most significant bit:
  38                        * 0 = broadcast (default key),
  39                        * 1 = unicast (key mapping key); key index is in the
  40                        * 7 least significant bits */
  41         u8 key_signature[16]; /* HMAC-MD5 message integrity check computed with
  42                                * MS-MPPE-Send-Key as the key */
  43
  44         /* followed by key: if packet body length = 44 + key length, then the
  45          * key field (of key_length bytes) contains the key in encrypted form;
  46          * if packet body length = 44, key field is absent and key_length
  47          * represents the number of least significant octets from
  48          * MS-MPPE-Send-Key attribute to be used as the keying material;
  49          * RC4 key used in encryption = Key-IV + MS-MPPE-Recv-Key */
  50 } STRUCT_PACKED;
  51
  52 #ifdef _MSC_VER
  53 #pragma pack(pop)
  54 #endif /* _MSC_VER */
  55
  56
  57 void ieee802_1x_receive(struct hostapd_data *hapd, const u8 *sa, const u8 *buf,
  58                         size_t len);
  59 void ieee802_1x_new_station(struct hostapd_data *hapd, struct sta_info *sta);
  60 void ieee802_1x_free_station(struct sta_info *sta);
  61
  62 void ieee802_1x_tx_key(struct hostapd_data *hapd, struct sta_info *sta);
  63 void ieee802_1x_abort_auth(struct hostapd_data *hapd, struct sta_info *sta);
  64 void ieee802_1x_set_sta_authorized(struct hostapd_data *hapd,
  65                                    struct sta_info *sta, int authorized);
  66 void ieee802_1x_dump_state(FILE *f, const char *prefix, struct sta_info *sta);
  67 int ieee802_1x_init(struct hostapd_data *hapd);
  68 void ieee802_1x_deinit(struct hostapd_data *hapd);
  69 int ieee802_1x_tx_status(struct hostapd_data *hapd, struct sta_info *sta,
  70                          const u8 *buf, size_t len, int ack);
  71 u8 * ieee802_1x_get_identity(struct eapol_state_machine *sm, size_t *len);
  72 u8 * ieee802_1x_get_radius_class(struct eapol_state_machine *sm, size_t *len,
  73                                  int idx);
  74 const u8 * ieee802_1x_get_key(struct eapol_state_machine *sm, size_t *len);
  75 void ieee802_1x_notify_port_enabled(struct eapol_state_machine *sm,
  76                                     int enabled);
  77 void ieee802_1x_notify_port_valid(struct eapol_state_machine *sm,
  78                                   int valid);
  79 void ieee802_1x_notify_pre_auth(struct eapol_state_machine *sm, int pre_auth);
  80 int ieee802_1x_get_mib(struct hostapd_data *hapd, char *buf, size_t buflen);
  81 int ieee802_1x_get_mib_sta(struct hostapd_data *hapd, struct sta_info *sta,
  82                            char *buf, size_t buflen);
  83 void hostapd_get_ntp_timestamp(u8 *buf);
  84 char *eap_type_text(u8 type);
  85
  86 const char *radius_mode_txt(struct hostapd_data *hapd);
  87 int radius_sta_rate(struct hostapd_data *hapd, struct sta_info *sta);
  88
  89 #endif /* IEEE802_1X_H */