1 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
2 * All rights reserved.
3 *
4 * This package is an SSL implementation written
5 * by Eric Young (eay@cryptsoft.com).
6 * The implementation was written so as to conform with Netscapes SSL.
7 *
8 * This library is free for commercial and non-commercial use as long as
9 * the following conditions are aheared to. The following conditions
10 * apply to all code found in this distribution, be it the RC4, RSA,
11 * lhash, DES, etc., code; not just the SSL code. The SSL documentation
12 * included with this distribution is covered by the same copyright terms
13 * except that the holder is Tim Hudson (tjh@cryptsoft.com).
14 *
15 * Copyright remains Eric Young's, and as such any Copyright notices in
16 * the code are not to be removed.
17 * If this package is used in a product, Eric Young should be given attribution
18 * as the author of the parts of the library used.
19 * This can be in the form of a textual message at program startup or
20 * in documentation (online or textual) provided with the package.
21 *
22 * Redistribution and use in source and binary forms, with or without
23 * modification, are permitted provided that the following conditions
24 * are met:
25 * 1. Redistributions of source code must retain the copyright
26 * notice, this list of conditions and the following disclaimer.
27 * 2. Redistributions in binary form must reproduce the above copyright
28 * notice, this list of conditions and the following disclaimer in the
29 * documentation and/or other materials provided with the distribution.
30 * 3. All advertising materials mentioning features or use of this software
31 * must display the following acknowledgement:
32 * "This product includes cryptographic software written by
33 * Eric Young (eay@cryptsoft.com)"
34 * The word 'cryptographic' can be left out if the rouines from the library
35 * being used are not cryptographic related :-).
36 * 4. If you include any Windows specific code (or a derivative thereof) from
37 * the apps directory (application code) you must include an acknowledgement:
38 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
39 *
40 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
41 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
44 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
45 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
46 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
48 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
49 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
50 * SUCH DAMAGE.
51 *
52 * The licence and distribution terms for any publically available version or
53 * derivative of this code cannot be changed. i.e. this code cannot simply be
54 * copied and put under another distribution licence
55 * [including the GNU Public Licence.]
56 */
57 /* ====================================================================
58 * Copyright (c) 1998-2007 The OpenSSL Project. All rights reserved.
59 *
60 * Redistribution and use in source and binary forms, with or without
61 * modification, are permitted provided that the following conditions
62 * are met:
63 *
64 * 1. Redistributions of source code must retain the above copyright
65 * notice, this list of conditions and the following disclaimer.
66 *
67 * 2. Redistributions in binary form must reproduce the above copyright
68 * notice, this list of conditions and the following disclaimer in
69 * the documentation and/or other materials provided with the
70 * distribution.
71 *
72 * 3. All advertising materials mentioning features or use of this
73 * software must display the following acknowledgment:
74 * "This product includes software developed by the OpenSSL Project
75 * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
76 *
77 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
78 * endorse or promote products derived from this software without
79 * prior written permission. For written permission, please contact
80 * openssl-core@openssl.org.
81 *
82 * 5. Products derived from this software may not be called "OpenSSL"
83 * nor may "OpenSSL" appear in their names without prior written
84 * permission of the OpenSSL Project.
85 *
86 * 6. Redistributions of any form whatsoever must retain the following
87 * acknowledgment:
88 * "This product includes software developed by the OpenSSL Project
89 * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
90 *
91 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
92 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
93 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
94 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
95 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
96 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
97 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
98 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
99 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
100 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
101 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
102 * OF THE POSSIBILITY OF SUCH DAMAGE.
103 * ====================================================================
104 *
105 * This product includes cryptographic software written by Eric Young
106 * (eay@cryptsoft.com). This product includes software written by Tim
107 * Hudson (tjh@cryptsoft.com).
108 *
109 */
110 /* ====================================================================
111 * Copyright 2005 Nokia. All rights reserved.
112 *
113 * The portions of the attached software ("Contribution") is developed by
114 * Nokia Corporation and is licensed pursuant to the OpenSSL open source
115 * license.
116 *
117 * The Contribution, originally written by Mika Kousa and Pasi Eronen of
118 * Nokia Corporation, consists of the "PSK" (Pre-Shared Key) ciphersuites
119 * support (see RFC 4279) to OpenSSL.
120 *
121 * No patent licenses or other rights except those expressly stated in
122 * the OpenSSL open source license shall be deemed granted or received
123 * expressly, by implication, estoppel, or otherwise.
124 *
125 * No assurances are provided by Nokia that the Contribution does not
126 * infringe the patent or other intellectual property rights of any third
127 * party or that the license provides you with all the necessary rights
128 * to make use of the Contribution.
129 *
130 * THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN
131 * ADDITION TO THE DISCLAIMERS INCLUDED IN THE LICENSE, NOKIA
132 * SPECIFICALLY DISCLAIMS ANY LIABILITY FOR CLAIMS BROUGHT BY YOU OR ANY
133 * OTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OR
134 * OTHERWISE. */
135
136 #include <openssl/ssl.h>
137
138 #include <openssl/buf.h>
139 #include <openssl/digest.h>
140
141 #include "internal.h"
142
143
144 BSSL_NAMESPACE_BEGIN
145
SSLTranscript()146 SSLTranscript::SSLTranscript() {}
147
~SSLTranscript()148 SSLTranscript::~SSLTranscript() {}
149
Init()150 bool SSLTranscript::Init() {
151 buffer_.reset(BUF_MEM_new());
152 if (!buffer_) {
153 return false;
154 }
155
156 hash_.Reset();
157 return true;
158 }
159
160 // InitDigestWithData calls |EVP_DigestInit_ex| on |ctx| with |md| and then
161 // writes the data in |buf| to it.
InitDigestWithData(EVP_MD_CTX * ctx,const EVP_MD * md,const BUF_MEM * buf)162 static bool InitDigestWithData(EVP_MD_CTX *ctx, const EVP_MD *md,
163 const BUF_MEM *buf) {
164 if (!EVP_DigestInit_ex(ctx, md, NULL)) {
165 return false;
166 }
167 EVP_DigestUpdate(ctx, buf->data, buf->length);
168 return true;
169 }
170
InitHash(uint16_t version,const SSL_CIPHER * cipher)171 bool SSLTranscript::InitHash(uint16_t version, const SSL_CIPHER *cipher) {
172 const EVP_MD *md = ssl_get_handshake_digest(version, cipher);
173 return InitDigestWithData(hash_.get(), md, buffer_.get());
174 }
175
FreeBuffer()176 void SSLTranscript::FreeBuffer() {
177 buffer_.reset();
178 }
179
DigestLen() const180 size_t SSLTranscript::DigestLen() const {
181 return EVP_MD_size(Digest());
182 }
183
Digest() const184 const EVP_MD *SSLTranscript::Digest() const {
185 return EVP_MD_CTX_md(hash_.get());
186 }
187
UpdateForHelloRetryRequest()188 bool SSLTranscript::UpdateForHelloRetryRequest() {
189 if (buffer_) {
190 buffer_->length = 0;
191 }
192
193 uint8_t old_hash[EVP_MAX_MD_SIZE];
194 size_t hash_len;
195 if (!GetHash(old_hash, &hash_len)) {
196 return false;
197 }
198 const uint8_t header[4] = {SSL3_MT_MESSAGE_HASH, 0, 0,
199 static_cast<uint8_t>(hash_len)};
200 if (!EVP_DigestInit_ex(hash_.get(), Digest(), nullptr) ||
201 !Update(header) ||
202 !Update(MakeConstSpan(old_hash, hash_len))) {
203 return false;
204 }
205 return true;
206 }
207
CopyHashContext(EVP_MD_CTX * ctx)208 bool SSLTranscript::CopyHashContext(EVP_MD_CTX *ctx) {
209 return EVP_MD_CTX_copy_ex(ctx, hash_.get());
210 }
211
Update(Span<const uint8_t> in)212 bool SSLTranscript::Update(Span<const uint8_t> in) {
213 // Depending on the state of the handshake, either the handshake buffer may be
214 // active, the rolling hash, or both.
215 if (buffer_ &&
216 !BUF_MEM_append(buffer_.get(), in.data(), in.size())) {
217 return false;
218 }
219
220 if (EVP_MD_CTX_md(hash_.get()) != NULL) {
221 EVP_DigestUpdate(hash_.get(), in.data(), in.size());
222 }
223
224 return true;
225 }
226
GetHash(uint8_t * out,size_t * out_len)227 bool SSLTranscript::GetHash(uint8_t *out, size_t *out_len) {
228 ScopedEVP_MD_CTX ctx;
229 unsigned len;
230 if (!EVP_MD_CTX_copy_ex(ctx.get(), hash_.get()) ||
231 !EVP_DigestFinal_ex(ctx.get(), out, &len)) {
232 return false;
233 }
234 *out_len = len;
235 return true;
236 }
237
GetFinishedMAC(uint8_t * out,size_t * out_len,const SSL_SESSION * session,bool from_server)238 bool SSLTranscript::GetFinishedMAC(uint8_t *out, size_t *out_len,
239 const SSL_SESSION *session,
240 bool from_server) {
241 static const char kClientLabel[] = "client finished";
242 static const char kServerLabel[] = "server finished";
243 auto label = from_server
244 ? MakeConstSpan(kServerLabel, sizeof(kServerLabel) - 1)
245 : MakeConstSpan(kClientLabel, sizeof(kClientLabel) - 1);
246
247 uint8_t digest[EVP_MAX_MD_SIZE];
248 size_t digest_len;
249 if (!GetHash(digest, &digest_len)) {
250 return false;
251 }
252
253 static const size_t kFinishedLen = 12;
254 if (!tls1_prf(Digest(), MakeSpan(out, kFinishedLen),
255 MakeConstSpan(session->master_key, session->master_key_length),
256 label, MakeConstSpan(digest, digest_len), {})) {
257 return false;
258 }
259
260 *out_len = kFinishedLen;
261 return true;
262 }
263
264 BSSL_NAMESPACE_END
265