1 /* 2 * DPP functionality shared between hostapd and wpa_supplicant 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_H 11 #define DPP_H 12 13 #ifdef CONFIG_DPP 14 #include "utils/list.h" 15 #include "common/wpa_common.h" 16 #include "crypto/sha256.h" 17 #include "crypto/crypto.h" 18 19 struct hostapd_ip_addr; 20 struct dpp_global; 21 struct json_token; 22 struct dpp_reconfig_id; 23 24 #ifdef CONFIG_TESTING_OPTIONS 25 #define DPP_VERSION (dpp_version_override) 26 extern int dpp_version_override; 27 #else /* CONFIG_TESTING_OPTIONS */ 28 #ifdef CONFIG_DPP3 29 #define DPP_VERSION 3 30 #elif defined(CONFIG_DPP2) 31 #define DPP_VERSION 2 32 #else 33 #define DPP_VERSION 1 34 #endif 35 #endif /* CONFIG_TESTING_OPTIONS */ 36 37 #define DPP_HDR_LEN (4 + 2) /* OUI, OUI Type, Crypto Suite, DPP frame type */ 38 #define DPP_TCP_PORT 8908 39 40 enum dpp_public_action_frame_type { 41 DPP_PA_AUTHENTICATION_REQ = 0, 42 DPP_PA_AUTHENTICATION_RESP = 1, 43 DPP_PA_AUTHENTICATION_CONF = 2, 44 DPP_PA_PEER_DISCOVERY_REQ = 5, 45 DPP_PA_PEER_DISCOVERY_RESP = 6, 46 DPP_PA_PKEX_V1_EXCHANGE_REQ = 7, 47 DPP_PA_PKEX_EXCHANGE_RESP = 8, 48 DPP_PA_PKEX_COMMIT_REVEAL_REQ = 9, 49 DPP_PA_PKEX_COMMIT_REVEAL_RESP = 10, 50 DPP_PA_CONFIGURATION_RESULT = 11, 51 DPP_PA_CONNECTION_STATUS_RESULT = 12, 52 DPP_PA_PRESENCE_ANNOUNCEMENT = 13, 53 DPP_PA_RECONFIG_ANNOUNCEMENT = 14, 54 DPP_PA_RECONFIG_AUTH_REQ = 15, 55 DPP_PA_RECONFIG_AUTH_RESP = 16, 56 DPP_PA_RECONFIG_AUTH_CONF = 17, 57 DPP_PA_PKEX_EXCHANGE_REQ = 18, 58 }; 59 60 enum dpp_attribute_id { 61 DPP_ATTR_STATUS = 0x1000, 62 DPP_ATTR_I_BOOTSTRAP_KEY_HASH = 0x1001, 63 DPP_ATTR_R_BOOTSTRAP_KEY_HASH = 0x1002, 64 DPP_ATTR_I_PROTOCOL_KEY = 0x1003, 65 DPP_ATTR_WRAPPED_DATA = 0x1004, 66 DPP_ATTR_I_NONCE = 0x1005, 67 DPP_ATTR_I_CAPABILITIES = 0x1006, 68 DPP_ATTR_R_NONCE = 0x1007, 69 DPP_ATTR_R_CAPABILITIES = 0x1008, 70 DPP_ATTR_R_PROTOCOL_KEY = 0x1009, 71 DPP_ATTR_I_AUTH_TAG = 0x100A, 72 DPP_ATTR_R_AUTH_TAG = 0x100B, 73 DPP_ATTR_CONFIG_OBJ = 0x100C, 74 DPP_ATTR_CONNECTOR = 0x100D, 75 DPP_ATTR_CONFIG_ATTR_OBJ = 0x100E, 76 DPP_ATTR_BOOTSTRAP_KEY = 0x100F, 77 DPP_ATTR_OWN_NET_NK_HASH = 0x1011, 78 DPP_ATTR_FINITE_CYCLIC_GROUP = 0x1012, 79 DPP_ATTR_ENCRYPTED_KEY = 0x1013, 80 DPP_ATTR_ENROLLEE_NONCE = 0x1014, 81 DPP_ATTR_CODE_IDENTIFIER = 0x1015, 82 DPP_ATTR_TRANSACTION_ID = 0x1016, 83 DPP_ATTR_BOOTSTRAP_INFO = 0x1017, 84 DPP_ATTR_CHANNEL = 0x1018, 85 DPP_ATTR_PROTOCOL_VERSION = 0x1019, 86 DPP_ATTR_ENVELOPED_DATA = 0x101A, 87 DPP_ATTR_SEND_CONN_STATUS = 0x101B, 88 DPP_ATTR_CONN_STATUS = 0x101C, 89 DPP_ATTR_RECONFIG_FLAGS = 0x101D, 90 DPP_ATTR_C_SIGN_KEY_HASH = 0x101E, 91 DPP_ATTR_CSR_ATTR_REQ = 0x101F, 92 DPP_ATTR_A_NONCE = 0x1020, 93 DPP_ATTR_E_PRIME_ID = 0x1021, 94 DPP_ATTR_CONFIGURATOR_NONCE = 0x1022, 95 }; 96 97 enum dpp_status_error { 98 DPP_STATUS_OK = 0, 99 DPP_STATUS_NOT_COMPATIBLE = 1, 100 DPP_STATUS_AUTH_FAILURE = 2, 101 DPP_STATUS_UNWRAP_FAILURE = 3, 102 DPP_STATUS_BAD_GROUP = 4, 103 DPP_STATUS_CONFIGURE_FAILURE = 5, 104 DPP_STATUS_RESPONSE_PENDING = 6, 105 DPP_STATUS_INVALID_CONNECTOR = 7, 106 DPP_STATUS_NO_MATCH = 8, 107 DPP_STATUS_CONFIG_REJECTED = 9, 108 DPP_STATUS_NO_AP = 10, 109 DPP_STATUS_CONFIGURE_PENDING = 11, 110 DPP_STATUS_CSR_NEEDED = 12, 111 DPP_STATUS_CSR_BAD = 13, 112 }; 113 114 /* DPP Reconfig Flags object - connectorKey values */ 115 enum dpp_connector_key { 116 DPP_CONFIG_REUSEKEY = 0, 117 DPP_CONFIG_REPLACEKEY = 1, 118 }; 119 120 #define DPP_CAPAB_ENROLLEE BIT(0) 121 #define DPP_CAPAB_CONFIGURATOR BIT(1) 122 #define DPP_CAPAB_ROLE_MASK (BIT(0) | BIT(1)) 123 124 #define DPP_BOOTSTRAP_MAX_FREQ 30 125 #define DPP_MAX_NONCE_LEN 32 126 #define DPP_MAX_HASH_LEN 64 127 #define DPP_MAX_SHARED_SECRET_LEN 66 128 #define DPP_CP_LEN 64 129 130 struct dpp_curve_params { 131 const char *name; 132 size_t hash_len; 133 size_t aes_siv_key_len; 134 size_t nonce_len; 135 size_t prime_len; 136 const char *jwk_crv; 137 u16 ike_group; 138 const char *jws_alg; 139 }; 140 141 enum dpp_bootstrap_type { 142 DPP_BOOTSTRAP_QR_CODE, 143 DPP_BOOTSTRAP_PKEX, 144 DPP_BOOTSTRAP_NFC_URI, 145 }; 146 147 struct dpp_bootstrap_info { 148 struct dl_list list; 149 unsigned int id; 150 enum dpp_bootstrap_type type; 151 char *uri; 152 u8 mac_addr[ETH_ALEN]; 153 char *chan; 154 char *info; 155 char *pk; 156 unsigned int freq[DPP_BOOTSTRAP_MAX_FREQ]; 157 unsigned int num_freq; 158 bool channels_listed; 159 u8 version; 160 int own; 161 struct crypto_ec_key *pubkey; 162 u8 pubkey_hash[SHA256_MAC_LEN]; 163 u8 pubkey_hash_chirp[SHA256_MAC_LEN]; 164 const struct dpp_curve_params *curve; 165 unsigned int pkex_t; /* number of failures before dpp_pkex 166 * instantiation */ 167 int nfc_negotiated; /* whether this has been used in NFC negotiated 168 * connection handover */ 169 char *configurator_params; 170 }; 171 172 #define PKEX_COUNTER_T_LIMIT 5 173 174 struct dpp_pkex { 175 void *msg_ctx; 176 unsigned int initiator:1; 177 unsigned int exchange_done:1; 178 unsigned int failed:1; 179 unsigned int v2:1; 180 struct dpp_bootstrap_info *own_bi; 181 u8 own_mac[ETH_ALEN]; 182 u8 peer_mac[ETH_ALEN]; 183 char *identifier; 184 char *code; 185 struct crypto_ec_key *x; 186 struct crypto_ec_key *y; 187 u8 Mx[DPP_MAX_SHARED_SECRET_LEN]; 188 u8 Nx[DPP_MAX_SHARED_SECRET_LEN]; 189 u8 z[DPP_MAX_HASH_LEN]; 190 struct crypto_ec_key *peer_bootstrap_key; 191 struct wpabuf *exchange_req; 192 struct wpabuf *exchange_resp; 193 unsigned int t; /* number of failures on code use */ 194 unsigned int exch_req_wait_time; 195 unsigned int exch_req_tries; 196 unsigned int freq; 197 u8 peer_version; 198 }; 199 200 enum dpp_akm { 201 DPP_AKM_UNKNOWN, 202 DPP_AKM_DPP, 203 DPP_AKM_PSK, 204 DPP_AKM_SAE, 205 DPP_AKM_PSK_SAE, 206 DPP_AKM_SAE_DPP, 207 DPP_AKM_PSK_SAE_DPP, 208 DPP_AKM_DOT1X, 209 }; 210 211 enum dpp_netrole { 212 DPP_NETROLE_STA, 213 DPP_NETROLE_AP, 214 DPP_NETROLE_CONFIGURATOR, 215 }; 216 217 struct dpp_configuration { 218 u8 ssid[32]; 219 size_t ssid_len; 220 int ssid_charset; 221 enum dpp_akm akm; 222 enum dpp_netrole netrole; 223 224 /* For DPP configuration (connector) */ 225 os_time_t netaccesskey_expiry; 226 227 /* TODO: groups */ 228 char *group_id; 229 230 /* For legacy configuration */ 231 char *passphrase; 232 u8 psk[32]; 233 int psk_set; 234 235 char *csrattrs; 236 }; 237 238 struct dpp_asymmetric_key { 239 struct dpp_asymmetric_key *next; 240 struct crypto_ec_key *csign; 241 struct crypto_ec_key *pp_key; 242 char *config_template; 243 char *connector_template; 244 }; 245 246 #define DPP_MAX_CONF_OBJ 10 247 248 struct dpp_authentication { 249 struct dpp_global *global; 250 void *msg_ctx; 251 u8 peer_version; 252 const struct dpp_curve_params *curve; 253 struct dpp_bootstrap_info *peer_bi; 254 struct dpp_bootstrap_info *own_bi; 255 struct dpp_bootstrap_info *tmp_own_bi; 256 struct dpp_bootstrap_info *tmp_peer_bi; 257 u8 waiting_pubkey_hash[SHA256_MAC_LEN]; 258 int response_pending; 259 int reconfig; 260 enum dpp_connector_key reconfig_connector_key; 261 enum dpp_status_error auth_resp_status; 262 enum dpp_status_error conf_resp_status; 263 enum dpp_status_error force_conf_resp_status; 264 u8 peer_mac_addr[ETH_ALEN]; 265 u8 i_nonce[DPP_MAX_NONCE_LEN]; 266 u8 r_nonce[DPP_MAX_NONCE_LEN]; 267 u8 e_nonce[DPP_MAX_NONCE_LEN]; 268 u8 c_nonce[DPP_MAX_NONCE_LEN]; 269 u8 i_capab; 270 u8 r_capab; 271 enum dpp_netrole e_netrole; 272 struct crypto_ec_key *own_protocol_key; 273 struct crypto_ec_key *peer_protocol_key; 274 struct crypto_ec_key *reconfig_old_protocol_key; 275 struct wpabuf *req_msg; 276 struct wpabuf *resp_msg; 277 struct wpabuf *reconfig_req_msg; 278 struct wpabuf *reconfig_resp_msg; 279 /* Intersection of possible frequencies for initiating DPP 280 * Authentication exchange */ 281 unsigned int freq[DPP_BOOTSTRAP_MAX_FREQ]; 282 unsigned int num_freq, freq_idx; 283 unsigned int curr_freq; 284 unsigned int neg_freq; 285 unsigned int num_freq_iters; 286 size_t secret_len; 287 u8 Mx[DPP_MAX_SHARED_SECRET_LEN]; 288 size_t Mx_len; 289 u8 Nx[DPP_MAX_SHARED_SECRET_LEN]; 290 size_t Nx_len; 291 u8 Lx[DPP_MAX_SHARED_SECRET_LEN]; 292 size_t Lx_len; 293 u8 k1[DPP_MAX_HASH_LEN]; 294 u8 k2[DPP_MAX_HASH_LEN]; 295 u8 ke[DPP_MAX_HASH_LEN]; 296 u8 bk[DPP_MAX_HASH_LEN]; 297 int initiator; 298 int waiting_auth_resp; 299 int waiting_auth_conf; 300 int auth_req_ack; 301 unsigned int auth_resp_tries; 302 u8 allowed_roles; 303 int configurator; 304 int remove_on_tx_status; 305 int connect_on_tx_status; 306 int waiting_conf_result; 307 int waiting_conn_status_result; 308 int auth_success; 309 bool reconfig_success; 310 struct wpabuf *conf_req; 311 const struct wpabuf *conf_resp; /* owned by GAS server */ 312 struct wpabuf *conf_resp_tcp; 313 struct dpp_configuration *conf_ap; 314 struct dpp_configuration *conf2_ap; 315 struct dpp_configuration *conf_sta; 316 struct dpp_configuration *conf2_sta; 317 int provision_configurator; 318 struct dpp_configurator *conf; 319 struct dpp_config_obj { 320 char *connector; /* received signedConnector */ 321 u8 ssid[SSID_MAX_LEN]; 322 u8 ssid_len; 323 int ssid_charset; 324 char passphrase[64]; 325 u8 psk[PMK_LEN]; 326 int psk_set; 327 enum dpp_akm akm; 328 struct wpabuf *c_sign_key; 329 struct wpabuf *certbag; 330 struct wpabuf *certs; 331 struct wpabuf *cacert; 332 char *server_name; 333 struct wpabuf *pp_key; 334 } conf_obj[DPP_MAX_CONF_OBJ]; 335 unsigned int num_conf_obj; 336 struct dpp_asymmetric_key *conf_key_pkg; 337 struct wpabuf *net_access_key; 338 os_time_t net_access_key_expiry; 339 int send_conn_status; 340 int conn_status_requested; 341 int akm_use_selector; 342 int configurator_set; 343 u8 transaction_id; 344 u8 *csrattrs; 345 size_t csrattrs_len; 346 bool waiting_csr; 347 struct wpabuf *csr; 348 struct wpabuf *priv_key; /* DER-encoded private key used for csr */ 349 bool waiting_cert; 350 char *trusted_eap_server_name; 351 struct wpabuf *cacert; 352 struct wpabuf *certbag; 353 void *cert_resp_ctx; 354 void *gas_server_ctx; 355 #ifdef CONFIG_TESTING_OPTIONS 356 char *config_obj_override; 357 char *discovery_override; 358 char *groups_override; 359 unsigned int ignore_netaccesskey_mismatch:1; 360 #endif /* CONFIG_TESTING_OPTIONS */ 361 }; 362 363 struct dpp_configurator { 364 struct dl_list list; 365 unsigned int id; 366 int own; 367 struct crypto_ec_key *csign; 368 u8 kid_hash[SHA256_MAC_LEN]; 369 char *kid; 370 const struct dpp_curve_params *curve; 371 char *connector; /* own Connector for reconfiguration */ 372 struct crypto_ec_key *connector_key; 373 struct crypto_ec_key *pp_key; 374 }; 375 376 struct dpp_introduction { 377 u8 pmkid[PMKID_LEN]; 378 u8 pmk[PMK_LEN_MAX]; 379 size_t pmk_len; 380 int peer_version; 381 }; 382 383 struct dpp_relay_config { 384 const struct hostapd_ip_addr *ipaddr; 385 const u8 *pkhash; 386 387 void *msg_ctx; 388 void *cb_ctx; 389 void (*tx)(void *ctx, const u8 *addr, unsigned int freq, const u8 *msg, 390 size_t len); 391 void (*gas_resp_tx)(void *ctx, const u8 *addr, u8 dialog_token, int prot, 392 struct wpabuf *buf); 393 }; 394 395 struct dpp_controller_config { 396 const char *configurator_params; 397 int tcp_port; 398 u8 allowed_roles; 399 int qr_mutual; 400 enum dpp_netrole netrole; 401 void *msg_ctx; 402 void *cb_ctx; 403 int (*process_conf_obj)(void *ctx, struct dpp_authentication *auth); 404 }; 405 406 #ifdef CONFIG_TESTING_OPTIONS 407 enum dpp_test_behavior { 408 DPP_TEST_DISABLED = 0, 409 DPP_TEST_AFTER_WRAPPED_DATA_AUTH_REQ = 1, 410 DPP_TEST_AFTER_WRAPPED_DATA_AUTH_RESP = 2, 411 DPP_TEST_AFTER_WRAPPED_DATA_AUTH_CONF = 3, 412 DPP_TEST_AFTER_WRAPPED_DATA_PKEX_CR_REQ = 4, 413 DPP_TEST_AFTER_WRAPPED_DATA_PKEX_CR_RESP = 5, 414 DPP_TEST_AFTER_WRAPPED_DATA_CONF_REQ = 6, 415 DPP_TEST_AFTER_WRAPPED_DATA_CONF_RESP = 7, 416 DPP_TEST_ZERO_I_CAPAB = 8, 417 DPP_TEST_ZERO_R_CAPAB = 9, 418 DPP_TEST_NO_R_BOOTSTRAP_KEY_HASH_AUTH_REQ = 10, 419 DPP_TEST_NO_I_BOOTSTRAP_KEY_HASH_AUTH_REQ = 11, 420 DPP_TEST_NO_I_PROTO_KEY_AUTH_REQ = 12, 421 DPP_TEST_NO_I_NONCE_AUTH_REQ = 13, 422 DPP_TEST_NO_I_CAPAB_AUTH_REQ = 14, 423 DPP_TEST_NO_WRAPPED_DATA_AUTH_REQ = 15, 424 DPP_TEST_NO_STATUS_AUTH_RESP = 16, 425 DPP_TEST_NO_R_BOOTSTRAP_KEY_HASH_AUTH_RESP = 17, 426 DPP_TEST_NO_I_BOOTSTRAP_KEY_HASH_AUTH_RESP = 18, 427 DPP_TEST_NO_R_PROTO_KEY_AUTH_RESP = 19, 428 DPP_TEST_NO_R_NONCE_AUTH_RESP = 20, 429 DPP_TEST_NO_I_NONCE_AUTH_RESP = 21, 430 DPP_TEST_NO_R_CAPAB_AUTH_RESP = 22, 431 DPP_TEST_NO_R_AUTH_AUTH_RESP = 23, 432 DPP_TEST_NO_WRAPPED_DATA_AUTH_RESP = 24, 433 DPP_TEST_NO_STATUS_AUTH_CONF = 25, 434 DPP_TEST_NO_R_BOOTSTRAP_KEY_HASH_AUTH_CONF = 26, 435 DPP_TEST_NO_I_BOOTSTRAP_KEY_HASH_AUTH_CONF = 27, 436 DPP_TEST_NO_I_AUTH_AUTH_CONF = 28, 437 DPP_TEST_NO_WRAPPED_DATA_AUTH_CONF = 29, 438 DPP_TEST_I_NONCE_MISMATCH_AUTH_RESP = 30, 439 DPP_TEST_INCOMPATIBLE_R_CAPAB_AUTH_RESP = 31, 440 DPP_TEST_R_AUTH_MISMATCH_AUTH_RESP = 32, 441 DPP_TEST_I_AUTH_MISMATCH_AUTH_CONF = 33, 442 DPP_TEST_NO_FINITE_CYCLIC_GROUP_PKEX_EXCHANGE_REQ = 34, 443 DPP_TEST_NO_ENCRYPTED_KEY_PKEX_EXCHANGE_REQ = 35, 444 DPP_TEST_NO_STATUS_PKEX_EXCHANGE_RESP = 36, 445 DPP_TEST_NO_ENCRYPTED_KEY_PKEX_EXCHANGE_RESP = 37, 446 DPP_TEST_NO_BOOTSTRAP_KEY_PKEX_CR_REQ = 38, 447 DPP_TEST_NO_I_AUTH_TAG_PKEX_CR_REQ = 39, 448 DPP_TEST_NO_WRAPPED_DATA_PKEX_CR_REQ = 40, 449 DPP_TEST_NO_BOOTSTRAP_KEY_PKEX_CR_RESP = 41, 450 DPP_TEST_NO_R_AUTH_TAG_PKEX_CR_RESP = 42, 451 DPP_TEST_NO_WRAPPED_DATA_PKEX_CR_RESP = 43, 452 DPP_TEST_INVALID_ENCRYPTED_KEY_PKEX_EXCHANGE_REQ = 44, 453 DPP_TEST_INVALID_ENCRYPTED_KEY_PKEX_EXCHANGE_RESP = 45, 454 DPP_TEST_INVALID_STATUS_PKEX_EXCHANGE_RESP = 46, 455 DPP_TEST_INVALID_BOOTSTRAP_KEY_PKEX_CR_REQ = 47, 456 DPP_TEST_INVALID_BOOTSTRAP_KEY_PKEX_CR_RESP = 48, 457 DPP_TEST_I_AUTH_TAG_MISMATCH_PKEX_CR_REQ = 49, 458 DPP_TEST_R_AUTH_TAG_MISMATCH_PKEX_CR_RESP = 50, 459 DPP_TEST_NO_E_NONCE_CONF_REQ = 51, 460 DPP_TEST_NO_CONFIG_ATTR_OBJ_CONF_REQ = 52, 461 DPP_TEST_NO_WRAPPED_DATA_CONF_REQ = 53, 462 DPP_TEST_NO_E_NONCE_CONF_RESP = 54, 463 DPP_TEST_NO_CONFIG_OBJ_CONF_RESP = 55, 464 DPP_TEST_NO_STATUS_CONF_RESP = 56, 465 DPP_TEST_NO_WRAPPED_DATA_CONF_RESP = 57, 466 DPP_TEST_INVALID_STATUS_CONF_RESP = 58, 467 DPP_TEST_E_NONCE_MISMATCH_CONF_RESP = 59, 468 DPP_TEST_NO_TRANSACTION_ID_PEER_DISC_REQ = 60, 469 DPP_TEST_NO_CONNECTOR_PEER_DISC_REQ = 61, 470 DPP_TEST_NO_TRANSACTION_ID_PEER_DISC_RESP = 62, 471 DPP_TEST_NO_STATUS_PEER_DISC_RESP = 63, 472 DPP_TEST_NO_CONNECTOR_PEER_DISC_RESP = 64, 473 DPP_TEST_AUTH_RESP_IN_PLACE_OF_CONF = 65, 474 DPP_TEST_INVALID_I_PROTO_KEY_AUTH_REQ = 66, 475 DPP_TEST_INVALID_R_PROTO_KEY_AUTH_RESP = 67, 476 DPP_TEST_INVALID_R_BOOTSTRAP_KEY_HASH_AUTH_REQ = 68, 477 DPP_TEST_INVALID_I_BOOTSTRAP_KEY_HASH_AUTH_REQ = 69, 478 DPP_TEST_INVALID_R_BOOTSTRAP_KEY_HASH_AUTH_RESP = 70, 479 DPP_TEST_INVALID_I_BOOTSTRAP_KEY_HASH_AUTH_RESP = 71, 480 DPP_TEST_INVALID_R_BOOTSTRAP_KEY_HASH_AUTH_CONF = 72, 481 DPP_TEST_INVALID_I_BOOTSTRAP_KEY_HASH_AUTH_CONF = 73, 482 DPP_TEST_INVALID_STATUS_AUTH_RESP = 74, 483 DPP_TEST_INVALID_STATUS_AUTH_CONF = 75, 484 DPP_TEST_INVALID_CONFIG_ATTR_OBJ_CONF_REQ = 76, 485 DPP_TEST_INVALID_TRANSACTION_ID_PEER_DISC_RESP = 77, 486 DPP_TEST_INVALID_STATUS_PEER_DISC_RESP = 78, 487 DPP_TEST_INVALID_CONNECTOR_PEER_DISC_RESP = 79, 488 DPP_TEST_INVALID_CONNECTOR_PEER_DISC_REQ = 80, 489 DPP_TEST_INVALID_I_NONCE_AUTH_REQ = 81, 490 DPP_TEST_INVALID_TRANSACTION_ID_PEER_DISC_REQ = 82, 491 DPP_TEST_INVALID_E_NONCE_CONF_REQ = 83, 492 DPP_TEST_STOP_AT_PKEX_EXCHANGE_RESP = 84, 493 DPP_TEST_STOP_AT_PKEX_CR_REQ = 85, 494 DPP_TEST_STOP_AT_PKEX_CR_RESP = 86, 495 DPP_TEST_STOP_AT_AUTH_REQ = 87, 496 DPP_TEST_STOP_AT_AUTH_RESP = 88, 497 DPP_TEST_STOP_AT_AUTH_CONF = 89, 498 DPP_TEST_STOP_AT_CONF_REQ = 90, 499 DPP_TEST_REJECT_CONFIG = 91, 500 DPP_TEST_NO_PROTOCOL_VERSION_PEER_DISC_REQ = 92, 501 DPP_TEST_NO_PROTOCOL_VERSION_PEER_DISC_RESP = 93, 502 }; 503 504 extern enum dpp_test_behavior dpp_test; 505 extern u8 dpp_pkex_own_mac_override[ETH_ALEN]; 506 extern u8 dpp_pkex_peer_mac_override[ETH_ALEN]; 507 extern u8 dpp_pkex_ephemeral_key_override[600]; 508 extern size_t dpp_pkex_ephemeral_key_override_len; 509 extern u8 dpp_protocol_key_override[600]; 510 extern size_t dpp_protocol_key_override_len; 511 extern u8 dpp_nonce_override[DPP_MAX_NONCE_LEN]; 512 extern size_t dpp_nonce_override_len; 513 #endif /* CONFIG_TESTING_OPTIONS */ 514 515 void dpp_bootstrap_info_free(struct dpp_bootstrap_info *info); 516 const char * dpp_bootstrap_type_txt(enum dpp_bootstrap_type type); 517 int dpp_parse_uri_chan_list(struct dpp_bootstrap_info *bi, 518 const char *chan_list); 519 int dpp_parse_uri_mac(struct dpp_bootstrap_info *bi, const char *mac); 520 int dpp_parse_uri_info(struct dpp_bootstrap_info *bi, const char *info); 521 int dpp_nfc_update_bi(struct dpp_bootstrap_info *own_bi, 522 struct dpp_bootstrap_info *peer_bi); 523 struct dpp_authentication * 524 dpp_alloc_auth(struct dpp_global *dpp, void *msg_ctx); 525 struct hostapd_hw_modes; 526 struct dpp_authentication * dpp_auth_init(struct dpp_global *dpp, void *msg_ctx, 527 struct dpp_bootstrap_info *peer_bi, 528 struct dpp_bootstrap_info *own_bi, 529 u8 dpp_allowed_roles, 530 unsigned int neg_freq, 531 struct hostapd_hw_modes *own_modes, 532 u16 num_modes); 533 struct dpp_authentication * 534 dpp_auth_req_rx(struct dpp_global *dpp, void *msg_ctx, u8 dpp_allowed_roles, 535 int qr_mutual, struct dpp_bootstrap_info *peer_bi, 536 struct dpp_bootstrap_info *own_bi, 537 unsigned int freq, const u8 *hdr, const u8 *attr_start, 538 size_t attr_len); 539 struct wpabuf * 540 dpp_auth_resp_rx(struct dpp_authentication *auth, const u8 *hdr, 541 const u8 *attr_start, size_t attr_len); 542 struct wpabuf * dpp_build_conf_req(struct dpp_authentication *auth, 543 const char *json); 544 struct wpabuf * dpp_build_conf_req_helper(struct dpp_authentication *auth, 545 const char *name, 546 enum dpp_netrole netrole, 547 const char *mud_url, int *opclasses); 548 int dpp_auth_conf_rx(struct dpp_authentication *auth, const u8 *hdr, 549 const u8 *attr_start, size_t attr_len); 550 int dpp_notify_new_qr_code(struct dpp_authentication *auth, 551 struct dpp_bootstrap_info *peer_bi); 552 struct dpp_configuration * dpp_configuration_alloc(const char *type); 553 int dpp_akm_psk(enum dpp_akm akm); 554 int dpp_akm_sae(enum dpp_akm akm); 555 int dpp_akm_legacy(enum dpp_akm akm); 556 int dpp_akm_dpp(enum dpp_akm akm); 557 int dpp_akm_ver2(enum dpp_akm akm); 558 int dpp_configuration_valid(const struct dpp_configuration *conf); 559 void dpp_configuration_free(struct dpp_configuration *conf); 560 int dpp_set_configurator(struct dpp_authentication *auth, const char *cmd); 561 void dpp_auth_deinit(struct dpp_authentication *auth); 562 struct wpabuf * 563 dpp_build_conf_resp(struct dpp_authentication *auth, const u8 *e_nonce, 564 u16 e_nonce_len, enum dpp_netrole netrole, 565 bool cert_req); 566 struct wpabuf * 567 dpp_conf_req_rx(struct dpp_authentication *auth, const u8 *attr_start, 568 size_t attr_len); 569 int dpp_conf_resp_rx(struct dpp_authentication *auth, 570 const struct wpabuf *resp); 571 enum dpp_status_error dpp_conf_result_rx(struct dpp_authentication *auth, 572 const u8 *hdr, 573 const u8 *attr_start, size_t attr_len); 574 struct wpabuf * dpp_build_conf_result(struct dpp_authentication *auth, 575 enum dpp_status_error status); 576 enum dpp_status_error dpp_conn_status_result_rx(struct dpp_authentication *auth, 577 const u8 *hdr, 578 const u8 *attr_start, 579 size_t attr_len, 580 u8 *ssid, size_t *ssid_len, 581 char **channel_list); 582 struct wpabuf * dpp_build_conn_status_result(struct dpp_authentication *auth, 583 enum dpp_status_error result, 584 const u8 *ssid, size_t ssid_len, 585 const char *channel_list); 586 struct wpabuf * dpp_alloc_msg(enum dpp_public_action_frame_type type, 587 size_t len); 588 const u8 * dpp_get_attr(const u8 *buf, size_t len, u16 req_id, u16 *ret_len); 589 int dpp_check_attrs(const u8 *buf, size_t len); 590 int dpp_key_expired(const char *timestamp, os_time_t *expiry); 591 const char * dpp_akm_str(enum dpp_akm akm); 592 const char * dpp_akm_selector_str(enum dpp_akm akm); 593 int dpp_configurator_get_key(const struct dpp_configurator *conf, char *buf, 594 size_t buflen); 595 void dpp_configurator_free(struct dpp_configurator *conf); 596 int dpp_configurator_own_config(struct dpp_authentication *auth, 597 const char *curve, int ap); 598 enum dpp_status_error 599 dpp_peer_intro(struct dpp_introduction *intro, const char *own_connector, 600 const u8 *net_access_key, size_t net_access_key_len, 601 const u8 *csign_key, size_t csign_key_len, 602 const u8 *peer_connector, size_t peer_connector_len, 603 os_time_t *expiry); 604 int dpp_get_connector_version(const char *connector); 605 struct dpp_pkex * dpp_pkex_init(void *msg_ctx, struct dpp_bootstrap_info *bi, 606 const u8 *own_mac, 607 const char *identifier, const char *code, 608 bool v2); 609 struct dpp_pkex * dpp_pkex_rx_exchange_req(void *msg_ctx, 610 struct dpp_bootstrap_info *bi, 611 const u8 *own_mac, 612 const u8 *peer_mac, 613 const char *identifier, 614 const char *code, 615 const u8 *buf, size_t len, bool v2); 616 struct wpabuf * dpp_pkex_rx_exchange_resp(struct dpp_pkex *pkex, 617 const u8 *peer_mac, 618 const u8 *buf, size_t len); 619 struct wpabuf * dpp_pkex_rx_commit_reveal_req(struct dpp_pkex *pkex, 620 const u8 *hdr, 621 const u8 *buf, size_t len); 622 int dpp_pkex_rx_commit_reveal_resp(struct dpp_pkex *pkex, const u8 *hdr, 623 const u8 *buf, size_t len); 624 void dpp_pkex_free(struct dpp_pkex *pkex); 625 626 char * dpp_corrupt_connector_signature(const char *connector); 627 628 629 struct dpp_pfs { 630 struct crypto_ecdh *ecdh; 631 const struct dpp_curve_params *curve; 632 struct wpabuf *ie; 633 struct wpabuf *secret; 634 }; 635 636 struct dpp_pfs * dpp_pfs_init(const u8 *net_access_key, 637 size_t net_access_key_len); 638 int dpp_pfs_process(struct dpp_pfs *pfs, const u8 *peer_ie, size_t peer_ie_len); 639 void dpp_pfs_free(struct dpp_pfs *pfs); 640 641 struct wpabuf * dpp_build_csr(struct dpp_authentication *auth, 642 const char *name); 643 int dpp_validate_csr(struct dpp_authentication *auth, const struct wpabuf *csr); 644 645 struct dpp_bootstrap_info * dpp_add_qr_code(struct dpp_global *dpp, 646 const char *uri); 647 struct dpp_bootstrap_info * dpp_add_nfc_uri(struct dpp_global *dpp, 648 const char *uri); 649 int dpp_bootstrap_gen(struct dpp_global *dpp, const char *cmd); 650 struct dpp_bootstrap_info * 651 dpp_bootstrap_get_id(struct dpp_global *dpp, unsigned int id); 652 int dpp_bootstrap_remove(struct dpp_global *dpp, const char *id); 653 struct dpp_bootstrap_info * 654 dpp_pkex_finish(struct dpp_global *dpp, struct dpp_pkex *pkex, const u8 *peer, 655 unsigned int freq); 656 const char * dpp_bootstrap_get_uri(struct dpp_global *dpp, unsigned int id); 657 int dpp_bootstrap_info(struct dpp_global *dpp, int id, 658 char *reply, int reply_size); 659 int dpp_bootstrap_set(struct dpp_global *dpp, int id, const char *params); 660 void dpp_bootstrap_find_pair(struct dpp_global *dpp, const u8 *i_bootstrap, 661 const u8 *r_bootstrap, 662 struct dpp_bootstrap_info **own_bi, 663 struct dpp_bootstrap_info **peer_bi); 664 struct dpp_bootstrap_info * dpp_bootstrap_find_chirp(struct dpp_global *dpp, 665 const u8 *hash); 666 int dpp_configurator_add(struct dpp_global *dpp, const char *cmd); 667 int dpp_configurator_remove(struct dpp_global *dpp, const char *id); 668 int dpp_configurator_get_key_id(struct dpp_global *dpp, unsigned int id, 669 char *buf, size_t buflen); 670 int dpp_configurator_from_backup(struct dpp_global *dpp, 671 struct dpp_asymmetric_key *key); 672 struct dpp_configurator * dpp_configurator_find_kid(struct dpp_global *dpp, 673 const u8 *kid); 674 int dpp_relay_add_controller(struct dpp_global *dpp, 675 struct dpp_relay_config *config); 676 int dpp_relay_rx_action(struct dpp_global *dpp, const u8 *src, const u8 *hdr, 677 const u8 *buf, size_t len, unsigned int freq, 678 const u8 *i_bootstrap, const u8 *r_bootstrap, 679 void *cb_ctx); 680 int dpp_relay_rx_gas_req(struct dpp_global *dpp, const u8 *src, const u8 *data, 681 size_t data_len); 682 int dpp_controller_start(struct dpp_global *dpp, 683 struct dpp_controller_config *config); 684 void dpp_controller_stop(struct dpp_global *dpp); 685 void dpp_controller_stop_for_ctx(struct dpp_global *dpp, void *cb_ctx); 686 struct dpp_authentication * dpp_controller_get_auth(struct dpp_global *dpp, 687 unsigned int id); 688 void dpp_controller_new_qr_code(struct dpp_global *dpp, 689 struct dpp_bootstrap_info *bi); 690 int dpp_tcp_init(struct dpp_global *dpp, struct dpp_authentication *auth, 691 const struct hostapd_ip_addr *addr, int port, 692 const char *name, enum dpp_netrole netrole, void *msg_ctx, 693 void *cb_ctx, 694 int (*process_conf_obj)(void *ctx, 695 struct dpp_authentication *auth)); 696 697 struct wpabuf * dpp_build_presence_announcement(struct dpp_bootstrap_info *bi); 698 void dpp_notify_chirp_received(void *msg_ctx, int id, const u8 *src, 699 unsigned int freq, const u8 *hash); 700 701 struct dpp_global_config { 702 void *cb_ctx; 703 void (*remove_bi)(void *ctx, struct dpp_bootstrap_info *bi); 704 }; 705 706 struct dpp_global * dpp_global_init(struct dpp_global_config *config); 707 void dpp_global_clear(struct dpp_global *dpp); 708 void dpp_global_deinit(struct dpp_global *dpp); 709 710 /* dpp_reconfig.c */ 711 712 struct wpabuf * dpp_build_reconfig_announcement(const u8 *csign_key, 713 size_t csign_key_len, 714 const u8 *net_access_key, 715 size_t net_access_key_len, 716 struct dpp_reconfig_id *id); 717 struct dpp_authentication * 718 dpp_reconfig_init(struct dpp_global *dpp, void *msg_ctx, 719 struct dpp_configurator *conf, unsigned int freq, u16 group, 720 const u8 *a_nonce_attr, size_t a_nonce_len, 721 const u8 *e_id_attr, size_t e_id_len); 722 struct dpp_authentication * 723 dpp_reconfig_auth_req_rx(struct dpp_global *dpp, void *msg_ctx, 724 const char *own_connector, 725 const u8 *net_access_key, size_t net_access_key_len, 726 const u8 *csign_key, size_t csign_key_len, 727 unsigned int freq, const u8 *hdr, 728 const u8 *attr_start, size_t attr_len); 729 struct wpabuf * 730 dpp_reconfig_auth_resp_rx(struct dpp_authentication *auth, const u8 *hdr, 731 const u8 *attr_start, size_t attr_len); 732 int dpp_reconfig_auth_conf_rx(struct dpp_authentication *auth, const u8 *hdr, 733 const u8 *attr_start, size_t attr_len); 734 735 struct dpp_reconfig_id * dpp_gen_reconfig_id(const u8 *csign_key, 736 size_t csign_key_len, 737 const u8 *pp_key, 738 size_t pp_key_len); 739 int dpp_update_reconfig_id(struct dpp_reconfig_id *id); 740 void dpp_free_reconfig_id(struct dpp_reconfig_id *id); 741 742 #endif /* CONFIG_DPP */ 743 #endif /* DPP_H */ 744