[thirdparty/hostap.git] / src / common / dpp.h

/*
 * DPP functionality shared between hostapd and wpa_supplicant
 * Copyright (c) 2017, Qualcomm Atheros, Inc.
 *
 * This software may be distributed under the terms of the BSD license.
 * See README for more details.
 */

#ifndef DPP_H
#define DPP_H

#include <openssl/x509.h>

#include "utils/list.h"
#include "common/wpa_common.h"
#include "crypto/sha256.h"

#define DPP_HDR_LEN (4 + 2) /* OUI, OUI Type, Crypto Suite, DPP frame type */

enum dpp_public_action_frame_type {
	DPP_PA_AUTHENTICATION_REQ = 0,
	DPP_PA_AUTHENTICATION_RESP = 1,
	DPP_PA_AUTHENTICATION_CONF = 2,
	DPP_PA_PEER_DISCOVERY_REQ = 5,
	DPP_PA_PEER_DISCOVERY_RESP = 6,
	DPP_PA_PKEX_EXCHANGE_REQ = 7,
	DPP_PA_PKEX_EXCHANGE_RESP = 8,
	DPP_PA_PKEX_COMMIT_REVEAL_REQ = 9,
	DPP_PA_PKEX_COMMIT_REVEAL_RESP = 10,
};

enum dpp_attribute_id {
	DPP_ATTR_STATUS = 0x1000,
	DPP_ATTR_I_BOOTSTRAP_KEY_HASH = 0x1001,
	DPP_ATTR_R_BOOTSTRAP_KEY_HASH = 0x1002,
	DPP_ATTR_I_PROTOCOL_KEY = 0x1003,
	DPP_ATTR_WRAPPED_DATA = 0x1004,
	DPP_ATTR_I_NONCE = 0x1005,
	DPP_ATTR_I_CAPABILITIES = 0x1006,
	DPP_ATTR_R_NONCE = 0x1007,
	DPP_ATTR_R_CAPABILITIES = 0x1008,
	DPP_ATTR_R_PROTOCOL_KEY = 0x1009,
	DPP_ATTR_I_AUTH_TAG = 0x100A,
	DPP_ATTR_R_AUTH_TAG = 0x100B,
	DPP_ATTR_CONFIG_OBJ = 0x100C,
	DPP_ATTR_CONNECTOR = 0x100D,
	DPP_ATTR_CONFIG_ATTR_OBJ = 0x100E,
	DPP_ATTR_BOOTSTRAP_KEY = 0x100F,
	DPP_ATTR_OWN_NET_NK_HASH = 0x1011,
	DPP_ATTR_FINITE_CYCLIC_GROUP = 0x1012,
	DPP_ATTR_ENCRYPTED_KEY = 0x1013,
	DPP_ATTR_ENROLLEE_NONCE = 0x1014,
	DPP_ATTR_CODE_IDENTIFIER = 0x1015,
	DPP_ATTR_TRANSACTION_ID = 0x1016,
	DPP_ATTR_BOOTSTRAP_INFO = 0x1017,
	DPP_ATTR_CHANNEL = 0x1018,
};

enum dpp_status_error {
	DPP_STATUS_OK = 0,
	DPP_STATUS_NOT_COMPATIBLE = 1,
	DPP_STATUS_AUTH_FAILURE = 2,
	DPP_STATUS_UNWRAP_FAILURE = 3,
	DPP_STATUS_BAD_GROUP = 4,
	DPP_STATUS_CONFIGURE_FAILURE = 5,
	DPP_STATUS_RESPONSE_PENDING = 6,
	DPP_STATUS_INVALID_CONNECTOR = 7,
	DPP_STATUS_NO_MATCH = 8,
};

#define DPP_CAPAB_ENROLLEE BIT(0)
#define DPP_CAPAB_CONFIGURATOR BIT(1)
#define DPP_CAPAB_ROLE_MASK (BIT(0) | BIT(1))

#define DPP_BOOTSTRAP_MAX_FREQ 30
#define DPP_MAX_NONCE_LEN 32
#define DPP_MAX_HASH_LEN 64
#define DPP_MAX_SHARED_SECRET_LEN 66

struct dpp_curve_params {
	const char *name;
	size_t hash_len;
	size_t aes_siv_key_len;
	size_t nonce_len;
	size_t prime_len;
	const char *jwk_crv;
	u16 ike_group;
	const char *jws_alg;
};

enum dpp_bootstrap_type {
	DPP_BOOTSTRAP_QR_CODE,
	DPP_BOOTSTRAP_PKEX,
};

struct dpp_bootstrap_info {
	struct dl_list list;
	unsigned int id;
	enum dpp_bootstrap_type type;
	char *uri;
	u8 mac_addr[ETH_ALEN];
	char *info;
	unsigned int freq[DPP_BOOTSTRAP_MAX_FREQ];
	unsigned int num_freq;
	int own;
	EVP_PKEY *pubkey;
	u8 pubkey_hash[SHA256_MAC_LEN];
	const struct dpp_curve_params *curve;
	unsigned int pkex_t; /* number of failures before dpp_pkex
			      * instantiation */
};

#define PKEX_COUNTER_T_LIMIT 5

struct dpp_pkex {
	void *msg_ctx;
	unsigned int initiator:1;
	unsigned int exchange_done:1;
	unsigned int failed:1;
	struct dpp_bootstrap_info *own_bi;
	u8 own_mac[ETH_ALEN];
	u8 peer_mac[ETH_ALEN];
	char *identifier;
	char *code;
	EVP_PKEY *x;
	EVP_PKEY *y;
	u8 Mx[DPP_MAX_SHARED_SECRET_LEN];
	u8 Nx[DPP_MAX_SHARED_SECRET_LEN];
	u8 z[DPP_MAX_HASH_LEN];
	EVP_PKEY *peer_bootstrap_key;
	struct wpabuf *exchange_req;
	struct wpabuf *exchange_resp;
	unsigned int t; /* number of failures on code use */
};

struct dpp_configuration {
	u8 ssid[32];
	size_t ssid_len;
	int dpp; /* whether to use DPP or legacy configuration */

	/* For DPP configuration (connector) */
	os_time_t netaccesskey_expiry;

	/* TODO: groups */

	/* For legacy configuration */
	char *passphrase;
	u8 psk[32];
};

struct dpp_authentication {
	void *msg_ctx;
	const struct dpp_curve_params *curve;
	struct dpp_bootstrap_info *peer_bi;
	struct dpp_bootstrap_info *own_bi;
	u8 waiting_pubkey_hash[SHA256_MAC_LEN];
	int response_pending;
	enum dpp_status_error auth_resp_status;
	u8 peer_mac_addr[ETH_ALEN];
	u8 i_nonce[DPP_MAX_NONCE_LEN];
	u8 r_nonce[DPP_MAX_NONCE_LEN];
	u8 e_nonce[DPP_MAX_NONCE_LEN];
	u8 i_capab;
	u8 r_capab;
	EVP_PKEY *own_protocol_key;
	EVP_PKEY *peer_protocol_key;
	struct wpabuf *req_msg;
	struct wpabuf *resp_msg;
	/* Intersection of possible frequencies for initiating DPP
	 * Authentication exchange */
	unsigned int freq[DPP_BOOTSTRAP_MAX_FREQ];
	unsigned int num_freq, freq_idx;
	unsigned int curr_freq;
	unsigned int neg_freq;
	unsigned int num_freq_iters;
	size_t secret_len;
	u8 Mx[DPP_MAX_SHARED_SECRET_LEN];
	u8 Nx[DPP_MAX_SHARED_SECRET_LEN];
	u8 Lx[DPP_MAX_SHARED_SECRET_LEN];
	u8 k1[DPP_MAX_HASH_LEN];
	u8 k2[DPP_MAX_HASH_LEN];
	u8 ke[DPP_MAX_HASH_LEN];
	int initiator;
	int waiting_auth_resp;
	int waiting_auth_conf;
	unsigned int auth_resp_tries;
	u8 allowed_roles;
	int configurator;
	int remove_on_tx_status;
	int auth_success;
	struct wpabuf *conf_req;
	struct dpp_configuration *conf_ap;
	struct dpp_configuration *conf_sta;
	struct dpp_configurator *conf;
	char *connector; /* received signedConnector */
	u8 ssid[SSID_MAX_LEN];
	u8 ssid_len;
	char passphrase[64];
	u8 psk[PMK_LEN];
	int psk_set;
	struct wpabuf *net_access_key;
	os_time_t net_access_key_expiry;
	struct wpabuf *c_sign_key;
#ifdef CONFIG_TESTING_OPTIONS
	char *config_obj_override;
	char *discovery_override;
	char *groups_override;
	unsigned int ignore_netaccesskey_mismatch:1;
#endif /* CONFIG_TESTING_OPTIONS */
};

struct dpp_configurator {
	struct dl_list list;
	unsigned int id;
	int own;
	EVP_PKEY *csign;
	char *kid;
	const struct dpp_curve_params *curve;
};

struct dpp_introduction {
	u8 pmkid[PMKID_LEN];
	u8 pmk[PMK_LEN_MAX];
	size_t pmk_len;
};

#ifdef CONFIG_TESTING_OPTIONS
enum dpp_test_behavior {
	DPP_TEST_DISABLED = 0,
	DPP_TEST_AFTER_WRAPPED_DATA_AUTH_REQ = 1,
	DPP_TEST_AFTER_WRAPPED_DATA_AUTH_RESP = 2,
	DPP_TEST_AFTER_WRAPPED_DATA_AUTH_CONF = 3,
	DPP_TEST_AFTER_WRAPPED_DATA_PKEX_CR_REQ = 4,
	DPP_TEST_AFTER_WRAPPED_DATA_PKEX_CR_RESP = 5,
	DPP_TEST_AFTER_WRAPPED_DATA_CONF_REQ = 6,
	DPP_TEST_AFTER_WRAPPED_DATA_CONF_RESP = 7,
	DPP_TEST_ZERO_I_CAPAB = 8,
	DPP_TEST_ZERO_R_CAPAB = 9,
	DPP_TEST_NO_R_BOOTSTRAP_KEY_HASH_AUTH_REQ = 10,
	DPP_TEST_NO_I_BOOTSTRAP_KEY_HASH_AUTH_REQ = 11,
	DPP_TEST_NO_I_PROTO_KEY_AUTH_REQ = 12,
	DPP_TEST_NO_I_NONCE_AUTH_REQ = 13,
	DPP_TEST_NO_I_CAPAB_AUTH_REQ = 14,
	DPP_TEST_NO_WRAPPED_DATA_AUTH_REQ = 15,
	DPP_TEST_NO_STATUS_AUTH_RESP = 16,
	DPP_TEST_NO_R_BOOTSTRAP_KEY_HASH_AUTH_RESP = 17,
	DPP_TEST_NO_I_BOOTSTRAP_KEY_HASH_AUTH_RESP = 18,
	DPP_TEST_NO_R_PROTO_KEY_AUTH_RESP = 19,
	DPP_TEST_NO_R_NONCE_AUTH_RESP = 20,
	DPP_TEST_NO_I_NONCE_AUTH_RESP = 21,
	DPP_TEST_NO_R_CAPAB_AUTH_RESP = 22,
	DPP_TEST_NO_R_AUTH_AUTH_RESP = 23,
	DPP_TEST_NO_WRAPPED_DATA_AUTH_RESP = 24,
	DPP_TEST_NO_STATUS_AUTH_CONF = 25,
	DPP_TEST_NO_R_BOOTSTRAP_KEY_HASH_AUTH_CONF = 26,
	DPP_TEST_NO_I_BOOTSTRAP_KEY_HASH_AUTH_CONF = 27,
	DPP_TEST_NO_I_AUTH_AUTH_CONF = 28,
	DPP_TEST_NO_WRAPPED_DATA_AUTH_CONF = 29,
	DPP_TEST_I_NONCE_MISMATCH_AUTH_RESP = 30,
	DPP_TEST_INCOMPATIBLE_R_CAPAB_AUTH_RESP = 31,
	DPP_TEST_R_AUTH_MISMATCH_AUTH_RESP = 32,
	DPP_TEST_I_AUTH_MISMATCH_AUTH_CONF = 33,
	DPP_TEST_NO_FINITE_CYCLIC_GROUP_PKEX_EXCHANGE_REQ = 34,
	DPP_TEST_NO_ENCRYPTED_KEY_PKEX_EXCHANGE_REQ = 35,
	DPP_TEST_NO_STATUS_PKEX_EXCHANGE_RESP = 36,
	DPP_TEST_NO_ENCRYPTED_KEY_PKEX_EXCHANGE_RESP = 37,
	DPP_TEST_NO_BOOTSTRAP_KEY_PKEX_CR_REQ = 38,
	DPP_TEST_NO_I_AUTH_TAG_PKEX_CR_REQ = 39,
	DPP_TEST_NO_WRAPPED_DATA_PKEX_CR_REQ = 40,
	DPP_TEST_NO_BOOTSTRAP_KEY_PKEX_CR_RESP = 41,
	DPP_TEST_NO_R_AUTH_TAG_PKEX_CR_RESP = 42,
	DPP_TEST_NO_WRAPPED_DATA_PKEX_CR_RESP = 43,
	DPP_TEST_INVALID_ENCRYPTED_KEY_PKEX_EXCHANGE_REQ = 44,
	DPP_TEST_INVALID_ENCRYPTED_KEY_PKEX_EXCHANGE_RESP = 45,
	DPP_TEST_INVALID_STATUS_PKEX_EXCHANGE_RESP = 46,
	DPP_TEST_INVALID_BOOTSTRAP_KEY_PKEX_CR_REQ = 47,
	DPP_TEST_INVALID_BOOTSTRAP_KEY_PKEX_CR_RESP = 48,
	DPP_TEST_I_AUTH_TAG_MISMATCH_PKEX_CR_REQ = 49,
	DPP_TEST_R_AUTH_TAG_MISMATCH_PKEX_CR_RESP = 50,
	DPP_TEST_NO_E_NONCE_CONF_REQ = 51,
	DPP_TEST_NO_CONFIG_ATTR_OBJ_CONF_REQ = 52,
	DPP_TEST_NO_WRAPPED_DATA_CONF_REQ = 53,
	DPP_TEST_NO_E_NONCE_CONF_RESP = 54,
	DPP_TEST_NO_CONFIG_OBJ_CONF_RESP = 55,
	DPP_TEST_NO_STATUS_CONF_RESP = 56,
	DPP_TEST_NO_WRAPPED_DATA_CONF_RESP = 57,
	DPP_TEST_INVALID_STATUS_CONF_RESP = 58,
	DPP_TEST_E_NONCE_MISMATCH_CONF_RESP = 59,
	DPP_TEST_NO_TRANSACTION_ID_PEER_DISC_REQ = 60,
	DPP_TEST_NO_CONNECTOR_PEER_DISC_REQ = 61,
	DPP_TEST_NO_TRANSACTION_ID_PEER_DISC_RESP = 62,
	DPP_TEST_NO_STATUS_PEER_DISC_RESP = 63,
	DPP_TEST_NO_CONNECTOR_PEER_DISC_RESP = 64,
	DPP_TEST_AUTH_RESP_IN_PLACE_OF_CONF = 65,
	DPP_TEST_INVALID_I_PROTO_KEY_AUTH_REQ = 66,
	DPP_TEST_INVALID_R_PROTO_KEY_AUTH_RESP = 67,
	DPP_TEST_INVALID_R_BOOTSTRAP_KEY_HASH_AUTH_REQ = 68,
	DPP_TEST_INVALID_I_BOOTSTRAP_KEY_HASH_AUTH_REQ = 69,
	DPP_TEST_INVALID_R_BOOTSTRAP_KEY_HASH_AUTH_RESP = 70,
	DPP_TEST_INVALID_I_BOOTSTRAP_KEY_HASH_AUTH_RESP = 71,
	DPP_TEST_INVALID_R_BOOTSTRAP_KEY_HASH_AUTH_CONF = 72,
	DPP_TEST_INVALID_I_BOOTSTRAP_KEY_HASH_AUTH_CONF = 73,
};

extern enum dpp_test_behavior dpp_test;
#endif /* CONFIG_TESTING_OPTIONS */

void dpp_bootstrap_info_free(struct dpp_bootstrap_info *info);
const char * dpp_bootstrap_type_txt(enum dpp_bootstrap_type type);
int dpp_bootstrap_key_hash(struct dpp_bootstrap_info *bi);
int dpp_parse_uri_chan_list(struct dpp_bootstrap_info *bi,
			    const char *chan_list);
int dpp_parse_uri_mac(struct dpp_bootstrap_info *bi, const char *mac);
int dpp_parse_uri_info(struct dpp_bootstrap_info *bi, const char *info);
struct dpp_bootstrap_info * dpp_parse_qr_code(const char *uri);
char * dpp_keygen(struct dpp_bootstrap_info *bi, const char *curve,
		  const u8 *privkey, size_t privkey_len);
struct hostapd_hw_modes;
struct dpp_authentication * dpp_auth_init(void *msg_ctx,
					  struct dpp_bootstrap_info *peer_bi,
					  struct dpp_bootstrap_info *own_bi,
					  u8 dpp_allowed_roles,
					  unsigned int neg_freq,
					  struct hostapd_hw_modes *own_modes,
					  u16 num_modes);
struct dpp_authentication *
dpp_auth_req_rx(void *msg_ctx, u8 dpp_allowed_roles, int qr_mutual,
		struct dpp_bootstrap_info *peer_bi,
		struct dpp_bootstrap_info *own_bi,
		unsigned int freq, const u8 *hdr, const u8 *attr_start,
		size_t attr_len);
struct wpabuf *
dpp_auth_resp_rx(struct dpp_authentication *auth, const u8 *hdr,
		 const u8 *attr_start, size_t attr_len);
struct wpabuf * dpp_build_conf_req(struct dpp_authentication *auth,
				   const char *json);
int dpp_auth_conf_rx(struct dpp_authentication *auth, const u8 *hdr,
		     const u8 *attr_start, size_t attr_len);
int dpp_notify_new_qr_code(struct dpp_authentication *auth,
			   struct dpp_bootstrap_info *peer_bi);
void dpp_configuration_free(struct dpp_configuration *conf);
void dpp_auth_deinit(struct dpp_authentication *auth);
struct wpabuf *
dpp_conf_req_rx(struct dpp_authentication *auth, const u8 *attr_start,
		size_t attr_len);
int dpp_conf_resp_rx(struct dpp_authentication *auth,
		     const struct wpabuf *resp);
struct wpabuf * dpp_alloc_msg(enum dpp_public_action_frame_type type,
			      size_t len);
const u8 * dpp_get_attr(const u8 *buf, size_t len, u16 req_id, u16 *ret_len);
int dpp_check_attrs(const u8 *buf, size_t len);
int dpp_key_expired(const char *timestamp, os_time_t *expiry);
void dpp_configurator_free(struct dpp_configurator *conf);
struct dpp_configurator *
dpp_keygen_configurator(const char *curve, const u8 *privkey,
			size_t privkey_len);
int dpp_configurator_own_config(struct dpp_authentication *auth,
				const char *curve);
enum dpp_status_error
dpp_peer_intro(struct dpp_introduction *intro, const char *own_connector,
	       const u8 *net_access_key, size_t net_access_key_len,
	       const u8 *csign_key, size_t csign_key_len,
	       const u8 *peer_connector, size_t peer_connector_len,
	       os_time_t *expiry);
struct dpp_pkex * dpp_pkex_init(void *msg_ctx, struct dpp_bootstrap_info *bi,
				const u8 *own_mac,
				const char *identifier,
				const char *code);
struct dpp_pkex * dpp_pkex_rx_exchange_req(void *msg_ctx,
					   struct dpp_bootstrap_info *bi,
					   const u8 *own_mac,
					   const u8 *peer_mac,
					   const char *identifier,
					   const char *code,
					   const u8 *buf, size_t len);
struct wpabuf * dpp_pkex_rx_exchange_resp(struct dpp_pkex *pkex,
					  const u8 *buf, size_t len);
struct wpabuf * dpp_pkex_rx_commit_reveal_req(struct dpp_pkex *pkex,
					      const u8 *hdr,
					      const u8 *buf, size_t len);
int dpp_pkex_rx_commit_reveal_resp(struct dpp_pkex *pkex, const u8 *hdr,
				   const u8 *buf, size_t len);
void dpp_pkex_free(struct dpp_pkex *pkex);

#endif /* DPP_H */
Commit	Line	Data
be27e185 JM	1	/*
	2	* DPP functionality shared between hostapd and wpa_supplicant
	3	* Copyright (c) 2017, Qualcomm Atheros, Inc.
	4	*
	5	* This software may be distributed under the terms of the BSD license.
	6	* See README for more details.
	7	*/
	8
	9	#ifndef DPP_H
	10	#define DPP_H
	11
	12	#include <openssl/x509.h>
	13
	14	#include "utils/list.h"
650a70a7	15	#include "common/wpa_common.h"
be27e185 JM	16	#include "crypto/sha256.h"
be27e185 JM	17
dc4d271c JM	18	#define DPP_HDR_LEN (4 + 2) /* OUI, OUI Type, Crypto Suite, DPP frame type */
dc4d271c JM	19
30d27b04 JM	20	enum dpp_public_action_frame_type {
	21	DPP_PA_AUTHENTICATION_REQ = 0,
	22	DPP_PA_AUTHENTICATION_RESP = 1,
	23	DPP_PA_AUTHENTICATION_CONF = 2,
	24	DPP_PA_PEER_DISCOVERY_REQ = 5,
	25	DPP_PA_PEER_DISCOVERY_RESP = 6,
	26	DPP_PA_PKEX_EXCHANGE_REQ = 7,
	27	DPP_PA_PKEX_EXCHANGE_RESP = 8,
	28	DPP_PA_PKEX_COMMIT_REVEAL_REQ = 9,
	29	DPP_PA_PKEX_COMMIT_REVEAL_RESP = 10,
	30	};
	31
	32	enum dpp_attribute_id {
	33	DPP_ATTR_STATUS = 0x1000,
	34	DPP_ATTR_I_BOOTSTRAP_KEY_HASH = 0x1001,
	35	DPP_ATTR_R_BOOTSTRAP_KEY_HASH = 0x1002,
	36	DPP_ATTR_I_PROTOCOL_KEY = 0x1003,
	37	DPP_ATTR_WRAPPED_DATA = 0x1004,
	38	DPP_ATTR_I_NONCE = 0x1005,
	39	DPP_ATTR_I_CAPABILITIES = 0x1006,
	40	DPP_ATTR_R_NONCE = 0x1007,
	41	DPP_ATTR_R_CAPABILITIES = 0x1008,
	42	DPP_ATTR_R_PROTOCOL_KEY = 0x1009,
	43	DPP_ATTR_I_AUTH_TAG = 0x100A,
	44	DPP_ATTR_R_AUTH_TAG = 0x100B,
	45	DPP_ATTR_CONFIG_OBJ = 0x100C,
	46	DPP_ATTR_CONNECTOR = 0x100D,
	47	DPP_ATTR_CONFIG_ATTR_OBJ = 0x100E,
	48	DPP_ATTR_BOOTSTRAP_KEY = 0x100F,
30d27b04 JM	49	DPP_ATTR_OWN_NET_NK_HASH = 0x1011,
	50	DPP_ATTR_FINITE_CYCLIC_GROUP = 0x1012,
	51	DPP_ATTR_ENCRYPTED_KEY = 0x1013,
	52	DPP_ATTR_ENROLLEE_NONCE = 0x1014,
	53	DPP_ATTR_CODE_IDENTIFIER = 0x1015,
85fd8263	54	DPP_ATTR_TRANSACTION_ID = 0x1016,
d2709206 JM	55	DPP_ATTR_BOOTSTRAP_INFO = 0x1017,
d2709206 JM	56	DPP_ATTR_CHANNEL = 0x1018,
30d27b04 JM	57	};
	58
	59	enum dpp_status_error {
	60	DPP_STATUS_OK = 0,
	61	DPP_STATUS_NOT_COMPATIBLE = 1,
	62	DPP_STATUS_AUTH_FAILURE = 2,
	63	DPP_STATUS_UNWRAP_FAILURE = 3,
	64	DPP_STATUS_BAD_GROUP = 4,
	65	DPP_STATUS_CONFIGURE_FAILURE = 5,
	66	DPP_STATUS_RESPONSE_PENDING = 6,
e85b6601 JM	67	DPP_STATUS_INVALID_CONNECTOR = 7,
e85b6601 JM	68	DPP_STATUS_NO_MATCH = 8,
30d27b04 JM	69	};
	70
	71	#define DPP_CAPAB_ENROLLEE BIT(0)
	72	#define DPP_CAPAB_CONFIGURATOR BIT(1)
	73	#define DPP_CAPAB_ROLE_MASK (BIT(0) \| BIT(1))
	74
be27e185	75	#define DPP_BOOTSTRAP_MAX_FREQ 30
30d27b04 JM	76	#define DPP_MAX_NONCE_LEN 32
	77	#define DPP_MAX_HASH_LEN 64
	78	#define DPP_MAX_SHARED_SECRET_LEN 66
be27e185 JM	79
	80	struct dpp_curve_params {
	81	const char *name;
	82	size_t hash_len;
	83	size_t aes_siv_key_len;
	84	size_t nonce_len;
	85	size_t prime_len;
	86	const char *jwk_crv;
500ed7f0	87	u16 ike_group;
31f03cb0	88	const char *jws_alg;
be27e185 JM	89	};
	90
	91	enum dpp_bootstrap_type {
	92	DPP_BOOTSTRAP_QR_CODE,
500ed7f0	93	DPP_BOOTSTRAP_PKEX,
be27e185 JM	94	};
	95
	96	struct dpp_bootstrap_info {
	97	struct dl_list list;
	98	unsigned int id;
	99	enum dpp_bootstrap_type type;
	100	char *uri;
	101	u8 mac_addr[ETH_ALEN];
	102	char *info;
	103	unsigned int freq[DPP_BOOTSTRAP_MAX_FREQ];
	104	unsigned int num_freq;
	105	int own;
	106	EVP_PKEY *pubkey;
	107	u8 pubkey_hash[SHA256_MAC_LEN];
	108	const struct dpp_curve_params *curve;
29ab69e4 JM	109	unsigned int pkex_t; /* number of failures before dpp_pkex
29ab69e4 JM	110	* instantiation */
be27e185 JM	111	};
be27e185 JM	112
29ab69e4 JM	113	#define PKEX_COUNTER_T_LIMIT 5
29ab69e4 JM	114
500ed7f0	115	struct dpp_pkex {
219d4c9f	116	void *msg_ctx;
500ed7f0 JM	117	unsigned int initiator:1;
500ed7f0 JM	118	unsigned int exchange_done:1;
e0247e79	119	unsigned int failed:1;
500ed7f0 JM	120	struct dpp_bootstrap_info *own_bi;
	121	u8 own_mac[ETH_ALEN];
	122	u8 peer_mac[ETH_ALEN];
	123	char *identifier;
	124	char *code;
	125	EVP_PKEY *x;
	126	EVP_PKEY *y;
	127	u8 Mx[DPP_MAX_SHARED_SECRET_LEN];
	128	u8 Nx[DPP_MAX_SHARED_SECRET_LEN];
	129	u8 z[DPP_MAX_HASH_LEN];
	130	EVP_PKEY *peer_bootstrap_key;
	131	struct wpabuf *exchange_req;
	132	struct wpabuf *exchange_resp;
29ab69e4	133	unsigned int t; /* number of failures on code use */
500ed7f0 JM	134	};
500ed7f0 JM	135
461d39af JM	136	struct dpp_configuration {
	137	u8 ssid[32];
	138	size_t ssid_len;
	139	int dpp; /* whether to use DPP or legacy configuration */
	140
	141	/* For DPP configuration (connector) */
	142	os_time_t netaccesskey_expiry;
	143
a4bf0078	144	/* TODO: groups */
461d39af JM	145
	146	/* For legacy configuration */
	147	char *passphrase;
	148	u8 psk[32];
	149	};
	150
30d27b04 JM	151	struct dpp_authentication {
	152	void *msg_ctx;
	153	const struct dpp_curve_params *curve;
	154	struct dpp_bootstrap_info *peer_bi;
	155	struct dpp_bootstrap_info *own_bi;
	156	u8 waiting_pubkey_hash[SHA256_MAC_LEN];
	157	int response_pending;
	158	enum dpp_status_error auth_resp_status;
	159	u8 peer_mac_addr[ETH_ALEN];
	160	u8 i_nonce[DPP_MAX_NONCE_LEN];
	161	u8 r_nonce[DPP_MAX_NONCE_LEN];
461d39af	162	u8 e_nonce[DPP_MAX_NONCE_LEN];
30d27b04 JM	163	u8 i_capab;
	164	u8 r_capab;
	165	EVP_PKEY *own_protocol_key;
	166	EVP_PKEY *peer_protocol_key;
dc4d271c JM	167	struct wpabuf *req_msg;
dc4d271c JM	168	struct wpabuf *resp_msg;
f97ace34 JM	169	/* Intersection of possible frequencies for initiating DPP
	170	* Authentication exchange */
	171	unsigned int freq[DPP_BOOTSTRAP_MAX_FREQ];
	172	unsigned int num_freq, freq_idx;
30d27b04	173	unsigned int curr_freq;
d2709206	174	unsigned int neg_freq;
f97ace34	175	unsigned int num_freq_iters;
30d27b04 JM	176	size_t secret_len;
	177	u8 Mx[DPP_MAX_SHARED_SECRET_LEN];
	178	u8 Nx[DPP_MAX_SHARED_SECRET_LEN];
	179	u8 Lx[DPP_MAX_SHARED_SECRET_LEN];
	180	u8 k1[DPP_MAX_HASH_LEN];
	181	u8 k2[DPP_MAX_HASH_LEN];
	182	u8 ke[DPP_MAX_HASH_LEN];
	183	int initiator;
f97ace34	184	int waiting_auth_resp;
95b0104a JM	185	int waiting_auth_conf;
95b0104a JM	186	unsigned int auth_resp_tries;
d1f08264	187	u8 allowed_roles;
30d27b04 JM	188	int configurator;
	189	int remove_on_tx_status;
	190	int auth_success;
461d39af JM	191	struct wpabuf *conf_req;
	192	struct dpp_configuration *conf_ap;
	193	struct dpp_configuration *conf_sta;
	194	struct dpp_configurator *conf;
	195	char connector; / received signedConnector */
	196	u8 ssid[SSID_MAX_LEN];
	197	u8 ssid_len;
8528994e JM	198	char passphrase[64];
	199	u8 psk[PMK_LEN];
	200	int psk_set;
461d39af JM	201	struct wpabuf *net_access_key;
	202	os_time_t net_access_key_expiry;
	203	struct wpabuf *c_sign_key;
461d39af JM	204	#ifdef CONFIG_TESTING_OPTIONS
	205	char *config_obj_override;
	206	char *discovery_override;
	207	char *groups_override;
461d39af JM	208	unsigned int ignore_netaccesskey_mismatch:1;
	209	#endif /* CONFIG_TESTING_OPTIONS */
	210	};
	211
	212	struct dpp_configurator {
	213	struct dl_list list;
	214	unsigned int id;
	215	int own;
	216	EVP_PKEY *csign;
	217	char *kid;
	218	const struct dpp_curve_params *curve;
30d27b04 JM	219	};
30d27b04 JM	220
650a70a7 JM	221	struct dpp_introduction {
	222	u8 pmkid[PMKID_LEN];
	223	u8 pmk[PMK_LEN_MAX];
	224	size_t pmk_len;
650a70a7 JM	225	};
650a70a7 JM	226
60239f60 JM	227	#ifdef CONFIG_TESTING_OPTIONS
	228	enum dpp_test_behavior {
	229	DPP_TEST_DISABLED = 0,
	230	DPP_TEST_AFTER_WRAPPED_DATA_AUTH_REQ = 1,
	231	DPP_TEST_AFTER_WRAPPED_DATA_AUTH_RESP = 2,
	232	DPP_TEST_AFTER_WRAPPED_DATA_AUTH_CONF = 3,
	233	DPP_TEST_AFTER_WRAPPED_DATA_PKEX_CR_REQ = 4,
	234	DPP_TEST_AFTER_WRAPPED_DATA_PKEX_CR_RESP = 5,
	235	DPP_TEST_AFTER_WRAPPED_DATA_CONF_REQ = 6,
	236	DPP_TEST_AFTER_WRAPPED_DATA_CONF_RESP = 7,
	237	DPP_TEST_ZERO_I_CAPAB = 8,
	238	DPP_TEST_ZERO_R_CAPAB = 9,
0e7cb8c6 JM	239	DPP_TEST_NO_R_BOOTSTRAP_KEY_HASH_AUTH_REQ = 10,
	240	DPP_TEST_NO_I_BOOTSTRAP_KEY_HASH_AUTH_REQ = 11,
	241	DPP_TEST_NO_I_PROTO_KEY_AUTH_REQ = 12,
	242	DPP_TEST_NO_I_NONCE_AUTH_REQ = 13,
	243	DPP_TEST_NO_I_CAPAB_AUTH_REQ = 14,
	244	DPP_TEST_NO_WRAPPED_DATA_AUTH_REQ = 15,
ce9acce0 JM	245	DPP_TEST_NO_STATUS_AUTH_RESP = 16,
	246	DPP_TEST_NO_R_BOOTSTRAP_KEY_HASH_AUTH_RESP = 17,
	247	DPP_TEST_NO_I_BOOTSTRAP_KEY_HASH_AUTH_RESP = 18,
	248	DPP_TEST_NO_R_PROTO_KEY_AUTH_RESP = 19,
	249	DPP_TEST_NO_R_NONCE_AUTH_RESP = 20,
	250	DPP_TEST_NO_I_NONCE_AUTH_RESP = 21,
	251	DPP_TEST_NO_R_CAPAB_AUTH_RESP = 22,
	252	DPP_TEST_NO_R_AUTH_AUTH_RESP = 23,
	253	DPP_TEST_NO_WRAPPED_DATA_AUTH_RESP = 24,
f9c7d770 JM	254	DPP_TEST_NO_STATUS_AUTH_CONF = 25,
	255	DPP_TEST_NO_R_BOOTSTRAP_KEY_HASH_AUTH_CONF = 26,
	256	DPP_TEST_NO_I_BOOTSTRAP_KEY_HASH_AUTH_CONF = 27,
	257	DPP_TEST_NO_I_AUTH_AUTH_CONF = 28,
	258	DPP_TEST_NO_WRAPPED_DATA_AUTH_CONF = 29,
978bc3f2 JM	259	DPP_TEST_I_NONCE_MISMATCH_AUTH_RESP = 30,
	260	DPP_TEST_INCOMPATIBLE_R_CAPAB_AUTH_RESP = 31,
	261	DPP_TEST_R_AUTH_MISMATCH_AUTH_RESP = 32,
	262	DPP_TEST_I_AUTH_MISMATCH_AUTH_CONF = 33,
61f9f27f JM	263	DPP_TEST_NO_FINITE_CYCLIC_GROUP_PKEX_EXCHANGE_REQ = 34,
	264	DPP_TEST_NO_ENCRYPTED_KEY_PKEX_EXCHANGE_REQ = 35,
	265	DPP_TEST_NO_STATUS_PKEX_EXCHANGE_RESP = 36,
	266	DPP_TEST_NO_ENCRYPTED_KEY_PKEX_EXCHANGE_RESP = 37,
	267	DPP_TEST_NO_BOOTSTRAP_KEY_PKEX_CR_REQ = 38,
	268	DPP_TEST_NO_I_AUTH_TAG_PKEX_CR_REQ = 39,
	269	DPP_TEST_NO_WRAPPED_DATA_PKEX_CR_REQ = 40,
	270	DPP_TEST_NO_BOOTSTRAP_KEY_PKEX_CR_RESP = 41,
	271	DPP_TEST_NO_R_AUTH_TAG_PKEX_CR_RESP = 42,
	272	DPP_TEST_NO_WRAPPED_DATA_PKEX_CR_RESP = 43,
1cfcbd32 JM	273	DPP_TEST_INVALID_ENCRYPTED_KEY_PKEX_EXCHANGE_REQ = 44,
1cfcbd32 JM	274	DPP_TEST_INVALID_ENCRYPTED_KEY_PKEX_EXCHANGE_RESP = 45,
f31ef96d	275	DPP_TEST_INVALID_STATUS_PKEX_EXCHANGE_RESP = 46,
89d0bf67 JM	276	DPP_TEST_INVALID_BOOTSTRAP_KEY_PKEX_CR_REQ = 47,
89d0bf67 JM	277	DPP_TEST_INVALID_BOOTSTRAP_KEY_PKEX_CR_RESP = 48,
7e0ebe21 JM	278	DPP_TEST_I_AUTH_TAG_MISMATCH_PKEX_CR_REQ = 49,
7e0ebe21 JM	279	DPP_TEST_R_AUTH_TAG_MISMATCH_PKEX_CR_RESP = 50,
f411ad1b JM	280	DPP_TEST_NO_E_NONCE_CONF_REQ = 51,
	281	DPP_TEST_NO_CONFIG_ATTR_OBJ_CONF_REQ = 52,
	282	DPP_TEST_NO_WRAPPED_DATA_CONF_REQ = 53,
	283	DPP_TEST_NO_E_NONCE_CONF_RESP = 54,
	284	DPP_TEST_NO_CONFIG_OBJ_CONF_RESP = 55,
	285	DPP_TEST_NO_STATUS_CONF_RESP = 56,
	286	DPP_TEST_NO_WRAPPED_DATA_CONF_RESP = 57,
af7f10fc JM	287	DPP_TEST_INVALID_STATUS_CONF_RESP = 58,
af7f10fc JM	288	DPP_TEST_E_NONCE_MISMATCH_CONF_RESP = 59,
a306ed5a JM	289	DPP_TEST_NO_TRANSACTION_ID_PEER_DISC_REQ = 60,
	290	DPP_TEST_NO_CONNECTOR_PEER_DISC_REQ = 61,
	291	DPP_TEST_NO_TRANSACTION_ID_PEER_DISC_RESP = 62,
	292	DPP_TEST_NO_STATUS_PEER_DISC_RESP = 63,
	293	DPP_TEST_NO_CONNECTOR_PEER_DISC_RESP = 64,
762fb4f0	294	DPP_TEST_AUTH_RESP_IN_PLACE_OF_CONF = 65,
b6b4226b JM	295	DPP_TEST_INVALID_I_PROTO_KEY_AUTH_REQ = 66,
b6b4226b JM	296	DPP_TEST_INVALID_R_PROTO_KEY_AUTH_RESP = 67,
65ecce87 JM	297	DPP_TEST_INVALID_R_BOOTSTRAP_KEY_HASH_AUTH_REQ = 68,
	298	DPP_TEST_INVALID_I_BOOTSTRAP_KEY_HASH_AUTH_REQ = 69,
	299	DPP_TEST_INVALID_R_BOOTSTRAP_KEY_HASH_AUTH_RESP = 70,
	300	DPP_TEST_INVALID_I_BOOTSTRAP_KEY_HASH_AUTH_RESP = 71,
	301	DPP_TEST_INVALID_R_BOOTSTRAP_KEY_HASH_AUTH_CONF = 72,
	302	DPP_TEST_INVALID_I_BOOTSTRAP_KEY_HASH_AUTH_CONF = 73,
60239f60 JM	303	};
	304
	305	extern enum dpp_test_behavior dpp_test;
	306	#endif /* CONFIG_TESTING_OPTIONS */
	307
be27e185	308	void dpp_bootstrap_info_free(struct dpp_bootstrap_info *info);
484788b8	309	const char * dpp_bootstrap_type_txt(enum dpp_bootstrap_type type);
500ed7f0	310	int dpp_bootstrap_key_hash(struct dpp_bootstrap_info *bi);
be27e185 JM	311	int dpp_parse_uri_chan_list(struct dpp_bootstrap_info *bi,
	312	const char *chan_list);
	313	int dpp_parse_uri_mac(struct dpp_bootstrap_info bi, const char mac);
	314	int dpp_parse_uri_info(struct dpp_bootstrap_info bi, const char info);
	315	struct dpp_bootstrap_info * dpp_parse_qr_code(const char *uri);
	316	char * dpp_keygen(struct dpp_bootstrap_info bi, const char curve,
	317	const u8 *privkey, size_t privkey_len);
f97ace34	318	struct hostapd_hw_modes;
30d27b04 JM	319	struct dpp_authentication * dpp_auth_init(void *msg_ctx,
	320	struct dpp_bootstrap_info *peer_bi,
	321	struct dpp_bootstrap_info *own_bi,
d1f08264	322	u8 dpp_allowed_roles,
f97ace34 JM	323	unsigned int neg_freq,
	324	struct hostapd_hw_modes *own_modes,
	325	u16 num_modes);
30d27b04 JM	326	struct dpp_authentication *
	327	dpp_auth_req_rx(void *msg_ctx, u8 dpp_allowed_roles, int qr_mutual,
	328	struct dpp_bootstrap_info *peer_bi,
	329	struct dpp_bootstrap_info *own_bi,
dc4d271c	330	unsigned int freq, const u8 hdr, const u8 attr_start,
27fefbbb	331	size_t attr_len);
30d27b04	332	struct wpabuf *
dc4d271c JM	333	dpp_auth_resp_rx(struct dpp_authentication auth, const u8 hdr,
dc4d271c JM	334	const u8 *attr_start, size_t attr_len);
461d39af JM	335	struct wpabuf * dpp_build_conf_req(struct dpp_authentication *auth,
461d39af JM	336	const char *json);
dc4d271c JM	337	int dpp_auth_conf_rx(struct dpp_authentication auth, const u8 hdr,
dc4d271c JM	338	const u8 *attr_start, size_t attr_len);
30d27b04 JM	339	int dpp_notify_new_qr_code(struct dpp_authentication *auth,
30d27b04 JM	340	struct dpp_bootstrap_info *peer_bi);
461d39af	341	void dpp_configuration_free(struct dpp_configuration *conf);
30d27b04	342	void dpp_auth_deinit(struct dpp_authentication *auth);
461d39af JM	343	struct wpabuf *
	344	dpp_conf_req_rx(struct dpp_authentication auth, const u8 attr_start,
	345	size_t attr_len);
	346	int dpp_conf_resp_rx(struct dpp_authentication *auth,
	347	const struct wpabuf *resp);
30d27b04 JM	348	struct wpabuf * dpp_alloc_msg(enum dpp_public_action_frame_type type,
	349	size_t len);
	350	const u8 * dpp_get_attr(const u8 buf, size_t len, u16 req_id, u16 ret_len);
	351	int dpp_check_attrs(const u8 *buf, size_t len);
461d39af JM	352	int dpp_key_expired(const char timestamp, os_time_t expiry);
	353	void dpp_configurator_free(struct dpp_configurator *conf);
	354	struct dpp_configurator *
	355	dpp_keygen_configurator(const char curve, const u8 privkey,
	356	size_t privkey_len);
f522bb23 JM	357	int dpp_configurator_own_config(struct dpp_authentication *auth,
f522bb23 JM	358	const char *curve);
e85b6601 JM	359	enum dpp_status_error
	360	dpp_peer_intro(struct dpp_introduction intro, const char own_connector,
	361	const u8 *net_access_key, size_t net_access_key_len,
	362	const u8 *csign_key, size_t csign_key_len,
	363	const u8 *peer_connector, size_t peer_connector_len,
	364	os_time_t *expiry);
219d4c9f	365	struct dpp_pkex * dpp_pkex_init(void msg_ctx, struct dpp_bootstrap_info bi,
500ed7f0 JM	366	const u8 *own_mac,
	367	const char *identifier,
	368	const char *code);
219d4c9f JM	369	struct dpp_pkex * dpp_pkex_rx_exchange_req(void *msg_ctx,
219d4c9f JM	370	struct dpp_bootstrap_info *bi,
500ed7f0 JM	371	const u8 *own_mac,
	372	const u8 *peer_mac,
	373	const char *identifier,
	374	const char *code,
	375	const u8 *buf, size_t len);
	376	struct wpabuf * dpp_pkex_rx_exchange_resp(struct dpp_pkex *pkex,
	377	const u8 *buf, size_t len);
	378	struct wpabuf * dpp_pkex_rx_commit_reveal_req(struct dpp_pkex *pkex,
4be5bc98	379	const u8 *hdr,
500ed7f0	380	const u8 *buf, size_t len);
4be5bc98	381	int dpp_pkex_rx_commit_reveal_resp(struct dpp_pkex pkex, const u8 hdr,
500ed7f0 JM	382	const u8 *buf, size_t len);
500ed7f0 JM	383	void dpp_pkex_free(struct dpp_pkex *pkex);
be27e185 JM	384
be27e185 JM	385	#endif /* DPP_H */