2 * hostapd / IEEE 802.11 authentication (ACL)
3 * Copyright (c) 2003-2012, Jouni Malinen <j@w1.fi>
5 * This software may be distributed under the terms of the BSD license.
6 * See README for more details.
8 * Access control list for IEEE 802.11 authentication can uses statically
9 * configured ACL from configuration files or an external RADIUS server.
10 * Results from external RADIUS queries are cached to allow faster
11 * authentication frame processing.
14 #include "utils/includes.h"
16 #include "utils/common.h"
17 #include "utils/eloop.h"
18 #include "crypto/sha1.h"
19 #include "radius/radius.h"
20 #include "radius/radius_client.h"
22 #include "ap_config.h"
23 #include "ap_drv_ops.h"
24 #include "ieee802_11.h"
25 #include "ieee802_1x.h"
26 #include "ieee802_11_auth.h"
28 #define RADIUS_ACL_TIMEOUT 30
31 struct hostapd_cached_radius_acl {
32 struct os_reltime timestamp;
34 int accepted; /* HOSTAPD_ACL_* */
35 struct hostapd_cached_radius_acl *next;
37 u32 acct_interim_interval;
39 struct hostapd_sta_wpa_psk_short *psk;
45 struct hostapd_acl_query_data {
46 struct os_reltime timestamp;
49 u8 *auth_msg; /* IEEE 802.11 authentication frame from station */
51 struct hostapd_acl_query_data *next;
55 #ifndef CONFIG_NO_RADIUS
56 static void hostapd_acl_cache_free_entry(struct hostapd_cached_radius_acl *e)
59 os_free(e->radius_cui);
60 hostapd_free_psk_list(e->psk);
65 static void hostapd_acl_cache_free(struct hostapd_cached_radius_acl *acl_cache)
67 struct hostapd_cached_radius_acl *prev;
71 acl_cache = acl_cache->next;
72 hostapd_acl_cache_free_entry(prev);
77 static void copy_psk_list(struct hostapd_sta_wpa_psk_short **psk,
78 struct hostapd_sta_wpa_psk_short *src)
80 struct hostapd_sta_wpa_psk_short **copy_to;
81 struct hostapd_sta_wpa_psk_short *copy_from;
83 /* Copy PSK linked list */
86 while (copy_from && copy_to) {
87 *copy_to = os_zalloc(sizeof(struct hostapd_sta_wpa_psk_short));
90 os_memcpy(*copy_to, copy_from,
91 sizeof(struct hostapd_sta_wpa_psk_short));
92 copy_from = copy_from->next;
93 copy_to = &((*copy_to)->next);
100 static int hostapd_acl_cache_get(struct hostapd_data *hapd, const u8 *addr,
101 u32 *session_timeout,
102 u32 *acct_interim_interval, int *vlan_id,
103 struct hostapd_sta_wpa_psk_short **psk,
104 char **identity, char **radius_cui)
106 struct hostapd_cached_radius_acl *entry;
107 struct os_reltime now;
109 os_get_reltime(&now);
111 for (entry = hapd->acl_cache; entry; entry = entry->next) {
112 if (os_memcmp(entry->addr, addr, ETH_ALEN) != 0)
115 if (os_reltime_expired(&now, &entry->timestamp,
117 return -1; /* entry has expired */
118 if (entry->accepted == HOSTAPD_ACL_ACCEPT_TIMEOUT)
120 *session_timeout = entry->session_timeout;
121 if (acct_interim_interval)
122 *acct_interim_interval =
123 entry->acct_interim_interval;
125 *vlan_id = entry->vlan_id;
126 copy_psk_list(psk, entry->psk);
129 *identity = os_strdup(entry->identity);
134 if (entry->radius_cui)
135 *radius_cui = os_strdup(entry->radius_cui);
139 return entry->accepted;
144 #endif /* CONFIG_NO_RADIUS */
147 static void hostapd_acl_query_free(struct hostapd_acl_query_data *query)
151 os_free(query->auth_msg);
156 #ifndef CONFIG_NO_RADIUS
157 static int hostapd_radius_acl_query(struct hostapd_data *hapd, const u8 *addr,
158 struct hostapd_acl_query_data *query)
160 struct radius_msg *msg;
163 query->radius_id = radius_client_get_id(hapd->radius);
164 msg = radius_msg_new(RADIUS_CODE_ACCESS_REQUEST, query->radius_id);
168 radius_msg_make_authenticator(msg, addr, ETH_ALEN);
170 os_snprintf(buf, sizeof(buf), RADIUS_ADDR_FORMAT, MAC2STR(addr));
171 if (!radius_msg_add_attr(msg, RADIUS_ATTR_USER_NAME, (u8 *) buf,
173 wpa_printf(MSG_DEBUG, "Could not add User-Name");
177 if (!radius_msg_add_attr_user_password(
178 msg, (u8 *) buf, os_strlen(buf),
179 hapd->conf->radius->auth_server->shared_secret,
180 hapd->conf->radius->auth_server->shared_secret_len)) {
181 wpa_printf(MSG_DEBUG, "Could not add User-Password");
185 if (add_common_radius_attr(hapd, hapd->conf->radius_auth_req_attr,
189 os_snprintf(buf, sizeof(buf), RADIUS_802_1X_ADDR_FORMAT,
191 if (!radius_msg_add_attr(msg, RADIUS_ATTR_CALLING_STATION_ID,
192 (u8 *) buf, os_strlen(buf))) {
193 wpa_printf(MSG_DEBUG, "Could not add Calling-Station-Id");
197 os_snprintf(buf, sizeof(buf), "CONNECT 11Mbps 802.11b");
198 if (!radius_msg_add_attr(msg, RADIUS_ATTR_CONNECT_INFO,
199 (u8 *) buf, os_strlen(buf))) {
200 wpa_printf(MSG_DEBUG, "Could not add Connect-Info");
204 if (radius_client_send(hapd->radius, msg, RADIUS_AUTH, addr) < 0)
209 radius_msg_free(msg);
212 #endif /* CONFIG_NO_RADIUS */
216 * hostapd_check_acl - Check a specified STA against accept/deny ACLs
217 * @hapd: hostapd BSS data
218 * @addr: MAC address of the STA
219 * @vlan_id: Buffer for returning VLAN ID
220 * Returns: HOSTAPD_ACL_ACCEPT, HOSTAPD_ACL_REJECT, or HOSTAPD_ACL_PENDING
222 int hostapd_check_acl(struct hostapd_data *hapd, const u8 *addr, int *vlan_id)
224 if (hostapd_maclist_found(hapd->conf->accept_mac,
225 hapd->conf->num_accept_mac, addr, vlan_id))
226 return HOSTAPD_ACL_ACCEPT;
228 if (hostapd_maclist_found(hapd->conf->deny_mac,
229 hapd->conf->num_deny_mac, addr, vlan_id))
230 return HOSTAPD_ACL_REJECT;
232 if (hapd->conf->macaddr_acl == ACCEPT_UNLESS_DENIED)
233 return HOSTAPD_ACL_ACCEPT;
234 if (hapd->conf->macaddr_acl == DENY_UNLESS_ACCEPTED)
235 return HOSTAPD_ACL_REJECT;
237 return HOSTAPD_ACL_PENDING;
242 * hostapd_allowed_address - Check whether a specified STA can be authenticated
243 * @hapd: hostapd BSS data
244 * @addr: MAC address of the STA
245 * @msg: Authentication message
246 * @len: Length of msg in octets
247 * @session_timeout: Buffer for returning session timeout (from RADIUS)
248 * @acct_interim_interval: Buffer for returning account interval (from RADIUS)
249 * @vlan_id: Buffer for returning VLAN ID
250 * @psk: Linked list buffer for returning WPA PSK
251 * @identity: Buffer for returning identity (from RADIUS)
252 * @radius_cui: Buffer for returning CUI (from RADIUS)
253 * Returns: HOSTAPD_ACL_ACCEPT, HOSTAPD_ACL_REJECT, or HOSTAPD_ACL_PENDING
255 * The caller is responsible for freeing the returned *identity and *radius_cui
256 * values with os_free().
258 int hostapd_allowed_address(struct hostapd_data *hapd, const u8 *addr,
259 const u8 *msg, size_t len, u32 *session_timeout,
260 u32 *acct_interim_interval, int *vlan_id,
261 struct hostapd_sta_wpa_psk_short **psk,
262 char **identity, char **radius_cui)
267 *session_timeout = 0;
268 if (acct_interim_interval)
269 *acct_interim_interval = 0;
279 res = hostapd_check_acl(hapd, addr, vlan_id);
280 if (res != HOSTAPD_ACL_PENDING)
283 if (hapd->conf->macaddr_acl == USE_EXTERNAL_RADIUS_AUTH) {
284 #ifdef CONFIG_NO_RADIUS
285 return HOSTAPD_ACL_REJECT;
286 #else /* CONFIG_NO_RADIUS */
287 struct hostapd_acl_query_data *query;
289 /* Check whether ACL cache has an entry for this station */
290 res = hostapd_acl_cache_get(hapd, addr, session_timeout,
291 acct_interim_interval, vlan_id, psk,
292 identity, radius_cui);
293 if (res == HOSTAPD_ACL_ACCEPT ||
294 res == HOSTAPD_ACL_ACCEPT_TIMEOUT)
296 if (res == HOSTAPD_ACL_REJECT)
297 return HOSTAPD_ACL_REJECT;
299 query = hapd->acl_queries;
301 if (os_memcmp(query->addr, addr, ETH_ALEN) == 0) {
302 /* pending query in RADIUS retransmit queue;
303 * do not generate a new one */
309 os_free(*radius_cui);
312 return HOSTAPD_ACL_PENDING;
317 if (!hapd->conf->radius->auth_server)
318 return HOSTAPD_ACL_REJECT;
320 /* No entry in the cache - query external RADIUS server */
321 query = os_zalloc(sizeof(*query));
323 wpa_printf(MSG_ERROR, "malloc for query data failed");
324 return HOSTAPD_ACL_REJECT;
326 os_get_reltime(&query->timestamp);
327 os_memcpy(query->addr, addr, ETH_ALEN);
328 if (hostapd_radius_acl_query(hapd, addr, query)) {
329 wpa_printf(MSG_DEBUG, "Failed to send Access-Request "
331 hostapd_acl_query_free(query);
332 return HOSTAPD_ACL_REJECT;
335 query->auth_msg = os_malloc(len);
336 if (query->auth_msg == NULL) {
337 wpa_printf(MSG_ERROR, "Failed to allocate memory for "
339 hostapd_acl_query_free(query);
340 return HOSTAPD_ACL_REJECT;
342 os_memcpy(query->auth_msg, msg, len);
343 query->auth_msg_len = len;
344 query->next = hapd->acl_queries;
345 hapd->acl_queries = query;
347 /* Queued data will be processed in hostapd_acl_recv_radius()
348 * when RADIUS server replies to the sent Access-Request. */
349 return HOSTAPD_ACL_PENDING;
350 #endif /* CONFIG_NO_RADIUS */
353 return HOSTAPD_ACL_REJECT;
357 #ifndef CONFIG_NO_RADIUS
358 static void hostapd_acl_expire_cache(struct hostapd_data *hapd,
359 struct os_reltime *now)
361 struct hostapd_cached_radius_acl *prev, *entry, *tmp;
364 entry = hapd->acl_cache;
367 if (os_reltime_expired(now, &entry->timestamp,
368 RADIUS_ACL_TIMEOUT)) {
369 wpa_printf(MSG_DEBUG, "Cached ACL entry for " MACSTR
370 " has expired.", MAC2STR(entry->addr));
372 prev->next = entry->next;
374 hapd->acl_cache = entry->next;
375 hostapd_drv_set_radius_acl_expire(hapd, entry->addr);
378 hostapd_acl_cache_free_entry(tmp);
388 static void hostapd_acl_expire_queries(struct hostapd_data *hapd,
389 struct os_reltime *now)
391 struct hostapd_acl_query_data *prev, *entry, *tmp;
394 entry = hapd->acl_queries;
397 if (os_reltime_expired(now, &entry->timestamp,
398 RADIUS_ACL_TIMEOUT)) {
399 wpa_printf(MSG_DEBUG, "ACL query for " MACSTR
400 " has expired.", MAC2STR(entry->addr));
402 prev->next = entry->next;
404 hapd->acl_queries = entry->next;
408 hostapd_acl_query_free(tmp);
419 * hostapd_acl_expire - ACL cache expiration callback
420 * @hapd: struct hostapd_data *
422 void hostapd_acl_expire(struct hostapd_data *hapd)
424 struct os_reltime now;
426 os_get_reltime(&now);
427 hostapd_acl_expire_cache(hapd, &now);
428 hostapd_acl_expire_queries(hapd, &now);
432 static void decode_tunnel_passwords(struct hostapd_data *hapd,
433 const u8 *shared_secret,
434 size_t shared_secret_len,
435 struct radius_msg *msg,
436 struct radius_msg *req,
437 struct hostapd_cached_radius_acl *cache)
440 char *passphrase, *strpassphrase;
442 struct hostapd_sta_wpa_psk_short *psk;
445 * Decode all tunnel passwords as PSK and save them into a linked list.
448 passphrase = radius_msg_get_tunnel_password(
449 msg, &passphraselen, shared_secret, shared_secret_len,
452 * Passphrase is NULL iff there is no i-th Tunnel-Password
455 if (passphrase == NULL)
458 * passphrase does not contain the NULL termination.
459 * Add it here as pbkdf2_sha1() requires it.
461 strpassphrase = os_zalloc(passphraselen + 1);
462 psk = os_zalloc(sizeof(struct hostapd_sta_wpa_psk_short));
463 if (strpassphrase && psk) {
464 os_memcpy(strpassphrase, passphrase, passphraselen);
465 pbkdf2_sha1(strpassphrase,
466 hapd->conf->ssid.ssid,
467 hapd->conf->ssid.ssid_len, 4096,
469 psk->next = cache->psk;
473 os_free(strpassphrase);
481 * hostapd_acl_recv_radius - Process incoming RADIUS Authentication messages
482 * @msg: RADIUS response message
483 * @req: RADIUS request message
484 * @shared_secret: RADIUS shared secret
485 * @shared_secret_len: Length of shared_secret in octets
486 * @data: Context data (struct hostapd_data *)
487 * Returns: RADIUS_RX_PROCESSED if RADIUS message was a reply to ACL query (and
488 * was processed here) or RADIUS_RX_UNKNOWN if not.
490 static RadiusRxResult
491 hostapd_acl_recv_radius(struct radius_msg *msg, struct radius_msg *req,
492 const u8 *shared_secret, size_t shared_secret_len,
495 struct hostapd_data *hapd = data;
496 struct hostapd_acl_query_data *query, *prev;
497 struct hostapd_cached_radius_acl *cache;
498 struct radius_hdr *hdr = radius_msg_get_hdr(msg);
500 query = hapd->acl_queries;
503 if (query->radius_id == hdr->identifier)
509 return RADIUS_RX_UNKNOWN;
511 wpa_printf(MSG_DEBUG, "Found matching Access-Request for RADIUS "
512 "message (id=%d)", query->radius_id);
514 if (radius_msg_verify(msg, shared_secret, shared_secret_len, req, 0)) {
515 wpa_printf(MSG_INFO, "Incoming RADIUS packet did not have "
516 "correct authenticator - dropped\n");
517 return RADIUS_RX_INVALID_AUTHENTICATOR;
520 if (hdr->code != RADIUS_CODE_ACCESS_ACCEPT &&
521 hdr->code != RADIUS_CODE_ACCESS_REJECT) {
522 wpa_printf(MSG_DEBUG, "Unknown RADIUS message code %d to ACL "
524 return RADIUS_RX_UNKNOWN;
527 /* Insert Accept/Reject info into ACL cache */
528 cache = os_zalloc(sizeof(*cache));
530 wpa_printf(MSG_DEBUG, "Failed to add ACL cache entry");
533 os_get_reltime(&cache->timestamp);
534 os_memcpy(cache->addr, query->addr, sizeof(cache->addr));
535 if (hdr->code == RADIUS_CODE_ACCESS_ACCEPT) {
539 if (radius_msg_get_attr_int32(msg, RADIUS_ATTR_SESSION_TIMEOUT,
540 &cache->session_timeout) == 0)
541 cache->accepted = HOSTAPD_ACL_ACCEPT_TIMEOUT;
543 cache->accepted = HOSTAPD_ACL_ACCEPT;
545 if (radius_msg_get_attr_int32(
546 msg, RADIUS_ATTR_ACCT_INTERIM_INTERVAL,
547 &cache->acct_interim_interval) == 0 &&
548 cache->acct_interim_interval < 60) {
549 wpa_printf(MSG_DEBUG, "Ignored too small "
550 "Acct-Interim-Interval %d for STA " MACSTR,
551 cache->acct_interim_interval,
552 MAC2STR(query->addr));
553 cache->acct_interim_interval = 0;
556 cache->vlan_id = radius_msg_get_vlanid(msg);
558 decode_tunnel_passwords(hapd, shared_secret, shared_secret_len,
561 if (radius_msg_get_attr_ptr(msg, RADIUS_ATTR_USER_NAME,
562 &buf, &len, NULL) == 0) {
563 cache->identity = os_zalloc(len + 1);
565 os_memcpy(cache->identity, buf, len);
567 if (radius_msg_get_attr_ptr(
568 msg, RADIUS_ATTR_CHARGEABLE_USER_IDENTITY,
569 &buf, &len, NULL) == 0) {
570 cache->radius_cui = os_zalloc(len + 1);
571 if (cache->radius_cui)
572 os_memcpy(cache->radius_cui, buf, len);
575 if (hapd->conf->wpa_psk_radius == PSK_RADIUS_REQUIRED &&
577 cache->accepted = HOSTAPD_ACL_REJECT;
579 if (cache->vlan_id &&
580 !hostapd_vlan_id_valid(hapd->conf->vlan, cache->vlan_id)) {
581 hostapd_logger(hapd, query->addr,
582 HOSTAPD_MODULE_RADIUS,
584 "Invalid VLAN ID %d received from RADIUS server",
588 if (hapd->conf->ssid.dynamic_vlan == DYNAMIC_VLAN_REQUIRED &&
590 cache->accepted = HOSTAPD_ACL_REJECT;
592 cache->accepted = HOSTAPD_ACL_REJECT;
593 cache->next = hapd->acl_cache;
594 hapd->acl_cache = cache;
596 #ifdef CONFIG_DRIVER_RADIUS_ACL
597 hostapd_drv_set_radius_acl_auth(hapd, query->addr, cache->accepted,
598 cache->session_timeout);
599 #else /* CONFIG_DRIVER_RADIUS_ACL */
601 /* Re-send original authentication frame for 802.11 processing */
602 wpa_printf(MSG_DEBUG, "Re-sending authentication frame after "
603 "successful RADIUS ACL query");
604 ieee802_11_mgmt(hapd, query->auth_msg, query->auth_msg_len, NULL);
605 #endif /* NEED_AP_MLME */
606 #endif /* CONFIG_DRIVER_RADIUS_ACL */
610 hapd->acl_queries = query->next;
612 prev->next = query->next;
614 hostapd_acl_query_free(query);
616 return RADIUS_RX_PROCESSED;
618 #endif /* CONFIG_NO_RADIUS */
622 * hostapd_acl_init: Initialize IEEE 802.11 ACL
623 * @hapd: hostapd BSS data
624 * Returns: 0 on success, -1 on failure
626 int hostapd_acl_init(struct hostapd_data *hapd)
628 #ifndef CONFIG_NO_RADIUS
629 if (radius_client_register(hapd->radius, RADIUS_AUTH,
630 hostapd_acl_recv_radius, hapd))
632 #endif /* CONFIG_NO_RADIUS */
639 * hostapd_acl_deinit - Deinitialize IEEE 802.11 ACL
640 * @hapd: hostapd BSS data
642 void hostapd_acl_deinit(struct hostapd_data *hapd)
644 struct hostapd_acl_query_data *query, *prev;
646 #ifndef CONFIG_NO_RADIUS
647 hostapd_acl_cache_free(hapd->acl_cache);
648 #endif /* CONFIG_NO_RADIUS */
650 query = hapd->acl_queries;
654 hostapd_acl_query_free(prev);
659 void hostapd_free_psk_list(struct hostapd_sta_wpa_psk_short *psk)
662 struct hostapd_sta_wpa_psk_short *prev = psk;