2 * DPP functionality shared between hostapd and wpa_supplicant
3 * Copyright (c) 2017, Qualcomm Atheros, Inc.
4 * Copyright (c) 2018-2019, The Linux Foundation
6 * This software may be distributed under the terms of the BSD license.
7 * See README for more details.
13 #include <openssl/x509.h>
15 #include "utils/list.h"
16 #include "common/wpa_common.h"
17 #include "crypto/sha256.h"
21 #define DPP_HDR_LEN (4 + 2) /* OUI, OUI Type, Crypto Suite, DPP frame type */
23 enum dpp_public_action_frame_type
{
24 DPP_PA_AUTHENTICATION_REQ
= 0,
25 DPP_PA_AUTHENTICATION_RESP
= 1,
26 DPP_PA_AUTHENTICATION_CONF
= 2,
27 DPP_PA_PEER_DISCOVERY_REQ
= 5,
28 DPP_PA_PEER_DISCOVERY_RESP
= 6,
29 DPP_PA_PKEX_EXCHANGE_REQ
= 7,
30 DPP_PA_PKEX_EXCHANGE_RESP
= 8,
31 DPP_PA_PKEX_COMMIT_REVEAL_REQ
= 9,
32 DPP_PA_PKEX_COMMIT_REVEAL_RESP
= 10,
33 DPP_PA_CONFIGURATION_RESULT
= 11,
36 enum dpp_attribute_id
{
37 DPP_ATTR_STATUS
= 0x1000,
38 DPP_ATTR_I_BOOTSTRAP_KEY_HASH
= 0x1001,
39 DPP_ATTR_R_BOOTSTRAP_KEY_HASH
= 0x1002,
40 DPP_ATTR_I_PROTOCOL_KEY
= 0x1003,
41 DPP_ATTR_WRAPPED_DATA
= 0x1004,
42 DPP_ATTR_I_NONCE
= 0x1005,
43 DPP_ATTR_I_CAPABILITIES
= 0x1006,
44 DPP_ATTR_R_NONCE
= 0x1007,
45 DPP_ATTR_R_CAPABILITIES
= 0x1008,
46 DPP_ATTR_R_PROTOCOL_KEY
= 0x1009,
47 DPP_ATTR_I_AUTH_TAG
= 0x100A,
48 DPP_ATTR_R_AUTH_TAG
= 0x100B,
49 DPP_ATTR_CONFIG_OBJ
= 0x100C,
50 DPP_ATTR_CONNECTOR
= 0x100D,
51 DPP_ATTR_CONFIG_ATTR_OBJ
= 0x100E,
52 DPP_ATTR_BOOTSTRAP_KEY
= 0x100F,
53 DPP_ATTR_OWN_NET_NK_HASH
= 0x1011,
54 DPP_ATTR_FINITE_CYCLIC_GROUP
= 0x1012,
55 DPP_ATTR_ENCRYPTED_KEY
= 0x1013,
56 DPP_ATTR_ENROLLEE_NONCE
= 0x1014,
57 DPP_ATTR_CODE_IDENTIFIER
= 0x1015,
58 DPP_ATTR_TRANSACTION_ID
= 0x1016,
59 DPP_ATTR_BOOTSTRAP_INFO
= 0x1017,
60 DPP_ATTR_CHANNEL
= 0x1018,
61 DPP_ATTR_PROTOCOL_VERSION
= 0x1019,
62 DPP_ATTR_ENVELOPED_DATA
= 0x101A,
65 enum dpp_status_error
{
67 DPP_STATUS_NOT_COMPATIBLE
= 1,
68 DPP_STATUS_AUTH_FAILURE
= 2,
69 DPP_STATUS_UNWRAP_FAILURE
= 3,
70 DPP_STATUS_BAD_GROUP
= 4,
71 DPP_STATUS_CONFIGURE_FAILURE
= 5,
72 DPP_STATUS_RESPONSE_PENDING
= 6,
73 DPP_STATUS_INVALID_CONNECTOR
= 7,
74 DPP_STATUS_NO_MATCH
= 8,
75 DPP_STATUS_CONFIG_REJECTED
= 9,
78 #define DPP_CAPAB_ENROLLEE BIT(0)
79 #define DPP_CAPAB_CONFIGURATOR BIT(1)
80 #define DPP_CAPAB_ROLE_MASK (BIT(0) | BIT(1))
82 #define DPP_BOOTSTRAP_MAX_FREQ 30
83 #define DPP_MAX_NONCE_LEN 32
84 #define DPP_MAX_HASH_LEN 64
85 #define DPP_MAX_SHARED_SECRET_LEN 66
87 struct dpp_curve_params
{
90 size_t aes_siv_key_len
;
98 enum dpp_bootstrap_type
{
99 DPP_BOOTSTRAP_QR_CODE
,
103 struct dpp_bootstrap_info
{
106 enum dpp_bootstrap_type type
;
108 u8 mac_addr
[ETH_ALEN
];
110 unsigned int freq
[DPP_BOOTSTRAP_MAX_FREQ
];
111 unsigned int num_freq
;
114 u8 pubkey_hash
[SHA256_MAC_LEN
];
115 const struct dpp_curve_params
*curve
;
116 unsigned int pkex_t
; /* number of failures before dpp_pkex
120 #define PKEX_COUNTER_T_LIMIT 5
124 unsigned int initiator
:1;
125 unsigned int exchange_done
:1;
126 unsigned int failed
:1;
127 struct dpp_bootstrap_info
*own_bi
;
128 u8 own_mac
[ETH_ALEN
];
129 u8 peer_mac
[ETH_ALEN
];
134 u8 Mx
[DPP_MAX_SHARED_SECRET_LEN
];
135 u8 Nx
[DPP_MAX_SHARED_SECRET_LEN
];
136 u8 z
[DPP_MAX_HASH_LEN
];
137 EVP_PKEY
*peer_bootstrap_key
;
138 struct wpabuf
*exchange_req
;
139 struct wpabuf
*exchange_resp
;
140 unsigned int t
; /* number of failures on code use */
141 unsigned int exch_req_wait_time
;
142 unsigned int exch_req_tries
;
156 struct dpp_configuration
{
161 /* For DPP configuration (connector) */
162 os_time_t netaccesskey_expiry
;
167 /* For legacy configuration */
173 struct dpp_authentication
{
176 const struct dpp_curve_params
*curve
;
177 struct dpp_bootstrap_info
*peer_bi
;
178 struct dpp_bootstrap_info
*own_bi
;
179 struct dpp_bootstrap_info
*tmp_own_bi
;
180 u8 waiting_pubkey_hash
[SHA256_MAC_LEN
];
181 int response_pending
;
182 enum dpp_status_error auth_resp_status
;
183 enum dpp_status_error conf_resp_status
;
184 u8 peer_mac_addr
[ETH_ALEN
];
185 u8 i_nonce
[DPP_MAX_NONCE_LEN
];
186 u8 r_nonce
[DPP_MAX_NONCE_LEN
];
187 u8 e_nonce
[DPP_MAX_NONCE_LEN
];
190 EVP_PKEY
*own_protocol_key
;
191 EVP_PKEY
*peer_protocol_key
;
192 struct wpabuf
*req_msg
;
193 struct wpabuf
*resp_msg
;
194 /* Intersection of possible frequencies for initiating DPP
195 * Authentication exchange */
196 unsigned int freq
[DPP_BOOTSTRAP_MAX_FREQ
];
197 unsigned int num_freq
, freq_idx
;
198 unsigned int curr_freq
;
199 unsigned int neg_freq
;
200 unsigned int num_freq_iters
;
202 u8 Mx
[DPP_MAX_SHARED_SECRET_LEN
];
204 u8 Nx
[DPP_MAX_SHARED_SECRET_LEN
];
206 u8 Lx
[DPP_MAX_SHARED_SECRET_LEN
];
208 u8 k1
[DPP_MAX_HASH_LEN
];
209 u8 k2
[DPP_MAX_HASH_LEN
];
210 u8 ke
[DPP_MAX_HASH_LEN
];
212 int waiting_auth_resp
;
213 int waiting_auth_conf
;
215 unsigned int auth_resp_tries
;
218 int remove_on_tx_status
;
219 int connect_on_tx_status
;
220 int waiting_conf_result
;
222 struct wpabuf
*conf_req
;
223 const struct wpabuf
*conf_resp
; /* owned by GAS server */
224 struct dpp_configuration
*conf_ap
;
225 struct dpp_configuration
*conf_sta
;
226 struct dpp_configurator
*conf
;
227 char *connector
; /* received signedConnector */
228 u8 ssid
[SSID_MAX_LEN
];
234 struct wpabuf
*net_access_key
;
235 os_time_t net_access_key_expiry
;
236 struct wpabuf
*c_sign_key
;
237 #ifdef CONFIG_TESTING_OPTIONS
238 char *config_obj_override
;
239 char *discovery_override
;
240 char *groups_override
;
241 unsigned int ignore_netaccesskey_mismatch
:1;
242 #endif /* CONFIG_TESTING_OPTIONS */
245 struct dpp_configurator
{
251 const struct dpp_curve_params
*curve
;
254 struct dpp_introduction
{
260 #ifdef CONFIG_TESTING_OPTIONS
261 enum dpp_test_behavior
{
262 DPP_TEST_DISABLED
= 0,
263 DPP_TEST_AFTER_WRAPPED_DATA_AUTH_REQ
= 1,
264 DPP_TEST_AFTER_WRAPPED_DATA_AUTH_RESP
= 2,
265 DPP_TEST_AFTER_WRAPPED_DATA_AUTH_CONF
= 3,
266 DPP_TEST_AFTER_WRAPPED_DATA_PKEX_CR_REQ
= 4,
267 DPP_TEST_AFTER_WRAPPED_DATA_PKEX_CR_RESP
= 5,
268 DPP_TEST_AFTER_WRAPPED_DATA_CONF_REQ
= 6,
269 DPP_TEST_AFTER_WRAPPED_DATA_CONF_RESP
= 7,
270 DPP_TEST_ZERO_I_CAPAB
= 8,
271 DPP_TEST_ZERO_R_CAPAB
= 9,
272 DPP_TEST_NO_R_BOOTSTRAP_KEY_HASH_AUTH_REQ
= 10,
273 DPP_TEST_NO_I_BOOTSTRAP_KEY_HASH_AUTH_REQ
= 11,
274 DPP_TEST_NO_I_PROTO_KEY_AUTH_REQ
= 12,
275 DPP_TEST_NO_I_NONCE_AUTH_REQ
= 13,
276 DPP_TEST_NO_I_CAPAB_AUTH_REQ
= 14,
277 DPP_TEST_NO_WRAPPED_DATA_AUTH_REQ
= 15,
278 DPP_TEST_NO_STATUS_AUTH_RESP
= 16,
279 DPP_TEST_NO_R_BOOTSTRAP_KEY_HASH_AUTH_RESP
= 17,
280 DPP_TEST_NO_I_BOOTSTRAP_KEY_HASH_AUTH_RESP
= 18,
281 DPP_TEST_NO_R_PROTO_KEY_AUTH_RESP
= 19,
282 DPP_TEST_NO_R_NONCE_AUTH_RESP
= 20,
283 DPP_TEST_NO_I_NONCE_AUTH_RESP
= 21,
284 DPP_TEST_NO_R_CAPAB_AUTH_RESP
= 22,
285 DPP_TEST_NO_R_AUTH_AUTH_RESP
= 23,
286 DPP_TEST_NO_WRAPPED_DATA_AUTH_RESP
= 24,
287 DPP_TEST_NO_STATUS_AUTH_CONF
= 25,
288 DPP_TEST_NO_R_BOOTSTRAP_KEY_HASH_AUTH_CONF
= 26,
289 DPP_TEST_NO_I_BOOTSTRAP_KEY_HASH_AUTH_CONF
= 27,
290 DPP_TEST_NO_I_AUTH_AUTH_CONF
= 28,
291 DPP_TEST_NO_WRAPPED_DATA_AUTH_CONF
= 29,
292 DPP_TEST_I_NONCE_MISMATCH_AUTH_RESP
= 30,
293 DPP_TEST_INCOMPATIBLE_R_CAPAB_AUTH_RESP
= 31,
294 DPP_TEST_R_AUTH_MISMATCH_AUTH_RESP
= 32,
295 DPP_TEST_I_AUTH_MISMATCH_AUTH_CONF
= 33,
296 DPP_TEST_NO_FINITE_CYCLIC_GROUP_PKEX_EXCHANGE_REQ
= 34,
297 DPP_TEST_NO_ENCRYPTED_KEY_PKEX_EXCHANGE_REQ
= 35,
298 DPP_TEST_NO_STATUS_PKEX_EXCHANGE_RESP
= 36,
299 DPP_TEST_NO_ENCRYPTED_KEY_PKEX_EXCHANGE_RESP
= 37,
300 DPP_TEST_NO_BOOTSTRAP_KEY_PKEX_CR_REQ
= 38,
301 DPP_TEST_NO_I_AUTH_TAG_PKEX_CR_REQ
= 39,
302 DPP_TEST_NO_WRAPPED_DATA_PKEX_CR_REQ
= 40,
303 DPP_TEST_NO_BOOTSTRAP_KEY_PKEX_CR_RESP
= 41,
304 DPP_TEST_NO_R_AUTH_TAG_PKEX_CR_RESP
= 42,
305 DPP_TEST_NO_WRAPPED_DATA_PKEX_CR_RESP
= 43,
306 DPP_TEST_INVALID_ENCRYPTED_KEY_PKEX_EXCHANGE_REQ
= 44,
307 DPP_TEST_INVALID_ENCRYPTED_KEY_PKEX_EXCHANGE_RESP
= 45,
308 DPP_TEST_INVALID_STATUS_PKEX_EXCHANGE_RESP
= 46,
309 DPP_TEST_INVALID_BOOTSTRAP_KEY_PKEX_CR_REQ
= 47,
310 DPP_TEST_INVALID_BOOTSTRAP_KEY_PKEX_CR_RESP
= 48,
311 DPP_TEST_I_AUTH_TAG_MISMATCH_PKEX_CR_REQ
= 49,
312 DPP_TEST_R_AUTH_TAG_MISMATCH_PKEX_CR_RESP
= 50,
313 DPP_TEST_NO_E_NONCE_CONF_REQ
= 51,
314 DPP_TEST_NO_CONFIG_ATTR_OBJ_CONF_REQ
= 52,
315 DPP_TEST_NO_WRAPPED_DATA_CONF_REQ
= 53,
316 DPP_TEST_NO_E_NONCE_CONF_RESP
= 54,
317 DPP_TEST_NO_CONFIG_OBJ_CONF_RESP
= 55,
318 DPP_TEST_NO_STATUS_CONF_RESP
= 56,
319 DPP_TEST_NO_WRAPPED_DATA_CONF_RESP
= 57,
320 DPP_TEST_INVALID_STATUS_CONF_RESP
= 58,
321 DPP_TEST_E_NONCE_MISMATCH_CONF_RESP
= 59,
322 DPP_TEST_NO_TRANSACTION_ID_PEER_DISC_REQ
= 60,
323 DPP_TEST_NO_CONNECTOR_PEER_DISC_REQ
= 61,
324 DPP_TEST_NO_TRANSACTION_ID_PEER_DISC_RESP
= 62,
325 DPP_TEST_NO_STATUS_PEER_DISC_RESP
= 63,
326 DPP_TEST_NO_CONNECTOR_PEER_DISC_RESP
= 64,
327 DPP_TEST_AUTH_RESP_IN_PLACE_OF_CONF
= 65,
328 DPP_TEST_INVALID_I_PROTO_KEY_AUTH_REQ
= 66,
329 DPP_TEST_INVALID_R_PROTO_KEY_AUTH_RESP
= 67,
330 DPP_TEST_INVALID_R_BOOTSTRAP_KEY_HASH_AUTH_REQ
= 68,
331 DPP_TEST_INVALID_I_BOOTSTRAP_KEY_HASH_AUTH_REQ
= 69,
332 DPP_TEST_INVALID_R_BOOTSTRAP_KEY_HASH_AUTH_RESP
= 70,
333 DPP_TEST_INVALID_I_BOOTSTRAP_KEY_HASH_AUTH_RESP
= 71,
334 DPP_TEST_INVALID_R_BOOTSTRAP_KEY_HASH_AUTH_CONF
= 72,
335 DPP_TEST_INVALID_I_BOOTSTRAP_KEY_HASH_AUTH_CONF
= 73,
336 DPP_TEST_INVALID_STATUS_AUTH_RESP
= 74,
337 DPP_TEST_INVALID_STATUS_AUTH_CONF
= 75,
338 DPP_TEST_INVALID_CONFIG_ATTR_OBJ_CONF_REQ
= 76,
339 DPP_TEST_INVALID_TRANSACTION_ID_PEER_DISC_RESP
= 77,
340 DPP_TEST_INVALID_STATUS_PEER_DISC_RESP
= 78,
341 DPP_TEST_INVALID_CONNECTOR_PEER_DISC_RESP
= 79,
342 DPP_TEST_INVALID_CONNECTOR_PEER_DISC_REQ
= 80,
343 DPP_TEST_INVALID_I_NONCE_AUTH_REQ
= 81,
344 DPP_TEST_INVALID_TRANSACTION_ID_PEER_DISC_REQ
= 82,
345 DPP_TEST_INVALID_E_NONCE_CONF_REQ
= 83,
346 DPP_TEST_STOP_AT_PKEX_EXCHANGE_RESP
= 84,
347 DPP_TEST_STOP_AT_PKEX_CR_REQ
= 85,
348 DPP_TEST_STOP_AT_PKEX_CR_RESP
= 86,
349 DPP_TEST_STOP_AT_AUTH_REQ
= 87,
350 DPP_TEST_STOP_AT_AUTH_RESP
= 88,
351 DPP_TEST_STOP_AT_AUTH_CONF
= 89,
352 DPP_TEST_STOP_AT_CONF_REQ
= 90,
353 DPP_TEST_REJECT_CONFIG
= 91,
356 extern enum dpp_test_behavior dpp_test
;
357 extern u8 dpp_pkex_own_mac_override
[ETH_ALEN
];
358 extern u8 dpp_pkex_peer_mac_override
[ETH_ALEN
];
359 extern u8 dpp_pkex_ephemeral_key_override
[600];
360 extern size_t dpp_pkex_ephemeral_key_override_len
;
361 extern u8 dpp_protocol_key_override
[600];
362 extern size_t dpp_protocol_key_override_len
;
363 extern u8 dpp_nonce_override
[DPP_MAX_NONCE_LEN
];
364 extern size_t dpp_nonce_override_len
;
365 #endif /* CONFIG_TESTING_OPTIONS */
367 void dpp_bootstrap_info_free(struct dpp_bootstrap_info
*info
);
368 const char * dpp_bootstrap_type_txt(enum dpp_bootstrap_type type
);
369 int dpp_bootstrap_key_hash(struct dpp_bootstrap_info
*bi
);
370 int dpp_parse_uri_chan_list(struct dpp_bootstrap_info
*bi
,
371 const char *chan_list
);
372 int dpp_parse_uri_mac(struct dpp_bootstrap_info
*bi
, const char *mac
);
373 int dpp_parse_uri_info(struct dpp_bootstrap_info
*bi
, const char *info
);
374 struct dpp_bootstrap_info
* dpp_parse_qr_code(const char *uri
);
375 char * dpp_keygen(struct dpp_bootstrap_info
*bi
, const char *curve
,
376 const u8
*privkey
, size_t privkey_len
);
377 struct hostapd_hw_modes
;
378 struct dpp_authentication
* dpp_auth_init(void *msg_ctx
,
379 struct dpp_bootstrap_info
*peer_bi
,
380 struct dpp_bootstrap_info
*own_bi
,
381 u8 dpp_allowed_roles
,
382 unsigned int neg_freq
,
383 struct hostapd_hw_modes
*own_modes
,
385 struct dpp_authentication
*
386 dpp_auth_req_rx(void *msg_ctx
, u8 dpp_allowed_roles
, int qr_mutual
,
387 struct dpp_bootstrap_info
*peer_bi
,
388 struct dpp_bootstrap_info
*own_bi
,
389 unsigned int freq
, const u8
*hdr
, const u8
*attr_start
,
392 dpp_auth_resp_rx(struct dpp_authentication
*auth
, const u8
*hdr
,
393 const u8
*attr_start
, size_t attr_len
);
394 struct wpabuf
* dpp_build_conf_req(struct dpp_authentication
*auth
,
396 int dpp_auth_conf_rx(struct dpp_authentication
*auth
, const u8
*hdr
,
397 const u8
*attr_start
, size_t attr_len
);
398 int dpp_notify_new_qr_code(struct dpp_authentication
*auth
,
399 struct dpp_bootstrap_info
*peer_bi
);
400 struct dpp_configuration
* dpp_configuration_alloc(const char *type
);
401 int dpp_akm_psk(enum dpp_akm akm
);
402 int dpp_akm_sae(enum dpp_akm akm
);
403 int dpp_akm_legacy(enum dpp_akm akm
);
404 int dpp_akm_dpp(enum dpp_akm akm
);
405 int dpp_akm_ver2(enum dpp_akm akm
);
406 int dpp_configuration_valid(const struct dpp_configuration
*conf
);
407 void dpp_configuration_free(struct dpp_configuration
*conf
);
408 int dpp_configuration_parse(struct dpp_authentication
*auth
, const char *cmd
);
409 void dpp_auth_deinit(struct dpp_authentication
*auth
);
411 dpp_conf_req_rx(struct dpp_authentication
*auth
, const u8
*attr_start
,
413 int dpp_conf_resp_rx(struct dpp_authentication
*auth
,
414 const struct wpabuf
*resp
);
415 enum dpp_status_error
dpp_conf_result_rx(struct dpp_authentication
*auth
,
417 const u8
*attr_start
, size_t attr_len
);
418 struct wpabuf
* dpp_build_conf_result(struct dpp_authentication
*auth
,
419 enum dpp_status_error status
);
420 struct wpabuf
* dpp_alloc_msg(enum dpp_public_action_frame_type type
,
422 const u8
* dpp_get_attr(const u8
*buf
, size_t len
, u16 req_id
, u16
*ret_len
);
423 int dpp_check_attrs(const u8
*buf
, size_t len
);
424 int dpp_key_expired(const char *timestamp
, os_time_t
*expiry
);
425 const char * dpp_akm_str(enum dpp_akm akm
);
426 int dpp_configurator_get_key(const struct dpp_configurator
*conf
, char *buf
,
428 void dpp_configurator_free(struct dpp_configurator
*conf
);
429 struct dpp_configurator
*
430 dpp_keygen_configurator(const char *curve
, const u8
*privkey
,
432 int dpp_configurator_own_config(struct dpp_authentication
*auth
,
433 const char *curve
, int ap
);
434 enum dpp_status_error
435 dpp_peer_intro(struct dpp_introduction
*intro
, const char *own_connector
,
436 const u8
*net_access_key
, size_t net_access_key_len
,
437 const u8
*csign_key
, size_t csign_key_len
,
438 const u8
*peer_connector
, size_t peer_connector_len
,
440 struct dpp_pkex
* dpp_pkex_init(void *msg_ctx
, struct dpp_bootstrap_info
*bi
,
442 const char *identifier
,
444 struct dpp_pkex
* dpp_pkex_rx_exchange_req(void *msg_ctx
,
445 struct dpp_bootstrap_info
*bi
,
448 const char *identifier
,
450 const u8
*buf
, size_t len
);
451 struct wpabuf
* dpp_pkex_rx_exchange_resp(struct dpp_pkex
*pkex
,
453 const u8
*buf
, size_t len
);
454 struct wpabuf
* dpp_pkex_rx_commit_reveal_req(struct dpp_pkex
*pkex
,
456 const u8
*buf
, size_t len
);
457 int dpp_pkex_rx_commit_reveal_resp(struct dpp_pkex
*pkex
, const u8
*hdr
,
458 const u8
*buf
, size_t len
);
459 void dpp_pkex_free(struct dpp_pkex
*pkex
);
461 char * dpp_corrupt_connector_signature(const char *connector
);
465 struct crypto_ecdh
*ecdh
;
466 const struct dpp_curve_params
*curve
;
468 struct wpabuf
*secret
;
471 struct dpp_pfs
* dpp_pfs_init(const u8
*net_access_key
,
472 size_t net_access_key_len
);
473 int dpp_pfs_process(struct dpp_pfs
*pfs
, const u8
*peer_ie
, size_t peer_ie_len
);
474 void dpp_pfs_free(struct dpp_pfs
*pfs
);