1/*
2 * hostapd / IEEE 802.11 authentication (ACL)
3 * Copyright (c) 2003-2012, Jouni Malinen <j@w1.fi>
4 *
5 * This software may be distributed under the terms of the BSD license.
6 * See README for more details.
7 *
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.
12 */
13
14#include "utils/includes.h"
15
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"
21#include "hostapd.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"
27
28#define RADIUS_ACL_TIMEOUT 30
29
30
31struct hostapd_cached_radius_acl {
32 struct os_reltime timestamp;
33 macaddr addr;
34 int accepted; /* HOSTAPD_ACL_* */
35 struct hostapd_cached_radius_acl *next;
36 u32 session_timeout;
37 u32 acct_interim_interval;
38 int vlan_id;
39 struct hostapd_sta_wpa_psk_short *psk;
40 char *identity;
41 char *radius_cui;
42};
43
44
45struct hostapd_acl_query_data {
46 struct os_reltime timestamp;
47 u8 radius_id;
48 macaddr addr;
49 u8 *auth_msg; /* IEEE 802.11 authentication frame from station */
50 size_t auth_msg_len;
51 struct hostapd_acl_query_data *next;
52};
53
54
55#ifndef CONFIG_NO_RADIUS
56static void hostapd_acl_cache_free_entry(struct hostapd_cached_radius_acl *e)
57{
58 os_free(e->identity);
59 os_free(e->radius_cui);
60 hostapd_free_psk_list(e->psk);
61 os_free(e);
62}
63
64
65static void hostapd_acl_cache_free(struct hostapd_cached_radius_acl *acl_cache)
66{
67 struct hostapd_cached_radius_acl *prev;
68
69 while (acl_cache) {
70 prev = acl_cache;
71 acl_cache = acl_cache->next;
72 hostapd_acl_cache_free_entry(prev);
73 }
74}
75
76
77static void copy_psk_list(struct hostapd_sta_wpa_psk_short **psk,
78 struct hostapd_sta_wpa_psk_short *src)
79{
80 struct hostapd_sta_wpa_psk_short **copy_to;
81 struct hostapd_sta_wpa_psk_short *copy_from;
82
83 /* Copy PSK linked list */
84 copy_to = psk;
85 copy_from = src;
86 while (copy_from && copy_to) {
87 *copy_to = os_zalloc(sizeof(struct hostapd_sta_wpa_psk_short));
88 if (*copy_to == NULL)
89 break;
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);
94 }
95 if (copy_to)
96 *copy_to = NULL;
97}
98
99
100static 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)
105{
106 struct hostapd_cached_radius_acl *entry;
107 struct os_reltime now;
108
109 os_get_reltime(&now);
110
111 for (entry = hapd->acl_cache; entry; entry = entry->next) {
112 if (os_memcmp(entry->addr, addr, ETH_ALEN) != 0)
113 continue;
114
115 if (os_reltime_expired(&now, &entry->timestamp,
116 RADIUS_ACL_TIMEOUT))
117 return -1; /* entry has expired */
118 if (entry->accepted == HOSTAPD_ACL_ACCEPT_TIMEOUT)
119 if (session_timeout)
120 *session_timeout = entry->session_timeout;
121 if (acct_interim_interval)
122 *acct_interim_interval =
123 entry->acct_interim_interval;
124 if (vlan_id)
125 *vlan_id = entry->vlan_id;
126 copy_psk_list(psk, entry->psk);
127 if (identity) {
128 if (entry->identity)
129 *identity = os_strdup(entry->identity);
130 else
131 *identity = NULL;
132 }
133 if (radius_cui) {
134 if (entry->radius_cui)
135 *radius_cui = os_strdup(entry->radius_cui);
136 else
137 *radius_cui = NULL;
138 }
139 return entry->accepted;
140 }
141
142 return -1;
143}
144#endif /* CONFIG_NO_RADIUS */
145
146
147static void hostapd_acl_query_free(struct hostapd_acl_query_data *query)
148{
149 if (query == NULL)
150 return;
151 os_free(query->auth_msg);
152 os_free(query);
153}
154
155
156#ifndef CONFIG_NO_RADIUS
157static int hostapd_radius_acl_query(struct hostapd_data *hapd, const u8 *addr,
158 struct hostapd_acl_query_data *query)
159{
160 struct radius_msg *msg;
161 char buf[128];
162
163 query->radius_id = radius_client_get_id(hapd->radius);
164 msg = radius_msg_new(RADIUS_CODE_ACCESS_REQUEST, query->radius_id);
165 if (msg == NULL)
166 return -1;
167
168 radius_msg_make_authenticator(msg, addr, ETH_ALEN);
169
170 os_snprintf(buf, sizeof(buf), RADIUS_ADDR_FORMAT, MAC2STR(addr));
171 if (!radius_msg_add_attr(msg, RADIUS_ATTR_USER_NAME, (u8 *) buf,
172 os_strlen(buf))) {
173 wpa_printf(MSG_DEBUG, "Could not add User-Name");
174 goto fail;
175 }
176
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");
182 goto fail;
183 }
184
185 if (add_common_radius_attr(hapd, hapd->conf->radius_auth_req_attr,
186 NULL, msg) < 0)
187 goto fail;
188
189 os_snprintf(buf, sizeof(buf), RADIUS_802_1X_ADDR_FORMAT,
190 MAC2STR(addr));
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");
194 goto fail;
195 }
196
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");
201 goto fail;
202 }
203
204 if (radius_client_send(hapd->radius, msg, RADIUS_AUTH, addr) < 0)
205 goto fail;
206 return 0;
207
208 fail:
209 radius_msg_free(msg);
210 return -1;
211}
212#endif /* CONFIG_NO_RADIUS */
213
214
215/**
216 * hostapd_allowed_address - Check whether a specified STA can be authenticated
217 * @hapd: hostapd BSS data
218 * @addr: MAC address of the STA
219 * @msg: Authentication message
220 * @len: Length of msg in octets
221 * @session_timeout: Buffer for returning session timeout (from RADIUS)
222 * @acct_interim_interval: Buffer for returning account interval (from RADIUS)
223 * @vlan_id: Buffer for returning VLAN ID
224 * @psk: Linked list buffer for returning WPA PSK
225 * @identity: Buffer for returning identity (from RADIUS)
226 * @radius_cui: Buffer for returning CUI (from RADIUS)
227 * Returns: HOSTAPD_ACL_ACCEPT, HOSTAPD_ACL_REJECT, or HOSTAPD_ACL_PENDING
228 *
229 * The caller is responsible for freeing the returned *identity and *radius_cui
230 * values with os_free().
231 */
232int hostapd_allowed_address(struct hostapd_data *hapd, const u8 *addr,
233 const u8 *msg, size_t len, u32 *session_timeout,
234 u32 *acct_interim_interval, int *vlan_id,
235 struct hostapd_sta_wpa_psk_short **psk,
236 char **identity, char **radius_cui)
237{
238 if (session_timeout)
239 *session_timeout = 0;
240 if (acct_interim_interval)
241 *acct_interim_interval = 0;
242 if (vlan_id)
243 *vlan_id = 0;
244 if (psk)
245 *psk = NULL;
246 if (identity)
247 *identity = NULL;
248 if (radius_cui)
249 *radius_cui = NULL;
250
251 if (hostapd_maclist_found(hapd->conf->accept_mac,
252 hapd->conf->num_accept_mac, addr, vlan_id))
253 return HOSTAPD_ACL_ACCEPT;
254
255 if (hostapd_maclist_found(hapd->conf->deny_mac,
256 hapd->conf->num_deny_mac, addr, vlan_id))
257 return HOSTAPD_ACL_REJECT;
258
259 if (hapd->conf->macaddr_acl == ACCEPT_UNLESS_DENIED)
260 return HOSTAPD_ACL_ACCEPT;
261 if (hapd->conf->macaddr_acl == DENY_UNLESS_ACCEPTED)
262 return HOSTAPD_ACL_REJECT;
263
264 if (hapd->conf->macaddr_acl == USE_EXTERNAL_RADIUS_AUTH) {
265#ifdef CONFIG_NO_RADIUS
266 return HOSTAPD_ACL_REJECT;
267#else /* CONFIG_NO_RADIUS */
268 struct hostapd_acl_query_data *query;
269
270 /* Check whether ACL cache has an entry for this station */
271 int res = hostapd_acl_cache_get(hapd, addr, session_timeout,
272 acct_interim_interval,
273 vlan_id, psk,
274 identity, radius_cui);
275 if (res == HOSTAPD_ACL_ACCEPT ||
276 res == HOSTAPD_ACL_ACCEPT_TIMEOUT)
277 return res;
278 if (res == HOSTAPD_ACL_REJECT)
279 return HOSTAPD_ACL_REJECT;
280
281 query = hapd->acl_queries;
282 while (query) {
283 if (os_memcmp(query->addr, addr, ETH_ALEN) == 0) {
284 /* pending query in RADIUS retransmit queue;
285 * do not generate a new one */
286 if (identity) {
287 os_free(*identity);
288 *identity = NULL;
289 }
290 if (radius_cui) {
291 os_free(*radius_cui);
292 *radius_cui = NULL;
293 }
294 return HOSTAPD_ACL_PENDING;
295 }
296 query = query->next;
297 }
298
299 if (!hapd->conf->radius->auth_server)
300 return HOSTAPD_ACL_REJECT;
301
302 /* No entry in the cache - query external RADIUS server */
303 query = os_zalloc(sizeof(*query));
304 if (query == NULL) {
305 wpa_printf(MSG_ERROR, "malloc for query data failed");
306 return HOSTAPD_ACL_REJECT;
307 }
308 os_get_reltime(&query->timestamp);
309 os_memcpy(query->addr, addr, ETH_ALEN);
310 if (hostapd_radius_acl_query(hapd, addr, query)) {
311 wpa_printf(MSG_DEBUG, "Failed to send Access-Request "
312 "for ACL query.");
313 hostapd_acl_query_free(query);
314 return HOSTAPD_ACL_REJECT;
315 }
316
317 query->auth_msg = os_malloc(len);
318 if (query->auth_msg == NULL) {
319 wpa_printf(MSG_ERROR, "Failed to allocate memory for "
320 "auth frame.");
321 hostapd_acl_query_free(query);
322 return HOSTAPD_ACL_REJECT;
323 }
324 os_memcpy(query->auth_msg, msg, len);
325 query->auth_msg_len = len;
326 query->next = hapd->acl_queries;
327 hapd->acl_queries = query;
328
329 /* Queued data will be processed in hostapd_acl_recv_radius()
330 * when RADIUS server replies to the sent Access-Request. */
331 return HOSTAPD_ACL_PENDING;
332#endif /* CONFIG_NO_RADIUS */
333 }
334
335 return HOSTAPD_ACL_REJECT;
336}
337
338
339#ifndef CONFIG_NO_RADIUS
340static void hostapd_acl_expire_cache(struct hostapd_data *hapd,
341 struct os_reltime *now)
342{
343 struct hostapd_cached_radius_acl *prev, *entry, *tmp;
344
345 prev = NULL;
346 entry = hapd->acl_cache;
347
348 while (entry) {
349 if (os_reltime_expired(now, &entry->timestamp,
350 RADIUS_ACL_TIMEOUT)) {
351 wpa_printf(MSG_DEBUG, "Cached ACL entry for " MACSTR
352 " has expired.", MAC2STR(entry->addr));
353 if (prev)
354 prev->next = entry->next;
355 else
356 hapd->acl_cache = entry->next;
357 hostapd_drv_set_radius_acl_expire(hapd, entry->addr);
358 tmp = entry;
359 entry = entry->next;
360 hostapd_acl_cache_free_entry(tmp);
361 continue;
362 }
363
364 prev = entry;
365 entry = entry->next;
366 }
367}
368
369
370static void hostapd_acl_expire_queries(struct hostapd_data *hapd,
371 struct os_reltime *now)
372{
373 struct hostapd_acl_query_data *prev, *entry, *tmp;
374
375 prev = NULL;
376 entry = hapd->acl_queries;
377
378 while (entry) {
379 if (os_reltime_expired(now, &entry->timestamp,
380 RADIUS_ACL_TIMEOUT)) {
381 wpa_printf(MSG_DEBUG, "ACL query for " MACSTR
382 " has expired.", MAC2STR(entry->addr));
383 if (prev)
384 prev->next = entry->next;
385 else
386 hapd->acl_queries = entry->next;
387
388 tmp = entry;
389 entry = entry->next;
390 hostapd_acl_query_free(tmp);
391 continue;
392 }
393
394 prev = entry;
395 entry = entry->next;
396 }
397}
398
399
400/**
401 * hostapd_acl_expire - ACL cache expiration callback
402 * @hapd: struct hostapd_data *
403 */
404void hostapd_acl_expire(struct hostapd_data *hapd)
405{
406 struct os_reltime now;
407
408 os_get_reltime(&now);
409 hostapd_acl_expire_cache(hapd, &now);
410 hostapd_acl_expire_queries(hapd, &now);
411}
412
413
414static void decode_tunnel_passwords(struct hostapd_data *hapd,
415 const u8 *shared_secret,
416 size_t shared_secret_len,
417 struct radius_msg *msg,
418 struct radius_msg *req,
419 struct hostapd_cached_radius_acl *cache)
420{
421 int passphraselen;
422 char *passphrase, *strpassphrase;
423 size_t i;
424 struct hostapd_sta_wpa_psk_short *psk;
425
426 /*
427 * Decode all tunnel passwords as PSK and save them into a linked list.
428 */
429 for (i = 0; ; i++) {
430 passphrase = radius_msg_get_tunnel_password(
431 msg, &passphraselen, shared_secret, shared_secret_len,
432 req, i);
433 /*
434 * Passphrase is NULL iff there is no i-th Tunnel-Password
435 * attribute in msg.
436 */
437 if (passphrase == NULL)
438 break;
439 /*
440 * passphrase does not contain the NULL termination.
441 * Add it here as pbkdf2_sha1() requires it.
442 */
443 strpassphrase = os_zalloc(passphraselen + 1);
444 psk = os_zalloc(sizeof(struct hostapd_sta_wpa_psk_short));
445 if (strpassphrase && psk) {
446 os_memcpy(strpassphrase, passphrase, passphraselen);
447 pbkdf2_sha1(strpassphrase,
448 hapd->conf->ssid.ssid,
449 hapd->conf->ssid.ssid_len, 4096,
450 psk->psk, PMK_LEN);
451 psk->next = cache->psk;
452 cache->psk = psk;
453 psk = NULL;
454 }
455 os_free(strpassphrase);
456 os_free(psk);
457 os_free(passphrase);
458 }
459}
460
461
462/**
463 * hostapd_acl_recv_radius - Process incoming RADIUS Authentication messages
464 * @msg: RADIUS response message
465 * @req: RADIUS request message
466 * @shared_secret: RADIUS shared secret
467 * @shared_secret_len: Length of shared_secret in octets
468 * @data: Context data (struct hostapd_data *)
469 * Returns: RADIUS_RX_PROCESSED if RADIUS message was a reply to ACL query (and
470 * was processed here) or RADIUS_RX_UNKNOWN if not.
471 */
472static RadiusRxResult
473hostapd_acl_recv_radius(struct radius_msg *msg, struct radius_msg *req,
474 const u8 *shared_secret, size_t shared_secret_len,
475 void *data)
476{
477 struct hostapd_data *hapd = data;
478 struct hostapd_acl_query_data *query, *prev;
479 struct hostapd_cached_radius_acl *cache;
480 struct radius_hdr *hdr = radius_msg_get_hdr(msg);
481
482 query = hapd->acl_queries;
483 prev = NULL;
484 while (query) {
485 if (query->radius_id == hdr->identifier)
486 break;
487 prev = query;
488 query = query->next;
489 }
490 if (query == NULL)
491 return RADIUS_RX_UNKNOWN;
492
493 wpa_printf(MSG_DEBUG, "Found matching Access-Request for RADIUS "
494 "message (id=%d)", query->radius_id);
495
496 if (radius_msg_verify(msg, shared_secret, shared_secret_len, req, 0)) {
497 wpa_printf(MSG_INFO, "Incoming RADIUS packet did not have "
498 "correct authenticator - dropped\n");
499 return RADIUS_RX_INVALID_AUTHENTICATOR;
500 }
501
502 if (hdr->code != RADIUS_CODE_ACCESS_ACCEPT &&
503 hdr->code != RADIUS_CODE_ACCESS_REJECT) {
504 wpa_printf(MSG_DEBUG, "Unknown RADIUS message code %d to ACL "
505 "query", hdr->code);
506 return RADIUS_RX_UNKNOWN;
507 }
508
509 /* Insert Accept/Reject info into ACL cache */
510 cache = os_zalloc(sizeof(*cache));
511 if (cache == NULL) {
512 wpa_printf(MSG_DEBUG, "Failed to add ACL cache entry");
513 goto done;
514 }
515 os_get_reltime(&cache->timestamp);
516 os_memcpy(cache->addr, query->addr, sizeof(cache->addr));
517 if (hdr->code == RADIUS_CODE_ACCESS_ACCEPT) {
518 u8 *buf;
519 size_t len;
520
521 if (radius_msg_get_attr_int32(msg, RADIUS_ATTR_SESSION_TIMEOUT,
522 &cache->session_timeout) == 0)
523 cache->accepted = HOSTAPD_ACL_ACCEPT_TIMEOUT;
524 else
525 cache->accepted = HOSTAPD_ACL_ACCEPT;
526
527 if (radius_msg_get_attr_int32(
528 msg, RADIUS_ATTR_ACCT_INTERIM_INTERVAL,
529 &cache->acct_interim_interval) == 0 &&
530 cache->acct_interim_interval < 60) {
531 wpa_printf(MSG_DEBUG, "Ignored too small "
532 "Acct-Interim-Interval %d for STA " MACSTR,
533 cache->acct_interim_interval,
534 MAC2STR(query->addr));
535 cache->acct_interim_interval = 0;
536 }
537
538 cache->vlan_id = radius_msg_get_vlanid(msg);
539
540 decode_tunnel_passwords(hapd, shared_secret, shared_secret_len,
541 msg, req, cache);
542
543 if (radius_msg_get_attr_ptr(msg, RADIUS_ATTR_USER_NAME,
544 &buf, &len, NULL) == 0) {
545 cache->identity = os_zalloc(len + 1);
546 if (cache->identity)
547 os_memcpy(cache->identity, buf, len);
548 }
549 if (radius_msg_get_attr_ptr(
550 msg, RADIUS_ATTR_CHARGEABLE_USER_IDENTITY,
551 &buf, &len, NULL) == 0) {
552 cache->radius_cui = os_zalloc(len + 1);
553 if (cache->radius_cui)
554 os_memcpy(cache->radius_cui, buf, len);
555 }
556
557 if (hapd->conf->wpa_psk_radius == PSK_RADIUS_REQUIRED &&
558 !cache->psk)
559 cache->accepted = HOSTAPD_ACL_REJECT;
560
561 if (cache->vlan_id &&
562 !hostapd_vlan_id_valid(hapd->conf->vlan, cache->vlan_id)) {
563 hostapd_logger(hapd, query->addr,
564 HOSTAPD_MODULE_RADIUS,
565 HOSTAPD_LEVEL_INFO,
566 "Invalid VLAN ID %d received from RADIUS server",
567 cache->vlan_id);
568 cache->vlan_id = 0;
569 }
570 if (hapd->conf->ssid.dynamic_vlan == DYNAMIC_VLAN_REQUIRED &&
571 !cache->vlan_id)
572 cache->accepted = HOSTAPD_ACL_REJECT;
573 } else
574 cache->accepted = HOSTAPD_ACL_REJECT;
575 cache->next = hapd->acl_cache;
576 hapd->acl_cache = cache;
577
578#ifdef CONFIG_DRIVER_RADIUS_ACL
579 hostapd_drv_set_radius_acl_auth(hapd, query->addr, cache->accepted,
580 cache->session_timeout);
581#else /* CONFIG_DRIVER_RADIUS_ACL */
582#ifdef NEED_AP_MLME
583 /* Re-send original authentication frame for 802.11 processing */
584 wpa_printf(MSG_DEBUG, "Re-sending authentication frame after "
585 "successful RADIUS ACL query");
586 ieee802_11_mgmt(hapd, query->auth_msg, query->auth_msg_len, NULL);
587#endif /* NEED_AP_MLME */
588#endif /* CONFIG_DRIVER_RADIUS_ACL */
589
590 done:
591 if (prev == NULL)
592 hapd->acl_queries = query->next;
593 else
594 prev->next = query->next;
595
596 hostapd_acl_query_free(query);
597
598 return RADIUS_RX_PROCESSED;
599}
600#endif /* CONFIG_NO_RADIUS */
601
602
603/**
604 * hostapd_acl_init: Initialize IEEE 802.11 ACL
605 * @hapd: hostapd BSS data
606 * Returns: 0 on success, -1 on failure
607 */
608int hostapd_acl_init(struct hostapd_data *hapd)
609{
610#ifndef CONFIG_NO_RADIUS
611 if (radius_client_register(hapd->radius, RADIUS_AUTH,
612 hostapd_acl_recv_radius, hapd))
613 return -1;
614#endif /* CONFIG_NO_RADIUS */
615
616 return 0;
617}
618
619
620/**
621 * hostapd_acl_deinit - Deinitialize IEEE 802.11 ACL
622 * @hapd: hostapd BSS data
623 */
624void hostapd_acl_deinit(struct hostapd_data *hapd)
625{
626 struct hostapd_acl_query_data *query, *prev;
627
628#ifndef CONFIG_NO_RADIUS
629 hostapd_acl_cache_free(hapd->acl_cache);
630#endif /* CONFIG_NO_RADIUS */
631
632 query = hapd->acl_queries;
633 while (query) {
634 prev = query;
635 query = query->next;
636 hostapd_acl_query_free(prev);
637 }
638}
639
640
641void hostapd_free_psk_list(struct hostapd_sta_wpa_psk_short *psk)
642{
643 while (psk) {
644 struct hostapd_sta_wpa_psk_short *prev = psk;
645 psk = psk->next;
646 os_free(prev);
647 }
648}