Updated through tag hostap_2_5 from git://w1.fi/hostap.git
[mech_eap.git] / libeap / src / eap_common / eap_fast_common.h
1 /*
2  * EAP-FAST definitions (RFC 4851)
3  * Copyright (c) 2004-2008, 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_FAST_H
10 #define EAP_FAST_H
11
12 #ifdef __cplusplus
13 extern "C" {
14 #endif
15
16 #define EAP_FAST_VERSION 1
17 #define EAP_FAST_KEY_LEN 64
18 #define EAP_FAST_SIMCK_LEN 40
19 #define EAP_FAST_SKS_LEN 40
20 #define EAP_FAST_CMK_LEN 20
21
22 #define TLS_EXT_PAC_OPAQUE 35
23
24 /*
25  * RFC 5422: Section 4.2.1 - Formats for PAC TLV Attributes / Type Field
26  * Note: bit 0x8000 (Mandatory) and bit 0x4000 (Reserved) are also defined
27  * in the general PAC TLV format (Section 4.2).
28  */
29 #define PAC_TYPE_PAC_KEY 1
30 #define PAC_TYPE_PAC_OPAQUE 2
31 #define PAC_TYPE_CRED_LIFETIME 3
32 #define PAC_TYPE_A_ID 4
33 #define PAC_TYPE_I_ID 5
34 /*
35  * 6 was previous assigned for SERVER_PROTECTED_DATA, but
36  * draft-cam-winget-eap-fast-provisioning-02.txt changed this to Reserved.
37  */
38 #define PAC_TYPE_A_ID_INFO 7
39 #define PAC_TYPE_PAC_ACKNOWLEDGEMENT 8
40 #define PAC_TYPE_PAC_INFO 9
41 #define PAC_TYPE_PAC_TYPE 10
42
43 #ifdef _MSC_VER
44 #pragma pack(push, 1)
45 #endif /* _MSC_VER */
46
47 struct pac_tlv_hdr {
48         be16 type;
49         be16 len;
50 } STRUCT_PACKED;
51
52 #ifdef _MSC_VER
53 #pragma pack(pop)
54 #endif /* _MSC_VER */
55
56
57 #define EAP_FAST_PAC_KEY_LEN 32
58
59 /* RFC 5422: 4.2.6 PAC-Type TLV */
60 #define PAC_TYPE_TUNNEL_PAC 1
61 /* Application Specific Short Lived PACs (only in volatile storage) */
62 /* User Authorization PAC */
63 #define PAC_TYPE_USER_AUTHORIZATION 3
64 /* Application Specific Long Lived PACs */
65 /* Machine Authentication PAC */
66 #define PAC_TYPE_MACHINE_AUTHENTICATION 2
67
68
69 /*
70  * RFC 5422:
71  * Section 3.3 - Key Derivations Used in the EAP-FAST Provisioning Exchange
72  */
73 struct eap_fast_key_block_provisioning {
74         /* Extra key material after TLS key_block */
75         u8 session_key_seed[EAP_FAST_SKS_LEN];
76         u8 server_challenge[16]; /* MSCHAPv2 ServerChallenge */
77         u8 client_challenge[16]; /* MSCHAPv2 ClientChallenge */
78 };
79
80
81 struct wpabuf;
82 struct tls_connection;
83
84 struct eap_fast_tlv_parse {
85         u8 *eap_payload_tlv;
86         size_t eap_payload_tlv_len;
87         struct eap_tlv_crypto_binding_tlv *crypto_binding;
88         size_t crypto_binding_len;
89         int iresult;
90         int result;
91         int request_action;
92         u8 *pac;
93         size_t pac_len;
94 };
95
96 void eap_fast_put_tlv_hdr(struct wpabuf *buf, u16 type, u16 len);
97 void eap_fast_put_tlv(struct wpabuf *buf, u16 type, const void *data,
98                       u16 len);
99 void eap_fast_put_tlv_buf(struct wpabuf *buf, u16 type,
100                           const struct wpabuf *data);
101 struct wpabuf * eap_fast_tlv_eap_payload(struct wpabuf *buf);
102 void eap_fast_derive_master_secret(const u8 *pac_key, const u8 *server_random,
103                                    const u8 *client_random, u8 *master_secret);
104 u8 * eap_fast_derive_key(void *ssl_ctx, struct tls_connection *conn,
105                          const char *label, size_t len);
106 void eap_fast_derive_eap_msk(const u8 *simck, u8 *msk);
107 void eap_fast_derive_eap_emsk(const u8 *simck, u8 *emsk);
108 int eap_fast_parse_tlv(struct eap_fast_tlv_parse *tlv,
109                        int tlv_type, u8 *pos, size_t len);
110
111 #ifdef __cplusplus
112 }
113 #endif
114
115 #endif /* EAP_FAST_H */