2 * hostapd / IEEE 802.11 authentication (ACL)
3 * Copyright (c) 2003-2009, Jouni Malinen <j@w1.fi>
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.
9 * Alternatively, this software may be distributed under the terms of BSD
12 * See README and COPYING for more details.
14 * Access control list for IEEE 802.11 authentication can uses statically
15 * configured ACL from configuration files or an external RADIUS server.
16 * Results from external RADIUS queries are cached to allow faster
17 * authentication frame processing.
20 #include "utils/includes.h"
22 #include "utils/common.h"
23 #include "utils/eloop.h"
24 #include "radius/radius.h"
25 #include "radius/radius_client.h"
27 #include "ap_config.h"
28 #include "ieee802_11.h"
29 #include "ieee802_11_auth.h"
31 #define RADIUS_ACL_TIMEOUT 30
34 struct hostapd_cached_radius_acl
{
37 int accepted
; /* HOSTAPD_ACL_* */
38 struct hostapd_cached_radius_acl
*next
;
40 u32 acct_interim_interval
;
45 struct hostapd_acl_query_data
{
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(struct hostapd_cached_radius_acl
*acl_cache
)
58 struct hostapd_cached_radius_acl
*prev
;
62 acl_cache
= acl_cache
->next
;
68 static int hostapd_acl_cache_get(struct hostapd_data
*hapd
, const u8
*addr
,
70 u32
*acct_interim_interval
, int *vlan_id
)
72 struct hostapd_cached_radius_acl
*entry
;
76 entry
= hapd
->acl_cache
;
79 if (os_memcmp(entry
->addr
, addr
, ETH_ALEN
) == 0) {
80 if (now
- entry
->timestamp
> RADIUS_ACL_TIMEOUT
)
81 return -1; /* entry has expired */
82 if (entry
->accepted
== HOSTAPD_ACL_ACCEPT_TIMEOUT
)
85 entry
->session_timeout
;
86 if (acct_interim_interval
)
87 *acct_interim_interval
=
88 entry
->acct_interim_interval
;
90 *vlan_id
= entry
->vlan_id
;
91 return entry
->accepted
;
99 #endif /* CONFIG_NO_RADIUS */
102 static void hostapd_acl_query_free(struct hostapd_acl_query_data
*query
)
106 os_free(query
->auth_msg
);
111 #ifndef CONFIG_NO_RADIUS
112 static int hostapd_radius_acl_query(struct hostapd_data
*hapd
, const u8
*addr
,
113 struct hostapd_acl_query_data
*query
)
115 struct radius_msg
*msg
;
118 query
->radius_id
= radius_client_get_id(hapd
->radius
);
119 msg
= radius_msg_new(RADIUS_CODE_ACCESS_REQUEST
, query
->radius_id
);
123 radius_msg_make_authenticator(msg
, addr
, ETH_ALEN
);
125 os_snprintf(buf
, sizeof(buf
), RADIUS_ADDR_FORMAT
, MAC2STR(addr
));
126 if (!radius_msg_add_attr(msg
, RADIUS_ATTR_USER_NAME
, (u8
*) buf
,
128 wpa_printf(MSG_DEBUG
, "Could not add User-Name");
132 if (!radius_msg_add_attr_user_password(
133 msg
, (u8
*) buf
, os_strlen(buf
),
134 hapd
->conf
->radius
->auth_server
->shared_secret
,
135 hapd
->conf
->radius
->auth_server
->shared_secret_len
)) {
136 wpa_printf(MSG_DEBUG
, "Could not add User-Password");
140 if (hapd
->conf
->own_ip_addr
.af
== AF_INET
&&
141 !radius_msg_add_attr(msg
, RADIUS_ATTR_NAS_IP_ADDRESS
,
142 (u8
*) &hapd
->conf
->own_ip_addr
.u
.v4
, 4)) {
143 wpa_printf(MSG_DEBUG
, "Could not add NAS-IP-Address");
148 if (hapd
->conf
->own_ip_addr
.af
== AF_INET6
&&
149 !radius_msg_add_attr(msg
, RADIUS_ATTR_NAS_IPV6_ADDRESS
,
150 (u8
*) &hapd
->conf
->own_ip_addr
.u
.v6
, 16)) {
151 wpa_printf(MSG_DEBUG
, "Could not add NAS-IPv6-Address");
154 #endif /* CONFIG_IPV6 */
156 if (hapd
->conf
->nas_identifier
&&
157 !radius_msg_add_attr(msg
, RADIUS_ATTR_NAS_IDENTIFIER
,
158 (u8
*) hapd
->conf
->nas_identifier
,
159 os_strlen(hapd
->conf
->nas_identifier
))) {
160 wpa_printf(MSG_DEBUG
, "Could not add NAS-Identifier");
164 os_snprintf(buf
, sizeof(buf
), RADIUS_802_1X_ADDR_FORMAT
":%s",
165 MAC2STR(hapd
->own_addr
), hapd
->conf
->ssid
.ssid
);
166 if (!radius_msg_add_attr(msg
, RADIUS_ATTR_CALLED_STATION_ID
,
167 (u8
*) buf
, os_strlen(buf
))) {
168 wpa_printf(MSG_DEBUG
, "Could not add Called-Station-Id");
172 os_snprintf(buf
, sizeof(buf
), RADIUS_802_1X_ADDR_FORMAT
,
174 if (!radius_msg_add_attr(msg
, RADIUS_ATTR_CALLING_STATION_ID
,
175 (u8
*) buf
, os_strlen(buf
))) {
176 wpa_printf(MSG_DEBUG
, "Could not add Calling-Station-Id");
180 if (!radius_msg_add_attr_int32(msg
, RADIUS_ATTR_NAS_PORT_TYPE
,
181 RADIUS_NAS_PORT_TYPE_IEEE_802_11
)) {
182 wpa_printf(MSG_DEBUG
, "Could not add NAS-Port-Type");
186 os_snprintf(buf
, sizeof(buf
), "CONNECT 11Mbps 802.11b");
187 if (!radius_msg_add_attr(msg
, RADIUS_ATTR_CONNECT_INFO
,
188 (u8
*) buf
, os_strlen(buf
))) {
189 wpa_printf(MSG_DEBUG
, "Could not add Connect-Info");
193 radius_client_send(hapd
->radius
, msg
, RADIUS_AUTH
, addr
);
197 radius_msg_free(msg
);
200 #endif /* CONFIG_NO_RADIUS */
204 * hostapd_allowed_address - Check whether a specified STA can be authenticated
205 * @hapd: hostapd BSS data
206 * @addr: MAC address of the STA
207 * @msg: Authentication message
208 * @len: Length of msg in octets
209 * @session_timeout: Buffer for returning session timeout (from RADIUS)
210 * @acct_interim_interval: Buffer for returning account interval (from RADIUS)
211 * @vlan_id: Buffer for returning VLAN ID
212 * Returns: HOSTAPD_ACL_ACCEPT, HOSTAPD_ACL_REJECT, or HOSTAPD_ACL_PENDING
214 int hostapd_allowed_address(struct hostapd_data
*hapd
, const u8
*addr
,
215 const u8
*msg
, size_t len
, u32
*session_timeout
,
216 u32
*acct_interim_interval
, int *vlan_id
)
219 *session_timeout
= 0;
220 if (acct_interim_interval
)
221 *acct_interim_interval
= 0;
225 if (hostapd_maclist_found(hapd
->conf
->accept_mac
,
226 hapd
->conf
->num_accept_mac
, addr
, vlan_id
))
227 return HOSTAPD_ACL_ACCEPT
;
229 if (hostapd_maclist_found(hapd
->conf
->deny_mac
,
230 hapd
->conf
->num_deny_mac
, addr
, vlan_id
))
231 return HOSTAPD_ACL_REJECT
;
233 if (hapd
->conf
->macaddr_acl
== ACCEPT_UNLESS_DENIED
)
234 return HOSTAPD_ACL_ACCEPT
;
235 if (hapd
->conf
->macaddr_acl
== DENY_UNLESS_ACCEPTED
)
236 return HOSTAPD_ACL_REJECT
;
238 if (hapd
->conf
->macaddr_acl
== USE_EXTERNAL_RADIUS_AUTH
) {
239 #ifdef CONFIG_NO_RADIUS
240 return HOSTAPD_ACL_REJECT
;
241 #else /* CONFIG_NO_RADIUS */
242 struct hostapd_acl_query_data
*query
;
244 /* Check whether ACL cache has an entry for this station */
245 int res
= hostapd_acl_cache_get(hapd
, addr
, session_timeout
,
246 acct_interim_interval
,
248 if (res
== HOSTAPD_ACL_ACCEPT
||
249 res
== HOSTAPD_ACL_ACCEPT_TIMEOUT
)
251 if (res
== HOSTAPD_ACL_REJECT
)
252 return HOSTAPD_ACL_REJECT
;
254 query
= hapd
->acl_queries
;
256 if (os_memcmp(query
->addr
, addr
, ETH_ALEN
) == 0) {
257 /* pending query in RADIUS retransmit queue;
258 * do not generate a new one */
259 return HOSTAPD_ACL_PENDING
;
264 if (!hapd
->conf
->radius
->auth_server
)
265 return HOSTAPD_ACL_REJECT
;
267 /* No entry in the cache - query external RADIUS server */
268 query
= os_zalloc(sizeof(*query
));
270 wpa_printf(MSG_ERROR
, "malloc for query data failed");
271 return HOSTAPD_ACL_REJECT
;
273 time(&query
->timestamp
);
274 os_memcpy(query
->addr
, addr
, ETH_ALEN
);
275 if (hostapd_radius_acl_query(hapd
, addr
, query
)) {
276 wpa_printf(MSG_DEBUG
, "Failed to send Access-Request "
278 hostapd_acl_query_free(query
);
279 return HOSTAPD_ACL_REJECT
;
282 query
->auth_msg
= os_malloc(len
);
283 if (query
->auth_msg
== NULL
) {
284 wpa_printf(MSG_ERROR
, "Failed to allocate memory for "
286 hostapd_acl_query_free(query
);
287 return HOSTAPD_ACL_REJECT
;
289 os_memcpy(query
->auth_msg
, msg
, len
);
290 query
->auth_msg_len
= len
;
291 query
->next
= hapd
->acl_queries
;
292 hapd
->acl_queries
= query
;
294 /* Queued data will be processed in hostapd_acl_recv_radius()
295 * when RADIUS server replies to the sent Access-Request. */
296 return HOSTAPD_ACL_PENDING
;
297 #endif /* CONFIG_NO_RADIUS */
300 return HOSTAPD_ACL_REJECT
;
304 #ifndef CONFIG_NO_RADIUS
305 static void hostapd_acl_expire_cache(struct hostapd_data
*hapd
, time_t now
)
307 struct hostapd_cached_radius_acl
*prev
, *entry
, *tmp
;
310 entry
= hapd
->acl_cache
;
313 if (now
- entry
->timestamp
> RADIUS_ACL_TIMEOUT
) {
314 wpa_printf(MSG_DEBUG
, "Cached ACL entry for " MACSTR
315 " has expired.", MAC2STR(entry
->addr
));
317 prev
->next
= entry
->next
;
319 hapd
->acl_cache
= entry
->next
;
320 #ifdef CONFIG_DRIVER_RADIUS_ACL
321 hapd
->drv
.set_radius_acl_expire(hapd
, entry
->addr
);
322 #endif /* CONFIG_DRIVER_RADIUS_ACL */
335 static void hostapd_acl_expire_queries(struct hostapd_data
*hapd
, time_t now
)
337 struct hostapd_acl_query_data
*prev
, *entry
, *tmp
;
340 entry
= hapd
->acl_queries
;
343 if (now
- entry
->timestamp
> RADIUS_ACL_TIMEOUT
) {
344 wpa_printf(MSG_DEBUG
, "ACL query for " MACSTR
345 " has expired.", MAC2STR(entry
->addr
));
347 prev
->next
= entry
->next
;
349 hapd
->acl_queries
= entry
->next
;
353 hostapd_acl_query_free(tmp
);
364 * hostapd_acl_expire - ACL cache expiration callback
365 * @eloop_ctx: struct hostapd_data *
366 * @timeout_ctx: Not used
368 static void hostapd_acl_expire(void *eloop_ctx
, void *timeout_ctx
)
370 struct hostapd_data
*hapd
= eloop_ctx
;
374 hostapd_acl_expire_cache(hapd
, now
);
375 hostapd_acl_expire_queries(hapd
, now
);
377 eloop_register_timeout(10, 0, hostapd_acl_expire
, hapd
, NULL
);
382 * hostapd_acl_recv_radius - Process incoming RADIUS Authentication messages
383 * @msg: RADIUS response message
384 * @req: RADIUS request message
385 * @shared_secret: RADIUS shared secret
386 * @shared_secret_len: Length of shared_secret in octets
387 * @data: Context data (struct hostapd_data *)
388 * Returns: RADIUS_RX_PROCESSED if RADIUS message was a reply to ACL query (and
389 * was processed here) or RADIUS_RX_UNKNOWN if not.
391 static RadiusRxResult
392 hostapd_acl_recv_radius(struct radius_msg
*msg
, struct radius_msg
*req
,
393 const u8
*shared_secret
, size_t shared_secret_len
,
396 struct hostapd_data
*hapd
= data
;
397 struct hostapd_acl_query_data
*query
, *prev
;
398 struct hostapd_cached_radius_acl
*cache
;
399 struct radius_hdr
*hdr
= radius_msg_get_hdr(msg
);
401 query
= hapd
->acl_queries
;
404 if (query
->radius_id
== hdr
->identifier
)
410 return RADIUS_RX_UNKNOWN
;
412 wpa_printf(MSG_DEBUG
, "Found matching Access-Request for RADIUS "
413 "message (id=%d)", query
->radius_id
);
415 if (radius_msg_verify(msg
, shared_secret
, shared_secret_len
, req
, 0)) {
416 wpa_printf(MSG_INFO
, "Incoming RADIUS packet did not have "
417 "correct authenticator - dropped\n");
418 return RADIUS_RX_INVALID_AUTHENTICATOR
;
421 if (hdr
->code
!= RADIUS_CODE_ACCESS_ACCEPT
&&
422 hdr
->code
!= RADIUS_CODE_ACCESS_REJECT
) {
423 wpa_printf(MSG_DEBUG
, "Unknown RADIUS message code %d to ACL "
425 return RADIUS_RX_UNKNOWN
;
428 /* Insert Accept/Reject info into ACL cache */
429 cache
= os_zalloc(sizeof(*cache
));
431 wpa_printf(MSG_DEBUG
, "Failed to add ACL cache entry");
434 time(&cache
->timestamp
);
435 os_memcpy(cache
->addr
, query
->addr
, sizeof(cache
->addr
));
436 if (hdr
->code
== RADIUS_CODE_ACCESS_ACCEPT
) {
437 if (radius_msg_get_attr_int32(msg
, RADIUS_ATTR_SESSION_TIMEOUT
,
438 &cache
->session_timeout
) == 0)
439 cache
->accepted
= HOSTAPD_ACL_ACCEPT_TIMEOUT
;
441 cache
->accepted
= HOSTAPD_ACL_ACCEPT
;
443 if (radius_msg_get_attr_int32(
444 msg
, RADIUS_ATTR_ACCT_INTERIM_INTERVAL
,
445 &cache
->acct_interim_interval
) == 0 &&
446 cache
->acct_interim_interval
< 60) {
447 wpa_printf(MSG_DEBUG
, "Ignored too small "
448 "Acct-Interim-Interval %d for STA " MACSTR
,
449 cache
->acct_interim_interval
,
450 MAC2STR(query
->addr
));
451 cache
->acct_interim_interval
= 0;
454 cache
->vlan_id
= radius_msg_get_vlanid(msg
);
456 cache
->accepted
= HOSTAPD_ACL_REJECT
;
457 cache
->next
= hapd
->acl_cache
;
458 hapd
->acl_cache
= cache
;
460 #ifdef CONFIG_DRIVER_RADIUS_ACL
461 hapd
->drv
.set_radius_acl_auth(hapd
, query
->addr
, cache
->accepted
,
462 cache
->session_timeout
);
463 #else /* CONFIG_DRIVER_RADIUS_ACL */
465 /* Re-send original authentication frame for 802.11 processing */
466 wpa_printf(MSG_DEBUG
, "Re-sending authentication frame after "
467 "successful RADIUS ACL query");
468 ieee802_11_mgmt(hapd
, query
->auth_msg
, query
->auth_msg_len
, NULL
);
469 #endif /* NEED_AP_MLME */
470 #endif /* CONFIG_DRIVER_RADIUS_ACL */
474 hapd
->acl_queries
= query
->next
;
476 prev
->next
= query
->next
;
478 hostapd_acl_query_free(query
);
480 return RADIUS_RX_PROCESSED
;
482 #endif /* CONFIG_NO_RADIUS */
486 * hostapd_acl_init: Initialize IEEE 802.11 ACL
487 * @hapd: hostapd BSS data
488 * Returns: 0 on success, -1 on failure
490 int hostapd_acl_init(struct hostapd_data
*hapd
)
492 #ifndef CONFIG_NO_RADIUS
493 if (radius_client_register(hapd
->radius
, RADIUS_AUTH
,
494 hostapd_acl_recv_radius
, hapd
))
497 eloop_register_timeout(10, 0, hostapd_acl_expire
, hapd
, NULL
);
498 #endif /* CONFIG_NO_RADIUS */
505 * hostapd_acl_deinit - Deinitialize IEEE 802.11 ACL
506 * @hapd: hostapd BSS data
508 void hostapd_acl_deinit(struct hostapd_data
*hapd
)
510 struct hostapd_acl_query_data
*query
, *prev
;
512 #ifndef CONFIG_NO_RADIUS
513 eloop_cancel_timeout(hostapd_acl_expire
, hapd
, NULL
);
515 hostapd_acl_cache_free(hapd
->acl_cache
);
516 #endif /* CONFIG_NO_RADIUS */
518 query
= hapd
->acl_queries
;
522 hostapd_acl_query_free(prev
);