1 /* 2 * EAP-TLS/PEAP/TTLS/FAST server common functions 3 * Copyright (c) 2004-2009, 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 EAP_TLS_COMMON_H 10 #define EAP_TLS_COMMON_H 11 12 /** 13 * struct eap_ssl_data - TLS data for EAP methods 14 */ 15 struct eap_ssl_data { 16 /** 17 * conn - TLS connection context data from tls_connection_init() 18 */ 19 struct tls_connection *conn; 20 21 /** 22 * tls_out - TLS message to be sent out in fragments 23 */ 24 struct wpabuf *tls_out; 25 26 /** 27 * tls_out_pos - The current position in the outgoing TLS message 28 */ 29 size_t tls_out_pos; 30 31 /** 32 * tls_out_limit - Maximum fragment size for outgoing TLS messages 33 */ 34 size_t tls_out_limit; 35 36 /** 37 * tls_in - Received TLS message buffer for re-assembly 38 */ 39 struct wpabuf *tls_in; 40 41 /** 42 * phase2 - Whether this TLS connection is used in EAP phase 2 (tunnel) 43 */ 44 int phase2; 45 46 /** 47 * eap - EAP state machine allocated with eap_server_sm_init() 48 */ 49 struct eap_sm *eap; 50 51 enum { MSG, FRAG_ACK, WAIT_FRAG_ACK } state; 52 struct wpabuf tmpbuf; 53 54 /** 55 * tls_v13 - Whether TLS v1.3 or newer is used 56 */ 57 int tls_v13; 58 }; 59 60 61 /* EAP TLS Flags */ 62 #define EAP_TLS_FLAGS_LENGTH_INCLUDED 0x80 63 #define EAP_TLS_FLAGS_MORE_FRAGMENTS 0x40 64 #define EAP_TLS_FLAGS_START 0x20 65 #define EAP_TEAP_FLAGS_OUTER_TLV_LEN 0x10 66 #define EAP_TLS_VERSION_MASK 0x07 67 68 /* could be up to 128 bytes, but only the first 64 bytes are used */ 69 #define EAP_TLS_KEY_LEN 64 70 71 /* stub type used as a flag for UNAUTH-TLS */ 72 #define EAP_UNAUTH_TLS_TYPE 255 73 #define EAP_WFA_UNAUTH_TLS_TYPE 254 74 75 76 struct wpabuf * eap_tls_msg_alloc(enum eap_type type, size_t payload_len, 77 u8 code, u8 identifier); 78 int eap_server_tls_ssl_init(struct eap_sm *sm, struct eap_ssl_data *data, 79 int verify_peer, int eap_type); 80 void eap_server_tls_ssl_deinit(struct eap_sm *sm, struct eap_ssl_data *data); 81 u8 * eap_server_tls_derive_key(struct eap_sm *sm, struct eap_ssl_data *data, 82 const char *label, const u8 *context, 83 size_t context_len, size_t len); 84 u8 * eap_server_tls_derive_session_id(struct eap_sm *sm, 85 struct eap_ssl_data *data, u8 eap_type, 86 size_t *len); 87 struct wpabuf * eap_server_tls_build_msg(struct eap_ssl_data *data, 88 int eap_type, int version, u8 id); 89 struct wpabuf * eap_server_tls_build_ack(u8 id, int eap_type, int version); 90 int eap_server_tls_phase1(struct eap_sm *sm, struct eap_ssl_data *data); 91 struct wpabuf * eap_server_tls_encrypt(struct eap_sm *sm, 92 struct eap_ssl_data *data, 93 const struct wpabuf *plain); 94 int eap_server_tls_process(struct eap_sm *sm, struct eap_ssl_data *data, 95 struct wpabuf *respData, void *priv, int eap_type, 96 int (*proc_version)(struct eap_sm *sm, void *priv, 97 int peer_version), 98 void (*proc_msg)(struct eap_sm *sm, void *priv, 99 const struct wpabuf *respData)); 100 101 #endif /* EAP_TLS_COMMON_H */ 102