xref: /freebsd/contrib/wpa/src/ap/pmksa_cache_auth.h (revision db33c6f3ae9d1231087710068ee4ea5398aacca7)
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 	u8 kck[WPA_KCK_MAX_LEN];
23 	size_t kck_len;
24 	os_time_t expiration;
25 	int akmp; /* WPA_KEY_MGMT_* */
26 	u8 spa[ETH_ALEN];
27 
28 	u8 *dpp_pkhash; /* SHA256_MAC_LEN octet hash value of DPP Connector
29 			 * public key */
30 	u8 *identity;
31 	size_t identity_len;
32 	struct wpabuf *cui;
33 	struct radius_class_data radius_class;
34 	u8 eap_type_authsrv;
35 	struct vlan_description *vlan_desc;
36 	int opportunistic;
37 
38 	u64 acct_multi_session_id;
39 };
40 
41 struct rsn_pmksa_cache;
42 struct radius_das_attrs;
43 
44 struct rsn_pmksa_cache *
45 pmksa_cache_auth_init(void (*free_cb)(struct rsn_pmksa_cache_entry *entry,
46 				      void *ctx), void *ctx);
47 void pmksa_cache_auth_deinit(struct rsn_pmksa_cache *pmksa);
48 struct rsn_pmksa_cache_entry *
49 pmksa_cache_auth_get(struct rsn_pmksa_cache *pmksa,
50 		     const u8 *spa, const u8 *pmkid);
51 struct rsn_pmksa_cache_entry * pmksa_cache_get_okc(
52 	struct rsn_pmksa_cache *pmksa, const u8 *spa, const u8 *aa,
53 	const u8 *pmkid);
54 struct rsn_pmksa_cache_entry *
55 pmksa_cache_auth_add(struct rsn_pmksa_cache *pmksa,
56 		     const u8 *pmk, size_t pmk_len, const u8 *pmkid,
57 		     const u8 *kck, size_t kck_len,
58 		     const u8 *aa, const u8 *spa, int session_timeout,
59 		     struct eapol_state_machine *eapol, int akmp);
60 struct rsn_pmksa_cache_entry *
61 pmksa_cache_auth_create_entry(const u8 *pmk, size_t pmk_len, const u8 *pmkid,
62 			      const u8 *kck, size_t kck_len, const u8 *aa,
63 			      const u8 *spa, int session_timeout,
64 			      struct eapol_state_machine *eapol, int akmp);
65 int pmksa_cache_auth_add_entry(struct rsn_pmksa_cache *pmksa,
66 			       struct rsn_pmksa_cache_entry *entry);
67 struct rsn_pmksa_cache_entry *
68 pmksa_cache_add_okc(struct rsn_pmksa_cache *pmksa,
69 		    const struct rsn_pmksa_cache_entry *old_entry,
70 		    const u8 *aa, const u8 *pmkid);
71 void pmksa_cache_to_eapol_data(struct hostapd_data *hapd,
72 			       struct rsn_pmksa_cache_entry *entry,
73 			       struct eapol_state_machine *eapol);
74 void pmksa_cache_free_entry(struct rsn_pmksa_cache *pmksa,
75 			    struct rsn_pmksa_cache_entry *entry);
76 int pmksa_cache_auth_radius_das_disconnect(struct rsn_pmksa_cache *pmksa,
77 					   struct radius_das_attrs *attr);
78 int pmksa_cache_auth_list(struct rsn_pmksa_cache *pmksa, char *buf, size_t len);
79 void pmksa_cache_auth_flush(struct rsn_pmksa_cache *pmksa);
80 int pmksa_cache_auth_list_mesh(struct rsn_pmksa_cache *pmksa, const u8 *addr,
81 			       char *buf, size_t len);
82 
83 #endif /* PMKSA_CACHE_H */
84