1 /*
2  * hostapd - PMKSA cache for IEEE 802.11i RSN
3  * Copyright (c) 2004-2008, 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 
9 #ifndef PMKSA_CACHE_H
10 #define PMKSA_CACHE_H
11 
12 #include "radius/radius.h"
13 
14 /**
15  * struct rsn_pmksa_cache_entry - PMKSA cache entry
16  */
17 struct rsn_pmksa_cache_entry {
18 	struct rsn_pmksa_cache_entry *next, *hnext;
19 	u8 pmkid[PMKID_LEN];
20 	u8 pmk[PMK_LEN_MAX];
21 	size_t pmk_len;
22 	os_time_t expiration;
23 	int akmp; /* WPA_KEY_MGMT_* */
24 	u8 spa[ETH_ALEN];
25 
26 	u8 *identity;
27 	size_t identity_len;
28 	struct wpabuf *cui;
29 	struct radius_class_data radius_class;
30 	u8 eap_type_authsrv;
31 	struct vlan_description *vlan_desc;
32 	int opportunistic;
33 
34 	u64 acct_multi_session_id;
35 };
36 
37 struct rsn_pmksa_cache;
38 struct radius_das_attrs;
39 
40 struct rsn_pmksa_cache *
41 pmksa_cache_auth_init(void (*free_cb)(struct rsn_pmksa_cache_entry *entry,
42 				      void *ctx), void *ctx);
43 void pmksa_cache_auth_deinit(struct rsn_pmksa_cache *pmksa);
44 struct rsn_pmksa_cache_entry *
45 pmksa_cache_auth_get(struct rsn_pmksa_cache *pmksa,
46 		     const u8 *spa, const u8 *pmkid);
47 struct rsn_pmksa_cache_entry * pmksa_cache_get_okc(
48 	struct rsn_pmksa_cache *pmksa, const u8 *spa, const u8 *aa,
49 	const u8 *pmkid);
50 struct rsn_pmksa_cache_entry *
51 pmksa_cache_auth_add(struct rsn_pmksa_cache *pmksa,
52 		     const u8 *pmk, size_t pmk_len, const u8 *pmkid,
53 		     const u8 *kck, size_t kck_len,
54 		     const u8 *aa, const u8 *spa, int session_timeout,
55 		     struct eapol_state_machine *eapol, int akmp);
56 struct rsn_pmksa_cache_entry *
57 pmksa_cache_auth_create_entry(const u8 *pmk, size_t pmk_len, const u8 *pmkid,
58 			      const u8 *kck, size_t kck_len, const u8 *aa,
59 			      const u8 *spa, int session_timeout,
60 			      struct eapol_state_machine *eapol, int akmp);
61 int pmksa_cache_auth_add_entry(struct rsn_pmksa_cache *pmksa,
62 			       struct rsn_pmksa_cache_entry *entry);
63 struct rsn_pmksa_cache_entry *
64 pmksa_cache_add_okc(struct rsn_pmksa_cache *pmksa,
65 		    const struct rsn_pmksa_cache_entry *old_entry,
66 		    const u8 *aa, const u8 *pmkid);
67 void pmksa_cache_to_eapol_data(struct hostapd_data *hapd,
68 			       struct rsn_pmksa_cache_entry *entry,
69 			       struct eapol_state_machine *eapol);
70 void pmksa_cache_free_entry(struct rsn_pmksa_cache *pmksa,
71 			    struct rsn_pmksa_cache_entry *entry);
72 int pmksa_cache_auth_radius_das_disconnect(struct rsn_pmksa_cache *pmksa,
73 					   struct radius_das_attrs *attr);
74 int pmksa_cache_auth_list(struct rsn_pmksa_cache *pmksa, char *buf, size_t len);
75 void pmksa_cache_auth_flush(struct rsn_pmksa_cache *pmksa);
76 int pmksa_cache_auth_list_mesh(struct rsn_pmksa_cache *pmksa, const u8 *addr,
77 			       char *buf, size_t len);
78 
79 #endif /* PMKSA_CACHE_H */
80