2 * Copyright (c) 2016 Thomas Pornin <pornin@bolet.org>
4 * Permission is hereby granted, free of charge, to any person obtaining
5 * a copy of this software and associated documentation files (the
6 * "Software"), to deal in the Software without restriction, including
7 * without limitation the rights to use, copy, modify, merge, publish,
8 * distribute, sublicense, and/or sell copies of the Software, and to
9 * permit persons to whom the Software is furnished to do so, subject to
10 * the following conditions:
12 * The above copyright notice and this permission notice shall be
13 * included in all copies or substantial portions of the Software.
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
18 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
19 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
20 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
21 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
27 /* see bearssl_ssl.h */
29 br_ssl_client_init_full(br_ssl_client_context
*cc
,
30 br_x509_minimal_context
*xc
,
31 const br_x509_trust_anchor
*trust_anchors
, size_t trust_anchors_num
)
34 * The "full" profile supports all implemented cipher suites.
36 * Rationale for suite order, from most important to least
39 * -- Don't use 3DES if AES or ChaCha20 is available.
40 * -- Try to have Forward Secrecy (ECDHE suite) if possible.
41 * -- When not using Forward Secrecy, ECDH key exchange is
42 * better than RSA key exchange (slightly more expensive on the
43 * client, but much cheaper on the server, and it implies smaller
45 * -- ChaCha20+Poly1305 is better than AES/GCM (faster, smaller code).
46 * -- GCM is better than CCM and CBC. CCM is better than CBC.
47 * -- CCM is preferable over CCM_8 (with CCM_8, forgeries may succeed
48 * with probability 2^(-64)).
49 * -- AES-128 is preferred over AES-256 (AES-128 is already
50 * strong enough, and AES-256 is 40% more expensive).
52 static const uint16_t suites
[] = {
53 BR_TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
,
54 BR_TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
,
55 BR_TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
,
56 BR_TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
,
57 BR_TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
,
58 BR_TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
,
59 BR_TLS_ECDHE_ECDSA_WITH_AES_128_CCM
,
60 BR_TLS_ECDHE_ECDSA_WITH_AES_256_CCM
,
61 BR_TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8
,
62 BR_TLS_ECDHE_ECDSA_WITH_AES_256_CCM_8
,
63 BR_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
,
64 BR_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
,
65 BR_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
,
66 BR_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
,
67 BR_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
,
68 BR_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
,
69 BR_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
,
70 BR_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
,
71 BR_TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256
,
72 BR_TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256
,
73 BR_TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384
,
74 BR_TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384
,
75 BR_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256
,
76 BR_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256
,
77 BR_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384
,
78 BR_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384
,
79 BR_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA
,
80 BR_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA
,
81 BR_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA
,
82 BR_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA
,
83 BR_TLS_RSA_WITH_AES_128_GCM_SHA256
,
84 BR_TLS_RSA_WITH_AES_256_GCM_SHA384
,
85 BR_TLS_RSA_WITH_AES_128_CCM
,
86 BR_TLS_RSA_WITH_AES_256_CCM
,
87 BR_TLS_RSA_WITH_AES_128_CCM_8
,
88 BR_TLS_RSA_WITH_AES_256_CCM_8
,
89 BR_TLS_RSA_WITH_AES_128_CBC_SHA256
,
90 BR_TLS_RSA_WITH_AES_256_CBC_SHA256
,
91 BR_TLS_RSA_WITH_AES_128_CBC_SHA
,
92 BR_TLS_RSA_WITH_AES_256_CBC_SHA
,
93 BR_TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA
,
94 BR_TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA
,
95 BR_TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA
,
96 BR_TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA
,
97 BR_TLS_RSA_WITH_3DES_EDE_CBC_SHA
101 * All hash functions are activated.
102 * Note: the X.509 validation engine will nonetheless refuse to
103 * validate signatures that use MD5 as hash function.
105 static const br_hash_class
*hashes
[] = {
117 * Reset client context and set supported versions from TLS-1.0
118 * to TLS-1.2 (inclusive).
120 br_ssl_client_zero(cc
);
121 br_ssl_engine_set_versions(&cc
->eng
, BR_TLS10
, BR_TLS12
);
124 * X.509 engine uses SHA-256 to hash certificate DN (for
127 br_x509_minimal_init(xc
, &br_sha256_vtable
,
128 trust_anchors
, trust_anchors_num
);
131 * Set suites and asymmetric crypto implementations. We use the
132 * "i31" code for RSA (it is somewhat faster than the "i32"
134 * TODO: change that when better implementations are made available.
136 br_ssl_engine_set_suites(&cc
->eng
, suites
,
137 (sizeof suites
) / (sizeof suites
[0]));
138 br_ssl_client_set_default_rsapub(cc
);
139 br_ssl_engine_set_default_rsavrfy(&cc
->eng
);
140 br_ssl_engine_set_default_ecdsa(&cc
->eng
);
141 br_x509_minimal_set_rsa(xc
, br_ssl_engine_get_rsavrfy(&cc
->eng
));
142 br_x509_minimal_set_ecdsa(xc
,
143 br_ssl_engine_get_ec(&cc
->eng
),
144 br_ssl_engine_get_ecdsa(&cc
->eng
));
147 * Set supported hash functions, for the SSL engine and for the
150 for (id
= br_md5_ID
; id
<= br_sha512_ID
; id
++) {
151 const br_hash_class
*hc
;
154 br_ssl_engine_set_hash(&cc
->eng
, id
, hc
);
155 br_x509_minimal_set_hash(xc
, id
, hc
);
159 * Link the X.509 engine in the SSL engine.
161 br_ssl_engine_set_x509(&cc
->eng
, &xc
->vtable
);
164 * Set the PRF implementations.
166 br_ssl_engine_set_prf10(&cc
->eng
, &br_tls10_prf
);
167 br_ssl_engine_set_prf_sha256(&cc
->eng
, &br_tls12_sha256_prf
);
168 br_ssl_engine_set_prf_sha384(&cc
->eng
, &br_tls12_sha384_prf
);
171 * Symmetric encryption. We use the "default" implementations
172 * (fastest among constant-time implementations).
174 br_ssl_engine_set_default_aes_cbc(&cc
->eng
);
175 br_ssl_engine_set_default_aes_ccm(&cc
->eng
);
176 br_ssl_engine_set_default_aes_gcm(&cc
->eng
);
177 br_ssl_engine_set_default_des_cbc(&cc
->eng
);
178 br_ssl_engine_set_default_chapol(&cc
->eng
);