blob: e66eb6cfd6754265b8b445abe4eccc585d7c0694 [file] [log] [blame]
Hai Shalom4fbc08f2020-05-18 12:37:00 -07001/*
2 * DPP module internal definitions
3 * Copyright (c) 2017, Qualcomm Atheros, Inc.
4 * Copyright (c) 2018-2020, The Linux Foundation
5 *
6 * This software may be distributed under the terms of the BSD license.
7 * See README for more details.
8 */
9
10#ifndef DPP_I_H
11#define DPP_I_H
12
13#ifdef CONFIG_DPP
14
15struct dpp_global {
16 void *msg_ctx;
17 struct dl_list bootstrap; /* struct dpp_bootstrap_info */
18 struct dl_list configurator; /* struct dpp_configurator */
19#ifdef CONFIG_DPP2
20 struct dl_list controllers; /* struct dpp_relay_controller */
21 struct dpp_controller *controller;
22 struct dl_list tcp_init; /* struct dpp_connection */
23 void *cb_ctx;
24 int (*process_conf_obj)(void *ctx, struct dpp_authentication *auth);
25 void (*remove_bi)(void *ctx, struct dpp_bootstrap_info *bi);
26#endif /* CONFIG_DPP2 */
27};
28
29/* dpp.c */
30
31void dpp_build_attr_status(struct wpabuf *msg, enum dpp_status_error status);
32void dpp_build_attr_r_bootstrap_key_hash(struct wpabuf *msg, const u8 *hash);
33unsigned int dpp_next_id(struct dpp_global *dpp);
34struct wpabuf * dpp_build_conn_status(enum dpp_status_error result,
35 const u8 *ssid, size_t ssid_len,
36 const char *channel_list);
37struct json_token * dpp_parse_own_connector(const char *own_connector);
38int dpp_connector_match_groups(struct json_token *own_root,
39 struct json_token *peer_root, bool reconfig);
40int dpp_build_jwk(struct wpabuf *buf, const char *name, EVP_PKEY *key,
41 const char *kid, const struct dpp_curve_params *curve);
42EVP_PKEY * dpp_parse_jwk(struct json_token *jwk,
43 const struct dpp_curve_params **key_curve);
44int dpp_prepare_channel_list(struct dpp_authentication *auth,
45 unsigned int neg_freq,
46 struct hostapd_hw_modes *own_modes, u16 num_modes);
47void dpp_auth_fail(struct dpp_authentication *auth, const char *txt);
48int dpp_gen_uri(struct dpp_bootstrap_info *bi);
49void dpp_write_adv_proto(struct wpabuf *buf);
50void dpp_write_gas_query(struct wpabuf *buf, struct wpabuf *query);
51
52/* dpp_backup.c */
53
54void dpp_free_asymmetric_key(struct dpp_asymmetric_key *key);
55struct wpabuf * dpp_build_enveloped_data(struct dpp_authentication *auth);
56int dpp_conf_resp_env_data(struct dpp_authentication *auth,
57 const u8 *env_data, size_t env_data_len);
58
59/* dpp_crypto.c */
60
61struct dpp_signed_connector_info {
62 unsigned char *payload;
63 size_t payload_len;
64};
65
66enum dpp_status_error
67dpp_process_signed_connector(struct dpp_signed_connector_info *info,
68 EVP_PKEY *csign_pub, const char *connector);
69enum dpp_status_error
70dpp_check_signed_connector(struct dpp_signed_connector_info *info,
71 const u8 *csign_key, size_t csign_key_len,
72 const u8 *peer_connector, size_t peer_connector_len);
73const struct dpp_curve_params * dpp_get_curve_name(const char *name);
74const struct dpp_curve_params * dpp_get_curve_jwk_crv(const char *name);
75const struct dpp_curve_params * dpp_get_curve_nid(int nid);
76int dpp_bi_pubkey_hash(struct dpp_bootstrap_info *bi,
77 const u8 *data, size_t data_len);
78struct wpabuf * dpp_get_pubkey_point(EVP_PKEY *pkey, int prefix);
79EVP_PKEY * dpp_set_pubkey_point_group(const EC_GROUP *group,
80 const u8 *buf_x, const u8 *buf_y,
81 size_t len);
82EVP_PKEY * dpp_set_pubkey_point(EVP_PKEY *group_key, const u8 *buf, size_t len);
83int dpp_bn2bin_pad(const BIGNUM *bn, u8 *pos, size_t len);
84int dpp_hkdf_expand(size_t hash_len, const u8 *secret, size_t secret_len,
85 const char *label, u8 *out, size_t outlen);
86int dpp_hmac_vector(size_t hash_len, const u8 *key, size_t key_len,
87 size_t num_elem, const u8 *addr[], const size_t *len,
88 u8 *mac);
89int dpp_ecdh(EVP_PKEY *own, EVP_PKEY *peer, u8 *secret, size_t *secret_len);
90void dpp_debug_print_point(const char *title, const EC_GROUP *group,
91 const EC_POINT *point);
92void dpp_debug_print_key(const char *title, EVP_PKEY *key);
93int dpp_pbkdf2(size_t hash_len, const u8 *password, size_t password_len,
94 const u8 *salt, size_t salt_len, unsigned int iterations,
95 u8 *buf, size_t buflen);
96int dpp_get_subject_public_key(struct dpp_bootstrap_info *bi,
97 const u8 *data, size_t data_len);
98int dpp_bootstrap_key_hash(struct dpp_bootstrap_info *bi);
99int dpp_keygen(struct dpp_bootstrap_info *bi, const char *curve,
100 const u8 *privkey, size_t privkey_len);
101EVP_PKEY * dpp_set_keypair(const struct dpp_curve_params **curve,
102 const u8 *privkey, size_t privkey_len);
103EVP_PKEY * dpp_gen_keypair(const struct dpp_curve_params *curve);
104int dpp_derive_k1(const u8 *Mx, size_t Mx_len, u8 *k1, unsigned int hash_len);
105int dpp_derive_k2(const u8 *Nx, size_t Nx_len, u8 *k2, unsigned int hash_len);
106int dpp_derive_bk_ke(struct dpp_authentication *auth);
107int dpp_gen_r_auth(struct dpp_authentication *auth, u8 *r_auth);
108int dpp_gen_i_auth(struct dpp_authentication *auth, u8 *i_auth);
109int dpp_auth_derive_l_responder(struct dpp_authentication *auth);
110int dpp_auth_derive_l_initiator(struct dpp_authentication *auth);
111int dpp_derive_pmk(const u8 *Nx, size_t Nx_len, u8 *pmk, unsigned int hash_len);
112int dpp_derive_pmkid(const struct dpp_curve_params *curve,
113 EVP_PKEY *own_key, EVP_PKEY *peer_key, u8 *pmkid);
114EC_POINT * dpp_pkex_derive_Qi(const struct dpp_curve_params *curve,
115 const u8 *mac_init, const char *code,
116 const char *identifier, BN_CTX *bnctx,
117 EC_GROUP **ret_group);
118EC_POINT * dpp_pkex_derive_Qr(const struct dpp_curve_params *curve,
119 const u8 *mac_resp, const char *code,
120 const char *identifier, BN_CTX *bnctx,
121 EC_GROUP **ret_group);
122int dpp_pkex_derive_z(const u8 *mac_init, const u8 *mac_resp,
123 const u8 *Mx, size_t Mx_len,
124 const u8 *Nx, size_t Nx_len,
125 const char *code,
126 const u8 *Kx, size_t Kx_len,
127 u8 *z, unsigned int hash_len);
128int dpp_reconfig_derive_ke_responder(struct dpp_authentication *auth,
129 const u8 *net_access_key,
130 size_t net_access_key_len,
131 struct json_token *peer_net_access_key);
132int dpp_reconfig_derive_ke_initiator(struct dpp_authentication *auth,
133 const u8 *r_proto, u16 r_proto_len,
134 struct json_token *net_access_key);
135char * dpp_sign_connector(struct dpp_configurator *conf,
136 const struct wpabuf *dppcon);
137int dpp_test_gen_invalid_key(struct wpabuf *msg,
138 const struct dpp_curve_params *curve);
139
140/* dpp_tcp.c */
141
142void dpp_controller_conn_status_result_wait_timeout(void *eloop_ctx,
143 void *timeout_ctx);
144void dpp_tcp_init_flush(struct dpp_global *dpp);
145void dpp_relay_flush_controllers(struct dpp_global *dpp);
146
147#endif /* CONFIG_DPP */
148#endif /* DPP_I_H */