Added support for enforcing frequent PTK rekeying
[libeap.git] / hostapd / config.h
1 /*
2  * hostapd / Configuration file
3  * Copyright (c) 2003-2007, Jouni Malinen <j@w1.fi>
4  * Copyright (c) 2007-2008, Intel Corporation
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 as
8  * published by the Free Software Foundation.
9  *
10  * Alternatively, this software may be distributed under the terms of BSD
11  * license.
12  *
13  * See README and COPYING for more details.
14  */
15
16 #ifndef CONFIG_H
17 #define CONFIG_H
18
19 #include "defs.h"
20 #include "ip_addr.h"
21 #include "wpa_common.h"
22
23 #ifndef IFNAMSIZ
24 #define IFNAMSIZ 16
25 #endif
26
27 typedef u8 macaddr[ETH_ALEN];
28
29 struct mac_acl_entry {
30         macaddr addr;
31         int vlan_id;
32 };
33
34 struct hostapd_radius_servers;
35 struct ft_remote_r0kh;
36 struct ft_remote_r1kh;
37
38 #define HOSTAPD_MAX_SSID_LEN 32
39
40 #define NUM_WEP_KEYS 4
41 struct hostapd_wep_keys {
42         u8 idx;
43         u8 *key[NUM_WEP_KEYS];
44         size_t len[NUM_WEP_KEYS];
45         int keys_set;
46         size_t default_len; /* key length used for dynamic key generation */
47 };
48
49 typedef enum hostap_security_policy {
50         SECURITY_PLAINTEXT = 0,
51         SECURITY_STATIC_WEP = 1,
52         SECURITY_IEEE_802_1X = 2,
53         SECURITY_WPA_PSK = 3,
54         SECURITY_WPA = 4
55 } secpolicy;
56
57 struct hostapd_ssid {
58         char ssid[HOSTAPD_MAX_SSID_LEN + 1];
59         size_t ssid_len;
60         int ssid_set;
61
62         char vlan[IFNAMSIZ + 1];
63         secpolicy security_policy;
64
65         struct hostapd_wpa_psk *wpa_psk;
66         char *wpa_passphrase;
67         char *wpa_psk_file;
68
69         struct hostapd_wep_keys wep;
70
71 #define DYNAMIC_VLAN_DISABLED 0
72 #define DYNAMIC_VLAN_OPTIONAL 1
73 #define DYNAMIC_VLAN_REQUIRED 2
74         int dynamic_vlan;
75 #ifdef CONFIG_FULL_DYNAMIC_VLAN
76         char *vlan_tagged_interface;
77 #endif /* CONFIG_FULL_DYNAMIC_VLAN */
78         struct hostapd_wep_keys **dyn_vlan_keys;
79         size_t max_dyn_vlan_keys;
80 };
81
82
83 #define VLAN_ID_WILDCARD -1
84
85 struct hostapd_vlan {
86         struct hostapd_vlan *next;
87         int vlan_id; /* VLAN ID or -1 (VLAN_ID_WILDCARD) for wildcard entry */
88         char ifname[IFNAMSIZ + 1];
89         int dynamic_vlan;
90 #ifdef CONFIG_FULL_DYNAMIC_VLAN
91
92 #define DVLAN_CLEAN_BR  0x1
93 #define DVLAN_CLEAN_VLAN        0x2
94 #define DVLAN_CLEAN_VLAN_PORT   0x4
95 #define DVLAN_CLEAN_WLAN_PORT   0x8
96         int clean;
97 #endif /* CONFIG_FULL_DYNAMIC_VLAN */
98 };
99
100 #define PMK_LEN 32
101 struct hostapd_wpa_psk {
102         struct hostapd_wpa_psk *next;
103         int group;
104         u8 psk[PMK_LEN];
105         u8 addr[ETH_ALEN];
106 };
107
108 #define EAP_USER_MAX_METHODS 8
109 struct hostapd_eap_user {
110         struct hostapd_eap_user *next;
111         u8 *identity;
112         size_t identity_len;
113         struct {
114                 int vendor;
115                 u32 method;
116         } methods[EAP_USER_MAX_METHODS];
117         u8 *password;
118         size_t password_len;
119         int phase2;
120         int force_version;
121         unsigned int wildcard_prefix:1;
122         unsigned int password_hash:1; /* whether password is hashed with
123                                        * nt_password_hash() */
124         int ttls_auth; /* EAP_TTLS_AUTH_* bitfield */
125 };
126
127
128 #define NUM_TX_QUEUES 8
129
130 struct hostapd_tx_queue_params {
131         int aifs;
132         int cwmin;
133         int cwmax;
134         int burst; /* maximum burst time in 0.1 ms, i.e., 10 = 1 ms */
135         int configured;
136 };
137
138 struct hostapd_wme_ac_params {
139         int cwmin;
140         int cwmax;
141         int aifs;
142         int txopLimit; /* in units of 32us */
143         int admission_control_mandatory;
144 };
145
146
147 /**
148  * struct hostapd_bss_config - Per-BSS configuration
149  */
150 struct hostapd_bss_config {
151         char iface[IFNAMSIZ + 1];
152         char bridge[IFNAMSIZ + 1];
153
154         enum hostapd_logger_level logger_syslog_level, logger_stdout_level;
155
156         unsigned int logger_syslog; /* module bitfield */
157         unsigned int logger_stdout; /* module bitfield */
158
159         char *dump_log_name; /* file name for state dump (SIGUSR1) */
160
161         int max_num_sta; /* maximum number of STAs in station table */
162
163         int dtim_period;
164
165         int ieee802_1x; /* use IEEE 802.1X */
166         int eapol_version;
167         int eap_server; /* Use internal EAP server instead of external
168                          * RADIUS server */
169         struct hostapd_eap_user *eap_user;
170         char *eap_sim_db;
171         struct hostapd_ip_addr own_ip_addr;
172         char *nas_identifier;
173         struct hostapd_radius_servers *radius;
174
175         struct hostapd_ssid ssid;
176
177         char *eap_req_id_text; /* optional displayable message sent with
178                                 * EAP Request-Identity */
179         size_t eap_req_id_text_len;
180         int eapol_key_index_workaround;
181
182         size_t default_wep_key_len;
183         int individual_wep_key_len;
184         int wep_rekeying_period;
185         int broadcast_key_idx_min, broadcast_key_idx_max;
186         int eap_reauth_period;
187
188         int ieee802_11f; /* use IEEE 802.11f (IAPP) */
189         char iapp_iface[IFNAMSIZ + 1]; /* interface used with IAPP broadcast
190                                         * frames */
191
192         u8 assoc_ap_addr[ETH_ALEN];
193         int assoc_ap; /* whether assoc_ap_addr is set */
194
195         enum {
196                 ACCEPT_UNLESS_DENIED = 0,
197                 DENY_UNLESS_ACCEPTED = 1,
198                 USE_EXTERNAL_RADIUS_AUTH = 2
199         } macaddr_acl;
200         struct mac_acl_entry *accept_mac;
201         int num_accept_mac;
202         struct mac_acl_entry *deny_mac;
203         int num_deny_mac;
204
205         int auth_algs; /* bitfield of allowed IEEE 802.11 authentication
206                         * algorithms, WPA_AUTH_ALG_{OPEN,SHARED,LEAP} */
207
208         int wpa; /* bitfield of WPA_PROTO_WPA, WPA_PROTO_RSN */
209         int wpa_key_mgmt;
210 #ifdef CONFIG_IEEE80211W
211         enum {
212                 NO_IEEE80211W = 0,
213                 IEEE80211W_OPTIONAL = 1,
214                 IEEE80211W_REQUIRED = 2
215         } ieee80211w;
216         /* dot11AssociationPingResponseTimeout (in TU) */
217         unsigned int assoc_ping_timeout;
218         /* dot11AssociationMaximumPingAttempts */
219         int assoc_ping_attempts;
220 #endif /* CONFIG_IEEE80211W */
221         int wpa_pairwise;
222         int wpa_group;
223         int wpa_group_rekey;
224         int wpa_strict_rekey;
225         int wpa_gmk_rekey;
226         int wpa_ptk_rekey;
227         int rsn_pairwise;
228         int rsn_preauth;
229         char *rsn_preauth_interfaces;
230         int peerkey;
231
232 #ifdef CONFIG_IEEE80211R
233         /* IEEE 802.11r - Fast BSS Transition */
234         u8 mobility_domain[MOBILITY_DOMAIN_ID_LEN];
235         u8 r1_key_holder[FT_R1KH_ID_LEN];
236         u32 r0_key_lifetime;
237         u32 reassociation_deadline;
238         struct ft_remote_r0kh *r0kh_list;
239         struct ft_remote_r1kh *r1kh_list;
240         int pmk_r1_push;
241 #endif /* CONFIG_IEEE80211R */
242
243         char *ctrl_interface; /* directory for UNIX domain sockets */
244         gid_t ctrl_interface_gid;
245         int ctrl_interface_gid_set;
246
247         char *ca_cert;
248         char *server_cert;
249         char *private_key;
250         char *private_key_passwd;
251         int check_crl;
252         char *dh_file;
253         u8 *pac_opaque_encr_key;
254         u8 *eap_fast_a_id;
255         size_t eap_fast_a_id_len;
256         char *eap_fast_a_id_info;
257         int eap_fast_prov;
258         int pac_key_lifetime;
259         int pac_key_refresh_time;
260         int eap_sim_aka_result_ind;
261         int tnc;
262
263         char *radius_server_clients;
264         int radius_server_auth_port;
265         int radius_server_ipv6;
266
267         char *test_socket; /* UNIX domain socket path for driver_test */
268
269         int use_pae_group_addr; /* Whether to send EAPOL frames to PAE group
270                                  * address instead of individual address
271                                  * (for driver_wired.c).
272                                  */
273
274         int ap_max_inactivity;
275         int ignore_broadcast_ssid;
276
277         int wme_enabled;
278
279         struct hostapd_vlan *vlan, *vlan_tail;
280
281         macaddr bssid;
282
283         /*
284          * Maximum listen interval that STAs can use when associating with this
285          * BSS. If a STA tries to use larger value, the association will be
286          * denied with status code 51.
287          */
288         u16 max_listen_interval;
289
290         int okc; /* Opportunistic Key Caching */
291 };
292
293
294 typedef enum {
295         HOSTAPD_MODE_IEEE80211B,
296         HOSTAPD_MODE_IEEE80211G,
297         HOSTAPD_MODE_IEEE80211A,
298         NUM_HOSTAPD_MODES
299 } hostapd_hw_mode;
300
301
302 /**
303  * struct hostapd_config - Per-radio interface configuration
304  */
305 struct hostapd_config {
306         struct hostapd_bss_config *bss, *last_bss;
307         struct hostapd_radius_servers *radius;
308         size_t num_bss;
309
310         u16 beacon_int;
311         int rts_threshold;
312         int fragm_threshold;
313         u8 send_probe_response;
314         u8 channel;
315         hostapd_hw_mode hw_mode; /* HOSTAPD_MODE_IEEE80211A, .. */
316         enum {
317                 LONG_PREAMBLE = 0,
318                 SHORT_PREAMBLE = 1
319         } preamble;
320         enum {
321                 CTS_PROTECTION_AUTOMATIC = 0,
322                 CTS_PROTECTION_FORCE_ENABLED = 1,
323                 CTS_PROTECTION_FORCE_DISABLED = 2,
324                 CTS_PROTECTION_AUTOMATIC_NO_OLBC = 3,
325         } cts_protection_type;
326
327         int *supported_rates;
328         int *basic_rates;
329
330         const struct wpa_driver_ops *driver;
331
332         int passive_scan_interval; /* seconds, 0 = disabled */
333         int passive_scan_listen; /* usec */
334         int passive_scan_mode;
335         int ap_table_max_size;
336         int ap_table_expiration_time;
337
338         char country[3]; /* first two octets: country code as described in
339                           * ISO/IEC 3166-1. Third octet:
340                           * ' ' (ascii 32): all environments
341                           * 'O': Outdoor environemnt only
342                           * 'I': Indoor environment only
343                           */
344
345         int ieee80211d;
346         unsigned int ieee80211h; /* Enable/Disable 80211h */
347
348         struct hostapd_tx_queue_params tx_queue[NUM_TX_QUEUES];
349
350         /*
351          * WME AC parameters, in same order as 802.1D, i.e.
352          * 0 = BE (best effort)
353          * 1 = BK (background)
354          * 2 = VI (video)
355          * 3 = VO (voice)
356          */
357         struct hostapd_wme_ac_params wme_ac_params[4];
358
359         enum {
360                 INTERNAL_BRIDGE_DO_NOT_CONTROL = -1,
361                 INTERNAL_BRIDGE_DISABLED = 0,
362                 INTERNAL_BRIDGE_ENABLED = 1
363         } bridge_packets;
364
365 #ifdef CONFIG_IEEE80211N
366         int ieee80211n;
367         int ht_op_mode_fixed;
368         u16 ht_capab;
369 #endif /* CONFIG_IEEE80211N */
370 };
371
372
373 int hostapd_mac_comp(const void *a, const void *b);
374 int hostapd_mac_comp_empty(const void *a);
375 struct hostapd_config * hostapd_config_read(const char *fname);
376 void hostapd_config_free(struct hostapd_config *conf);
377 int hostapd_maclist_found(struct mac_acl_entry *list, int num_entries,
378                           const u8 *addr, int *vlan_id);
379 int hostapd_rate_found(int *list, int rate);
380 int hostapd_wep_key_cmp(struct hostapd_wep_keys *a,
381                         struct hostapd_wep_keys *b);
382 const u8 * hostapd_get_psk(const struct hostapd_bss_config *conf,
383                            const u8 *addr, const u8 *prev_psk);
384 int hostapd_setup_wpa_psk(struct hostapd_bss_config *conf);
385 const char * hostapd_get_vlan_id_ifname(struct hostapd_vlan *vlan,
386                                         int vlan_id);
387 const struct hostapd_eap_user *
388 hostapd_get_eap_user(const struct hostapd_bss_config *conf, const u8 *identity,
389                      size_t identity_len, int phase2);
390
391 #endif /* CONFIG_H */