blob: e12940fbeb90bad6384ed9aa78be7ab2188808ea [file] [log] [blame]
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001/*
2 * Copyright 2004 The WebRTC Project Authors. All rights reserved.
3 *
4 * Use of this source code is governed by a BSD-style license
5 * that can be found in the LICENSE file in the root of the source
6 * tree. An additional intellectual property rights grant can be found
7 * in the file PATENTS. All contributing project authors may
8 * be found in the AUTHORS file in the root of the source tree.
9 */
10
11#if HAVE_CONFIG_H
12#include "config.h"
13#endif // HAVE_CONFIG_H
14
15#if HAVE_OPENSSL_SSL_H
16
17#include "webrtc/base/opensslstreamadapter.h"
18
19#include <openssl/bio.h>
20#include <openssl/crypto.h>
21#include <openssl/err.h>
22#include <openssl/rand.h>
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +000023#include <openssl/tls1.h>
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000024#include <openssl/x509v3.h>
25
26#include <vector>
27
28#include "webrtc/base/common.h"
29#include "webrtc/base/logging.h"
henrike@webrtc.orgd89b69a2014-11-06 17:23:09 +000030#include "webrtc/base/safe_conversions.h"
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000031#include "webrtc/base/stream.h"
32#include "webrtc/base/openssl.h"
33#include "webrtc/base/openssladapter.h"
34#include "webrtc/base/openssldigest.h"
35#include "webrtc/base/opensslidentity.h"
36#include "webrtc/base/stringutils.h"
37#include "webrtc/base/thread.h"
38
39namespace rtc {
40
41#if (OPENSSL_VERSION_NUMBER >= 0x10001000L)
42#define HAVE_DTLS_SRTP
43#endif
44
45#ifdef HAVE_DTLS_SRTP
46// SRTP cipher suite table
47struct SrtpCipherMapEntry {
48 const char* external_name;
49 const char* internal_name;
50};
51
52// This isn't elegant, but it's better than an external reference
53static SrtpCipherMapEntry SrtpCipherMap[] = {
54 {"AES_CM_128_HMAC_SHA1_80", "SRTP_AES128_CM_SHA1_80"},
55 {"AES_CM_128_HMAC_SHA1_32", "SRTP_AES128_CM_SHA1_32"},
56 {NULL, NULL}
57};
58#endif
59
pthatcher@webrtc.orgf7bb6e72015-02-28 01:41:07 +000060#ifndef OPENSSL_IS_BORINGSSL
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +000061// Cipher name table. Maps internal OpenSSL cipher ids to the RFC name.
62struct SslCipherMapEntry {
63 uint32_t openssl_id;
64 const char* rfc_name;
65};
66
67#define DEFINE_CIPHER_ENTRY_SSL3(name) {SSL3_CK_##name, "TLS_"#name}
68#define DEFINE_CIPHER_ENTRY_TLS1(name) {TLS1_CK_##name, "TLS_"#name}
69
70// There currently is no method available to get a RFC-compliant name for a
71// cipher suite from BoringSSL, so we need to define the mapping manually here.
72// This should go away once BoringSSL supports "SSL_CIPHER_standard_name"
73// (as available in OpenSSL if compiled with tracing enabled) or a similar
74// method.
75static const SslCipherMapEntry kSslCipherMap[] = {
76 // TLS v1.0 ciphersuites from RFC2246.
77 DEFINE_CIPHER_ENTRY_SSL3(RSA_RC4_128_SHA),
78 {SSL3_CK_RSA_DES_192_CBC3_SHA,
79 "TLS_RSA_WITH_3DES_EDE_CBC_SHA"},
80
81 // AES ciphersuites from RFC3268.
82 {TLS1_CK_RSA_WITH_AES_128_SHA,
83 "TLS_RSA_WITH_AES_128_CBC_SHA"},
84 {TLS1_CK_DHE_RSA_WITH_AES_128_SHA,
85 "TLS_DHE_RSA_WITH_AES_128_CBC_SHA"},
86 {TLS1_CK_RSA_WITH_AES_256_SHA,
87 "TLS_RSA_WITH_AES_256_CBC_SHA"},
88 {TLS1_CK_DHE_RSA_WITH_AES_256_SHA,
89 "TLS_DHE_RSA_WITH_AES_256_CBC_SHA"},
90
91 // ECC ciphersuites from RFC4492.
92 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_ECDSA_WITH_RC4_128_SHA),
93 {TLS1_CK_ECDHE_ECDSA_WITH_DES_192_CBC3_SHA,
94 "TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA"},
95 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_ECDSA_WITH_AES_128_CBC_SHA),
96 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_ECDSA_WITH_AES_256_CBC_SHA),
97
98 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_RSA_WITH_RC4_128_SHA),
99 {TLS1_CK_ECDHE_RSA_WITH_DES_192_CBC3_SHA,
100 "TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA"},
101 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_RSA_WITH_AES_128_CBC_SHA),
102 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_RSA_WITH_AES_256_CBC_SHA),
103
104 // TLS v1.2 ciphersuites.
105 {TLS1_CK_RSA_WITH_AES_128_SHA256,
106 "TLS_RSA_WITH_AES_128_CBC_SHA256"},
107 {TLS1_CK_RSA_WITH_AES_256_SHA256,
108 "TLS_RSA_WITH_AES_256_CBC_SHA256"},
109 {TLS1_CK_DHE_RSA_WITH_AES_128_SHA256,
110 "TLS_DHE_RSA_WITH_AES_128_CBC_SHA256"},
111 {TLS1_CK_DHE_RSA_WITH_AES_256_SHA256,
112 "TLS_DHE_RSA_WITH_AES_256_CBC_SHA256"},
113
114 // TLS v1.2 GCM ciphersuites from RFC5288.
115 DEFINE_CIPHER_ENTRY_TLS1(RSA_WITH_AES_128_GCM_SHA256),
116 DEFINE_CIPHER_ENTRY_TLS1(RSA_WITH_AES_256_GCM_SHA384),
117 DEFINE_CIPHER_ENTRY_TLS1(DHE_RSA_WITH_AES_128_GCM_SHA256),
118 DEFINE_CIPHER_ENTRY_TLS1(DHE_RSA_WITH_AES_256_GCM_SHA384),
119 DEFINE_CIPHER_ENTRY_TLS1(DH_RSA_WITH_AES_128_GCM_SHA256),
120 DEFINE_CIPHER_ENTRY_TLS1(DH_RSA_WITH_AES_256_GCM_SHA384),
121
122 // ECDH HMAC based ciphersuites from RFC5289.
123 {TLS1_CK_ECDHE_ECDSA_WITH_AES_128_SHA256,
124 "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256"},
125 {TLS1_CK_ECDHE_ECDSA_WITH_AES_256_SHA384,
126 "TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384"},
127 {TLS1_CK_ECDHE_RSA_WITH_AES_128_SHA256,
128 "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256"},
129 {TLS1_CK_ECDHE_RSA_WITH_AES_256_SHA384,
130 "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384"},
131
132 // ECDH GCM based ciphersuites from RFC5289.
133 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_ECDSA_WITH_AES_128_GCM_SHA256),
134 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_ECDSA_WITH_AES_256_GCM_SHA384),
135 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_RSA_WITH_AES_128_GCM_SHA256),
136 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_RSA_WITH_AES_256_GCM_SHA384),
137
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +0000138 {0, NULL}
139};
pthatcher@webrtc.orgf7bb6e72015-02-28 01:41:07 +0000140#endif // #ifndef OPENSSL_IS_BORINGSSL
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +0000141
142// Default cipher used between OpenSSL/BoringSSL stream adapters.
143// This needs to be updated when the default of the SSL library changes.
Joachim Bauch831c5582015-05-20 12:48:41 +0200144static const char kDefaultSslCipher10[] =
145 "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA";
146
147#ifdef OPENSSL_IS_BORINGSSL
148static const char kDefaultSslCipher12[] =
149 "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256";
150// Fallback cipher for DTLS 1.2 if hardware-accelerated AES-GCM is unavailable.
151static const char kDefaultSslCipher12NoAesGcm[] =
152 "TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256";
153#else // !OPENSSL_IS_BORINGSSL
154// OpenSSL sorts differently than BoringSSL, so the default cipher doesn't
155// change between TLS 1.0 and TLS 1.2 with the current setup.
156static const char kDefaultSslCipher12[] =
157 "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA";
158#endif
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +0000159
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000160//////////////////////////////////////////////////////////////////////
161// StreamBIO
162//////////////////////////////////////////////////////////////////////
163
164static int stream_write(BIO* h, const char* buf, int num);
165static int stream_read(BIO* h, char* buf, int size);
166static int stream_puts(BIO* h, const char* str);
167static long stream_ctrl(BIO* h, int cmd, long arg1, void* arg2);
168static int stream_new(BIO* h);
169static int stream_free(BIO* data);
170
davidben@webrtc.org36d5c3c2015-01-22 23:06:17 +0000171// TODO(davidben): This should be const once BoringSSL is assumed.
172static BIO_METHOD methods_stream = {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000173 BIO_TYPE_BIO,
174 "stream",
175 stream_write,
176 stream_read,
177 stream_puts,
178 0,
179 stream_ctrl,
180 stream_new,
181 stream_free,
182 NULL,
183};
184
davidben@webrtc.org36d5c3c2015-01-22 23:06:17 +0000185static BIO_METHOD* BIO_s_stream() { return(&methods_stream); }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000186
187static BIO* BIO_new_stream(StreamInterface* stream) {
188 BIO* ret = BIO_new(BIO_s_stream());
189 if (ret == NULL)
190 return NULL;
191 ret->ptr = stream;
192 return ret;
193}
194
195// bio methods return 1 (or at least non-zero) on success and 0 on failure.
196
197static int stream_new(BIO* b) {
198 b->shutdown = 0;
199 b->init = 1;
200 b->num = 0; // 1 means end-of-stream
201 b->ptr = 0;
202 return 1;
203}
204
205static int stream_free(BIO* b) {
206 if (b == NULL)
207 return 0;
208 return 1;
209}
210
211static int stream_read(BIO* b, char* out, int outl) {
212 if (!out)
213 return -1;
214 StreamInterface* stream = static_cast<StreamInterface*>(b->ptr);
215 BIO_clear_retry_flags(b);
216 size_t read;
217 int error;
218 StreamResult result = stream->Read(out, outl, &read, &error);
219 if (result == SR_SUCCESS) {
henrike@webrtc.orgd89b69a2014-11-06 17:23:09 +0000220 return checked_cast<int>(read);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000221 } else if (result == SR_EOS) {
222 b->num = 1;
223 } else if (result == SR_BLOCK) {
224 BIO_set_retry_read(b);
225 }
226 return -1;
227}
228
229static int stream_write(BIO* b, const char* in, int inl) {
230 if (!in)
231 return -1;
232 StreamInterface* stream = static_cast<StreamInterface*>(b->ptr);
233 BIO_clear_retry_flags(b);
234 size_t written;
235 int error;
236 StreamResult result = stream->Write(in, inl, &written, &error);
237 if (result == SR_SUCCESS) {
henrike@webrtc.orgd89b69a2014-11-06 17:23:09 +0000238 return checked_cast<int>(written);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000239 } else if (result == SR_BLOCK) {
240 BIO_set_retry_write(b);
241 }
242 return -1;
243}
244
245static int stream_puts(BIO* b, const char* str) {
henrike@webrtc.orgd89b69a2014-11-06 17:23:09 +0000246 return stream_write(b, str, checked_cast<int>(strlen(str)));
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000247}
248
249static long stream_ctrl(BIO* b, int cmd, long num, void* ptr) {
henrike@webrtc.org14abcc72014-05-16 16:54:44 +0000250 RTC_UNUSED(num);
251 RTC_UNUSED(ptr);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000252
253 switch (cmd) {
254 case BIO_CTRL_RESET:
255 return 0;
256 case BIO_CTRL_EOF:
257 return b->num;
258 case BIO_CTRL_WPENDING:
259 case BIO_CTRL_PENDING:
260 return 0;
261 case BIO_CTRL_FLUSH:
262 return 1;
263 default:
264 return 0;
265 }
266}
267
268/////////////////////////////////////////////////////////////////////////////
269// OpenSSLStreamAdapter
270/////////////////////////////////////////////////////////////////////////////
271
272OpenSSLStreamAdapter::OpenSSLStreamAdapter(StreamInterface* stream)
273 : SSLStreamAdapter(stream),
274 state_(SSL_NONE),
275 role_(SSL_CLIENT),
276 ssl_read_needs_write_(false), ssl_write_needs_read_(false),
277 ssl_(NULL), ssl_ctx_(NULL),
278 custom_verification_succeeded_(false),
Joachim Bauch831c5582015-05-20 12:48:41 +0200279 ssl_mode_(SSL_MODE_TLS),
280 ssl_max_version_(SSL_PROTOCOL_TLS_11) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000281}
282
283OpenSSLStreamAdapter::~OpenSSLStreamAdapter() {
284 Cleanup();
285}
286
287void OpenSSLStreamAdapter::SetIdentity(SSLIdentity* identity) {
288 ASSERT(!identity_);
289 identity_.reset(static_cast<OpenSSLIdentity*>(identity));
290}
291
292void OpenSSLStreamAdapter::SetServerRole(SSLRole role) {
293 role_ = role;
294}
295
296bool OpenSSLStreamAdapter::GetPeerCertificate(SSLCertificate** cert) const {
297 if (!peer_certificate_)
298 return false;
299
300 *cert = peer_certificate_->GetReference();
301 return true;
302}
303
304bool OpenSSLStreamAdapter::SetPeerCertificateDigest(const std::string
305 &digest_alg,
306 const unsigned char*
307 digest_val,
308 size_t digest_len) {
309 ASSERT(!peer_certificate_);
310 ASSERT(peer_certificate_digest_algorithm_.size() == 0);
311 ASSERT(ssl_server_name_.empty());
312 size_t expected_len;
313
314 if (!OpenSSLDigest::GetDigestSize(digest_alg, &expected_len)) {
315 LOG(LS_WARNING) << "Unknown digest algorithm: " << digest_alg;
316 return false;
317 }
318 if (expected_len != digest_len)
319 return false;
320
321 peer_certificate_digest_value_.SetData(digest_val, digest_len);
322 peer_certificate_digest_algorithm_ = digest_alg;
323
324 return true;
325}
326
pthatcher@webrtc.orgf7bb6e72015-02-28 01:41:07 +0000327#ifndef OPENSSL_IS_BORINGSSL
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +0000328const char* OpenSSLStreamAdapter::GetRfcSslCipherName(
329 const SSL_CIPHER* cipher) {
330 ASSERT(cipher != NULL);
331 for (const SslCipherMapEntry* entry = kSslCipherMap; entry->rfc_name;
332 ++entry) {
333 if (cipher->id == entry->openssl_id) {
334 return entry->rfc_name;
335 }
336 }
337 return NULL;
338}
pthatcher@webrtc.orgf7bb6e72015-02-28 01:41:07 +0000339#endif
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +0000340
341bool OpenSSLStreamAdapter::GetSslCipher(std::string* cipher) {
342 if (state_ != SSL_CONNECTED)
343 return false;
344
345 const SSL_CIPHER* current_cipher = SSL_get_current_cipher(ssl_);
346 if (current_cipher == NULL) {
347 return false;
348 }
349
pthatcher@webrtc.orgf7bb6e72015-02-28 01:41:07 +0000350#ifdef OPENSSL_IS_BORINGSSL
351 char* cipher_name = SSL_CIPHER_get_rfc_name(current_cipher);
352#else
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +0000353 const char* cipher_name = GetRfcSslCipherName(current_cipher);
pthatcher@webrtc.orgf7bb6e72015-02-28 01:41:07 +0000354#endif
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +0000355 if (cipher_name == NULL) {
356 return false;
357 }
358
359 *cipher = cipher_name;
pthatcher@webrtc.orgf7bb6e72015-02-28 01:41:07 +0000360#ifdef OPENSSL_IS_BORINGSSL
361 OPENSSL_free(cipher_name);
362#endif
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +0000363 return true;
364}
365
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000366// Key Extractor interface
367bool OpenSSLStreamAdapter::ExportKeyingMaterial(const std::string& label,
368 const uint8* context,
369 size_t context_len,
370 bool use_context,
371 uint8* result,
372 size_t result_len) {
373#ifdef HAVE_DTLS_SRTP
374 int i;
375
376 i = SSL_export_keying_material(ssl_, result, result_len,
377 label.c_str(), label.length(),
378 const_cast<uint8 *>(context),
379 context_len, use_context);
380
381 if (i != 1)
382 return false;
383
384 return true;
385#else
386 return false;
387#endif
388}
389
390bool OpenSSLStreamAdapter::SetDtlsSrtpCiphers(
391 const std::vector<std::string>& ciphers) {
392#ifdef HAVE_DTLS_SRTP
393 std::string internal_ciphers;
394
395 if (state_ != SSL_NONE)
396 return false;
397
398 for (std::vector<std::string>::const_iterator cipher = ciphers.begin();
399 cipher != ciphers.end(); ++cipher) {
400 bool found = false;
401 for (SrtpCipherMapEntry *entry = SrtpCipherMap; entry->internal_name;
402 ++entry) {
403 if (*cipher == entry->external_name) {
404 found = true;
405 if (!internal_ciphers.empty())
406 internal_ciphers += ":";
407 internal_ciphers += entry->internal_name;
408 break;
409 }
410 }
411
412 if (!found) {
413 LOG(LS_ERROR) << "Could not find cipher: " << *cipher;
414 return false;
415 }
416 }
417
418 if (internal_ciphers.empty())
419 return false;
420
421 srtp_ciphers_ = internal_ciphers;
422 return true;
423#else
424 return false;
425#endif
426}
427
428bool OpenSSLStreamAdapter::GetDtlsSrtpCipher(std::string* cipher) {
429#ifdef HAVE_DTLS_SRTP
430 ASSERT(state_ == SSL_CONNECTED);
431 if (state_ != SSL_CONNECTED)
432 return false;
433
henrike@webrtc.orgc10ecea2015-01-07 17:59:28 +0000434 const SRTP_PROTECTION_PROFILE *srtp_profile =
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000435 SSL_get_selected_srtp_profile(ssl_);
436
437 if (!srtp_profile)
438 return false;
439
440 for (SrtpCipherMapEntry *entry = SrtpCipherMap;
441 entry->internal_name; ++entry) {
442 if (!strcmp(entry->internal_name, srtp_profile->name)) {
443 *cipher = entry->external_name;
444 return true;
445 }
446 }
447
448 ASSERT(false); // This should never happen
449
450 return false;
451#else
452 return false;
453#endif
454}
455
456int OpenSSLStreamAdapter::StartSSLWithServer(const char* server_name) {
457 ASSERT(server_name != NULL && server_name[0] != '\0');
458 ssl_server_name_ = server_name;
459 return StartSSL();
460}
461
462int OpenSSLStreamAdapter::StartSSLWithPeer() {
463 ASSERT(ssl_server_name_.empty());
464 // It is permitted to specify peer_certificate_ only later.
465 return StartSSL();
466}
467
468void OpenSSLStreamAdapter::SetMode(SSLMode mode) {
469 ASSERT(state_ == SSL_NONE);
470 ssl_mode_ = mode;
471}
472
Joachim Bauch831c5582015-05-20 12:48:41 +0200473void OpenSSLStreamAdapter::SetMaxProtocolVersion(SSLProtocolVersion version) {
474 ASSERT(ssl_ctx_ == NULL);
475 ssl_max_version_ = version;
476}
477
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000478//
479// StreamInterface Implementation
480//
481
482StreamResult OpenSSLStreamAdapter::Write(const void* data, size_t data_len,
483 size_t* written, int* error) {
484 LOG(LS_VERBOSE) << "OpenSSLStreamAdapter::Write(" << data_len << ")";
485
486 switch (state_) {
487 case SSL_NONE:
488 // pass-through in clear text
489 return StreamAdapterInterface::Write(data, data_len, written, error);
490
491 case SSL_WAIT:
492 case SSL_CONNECTING:
493 return SR_BLOCK;
494
495 case SSL_CONNECTED:
496 break;
497
498 case SSL_ERROR:
499 case SSL_CLOSED:
500 default:
501 if (error)
502 *error = ssl_error_code_;
503 return SR_ERROR;
504 }
505
506 // OpenSSL will return an error if we try to write zero bytes
507 if (data_len == 0) {
508 if (written)
509 *written = 0;
510 return SR_SUCCESS;
511 }
512
513 ssl_write_needs_read_ = false;
514
henrike@webrtc.orgd89b69a2014-11-06 17:23:09 +0000515 int code = SSL_write(ssl_, data, checked_cast<int>(data_len));
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000516 int ssl_error = SSL_get_error(ssl_, code);
517 switch (ssl_error) {
518 case SSL_ERROR_NONE:
519 LOG(LS_VERBOSE) << " -- success";
520 ASSERT(0 < code && static_cast<unsigned>(code) <= data_len);
521 if (written)
522 *written = code;
523 return SR_SUCCESS;
524 case SSL_ERROR_WANT_READ:
525 LOG(LS_VERBOSE) << " -- error want read";
526 ssl_write_needs_read_ = true;
527 return SR_BLOCK;
528 case SSL_ERROR_WANT_WRITE:
529 LOG(LS_VERBOSE) << " -- error want write";
530 return SR_BLOCK;
531
532 case SSL_ERROR_ZERO_RETURN:
533 default:
534 Error("SSL_write", (ssl_error ? ssl_error : -1), false);
535 if (error)
536 *error = ssl_error_code_;
537 return SR_ERROR;
538 }
539 // not reached
540}
541
542StreamResult OpenSSLStreamAdapter::Read(void* data, size_t data_len,
543 size_t* read, int* error) {
544 LOG(LS_VERBOSE) << "OpenSSLStreamAdapter::Read(" << data_len << ")";
545 switch (state_) {
546 case SSL_NONE:
547 // pass-through in clear text
548 return StreamAdapterInterface::Read(data, data_len, read, error);
549
550 case SSL_WAIT:
551 case SSL_CONNECTING:
552 return SR_BLOCK;
553
554 case SSL_CONNECTED:
555 break;
556
557 case SSL_CLOSED:
558 return SR_EOS;
559
560 case SSL_ERROR:
561 default:
562 if (error)
563 *error = ssl_error_code_;
564 return SR_ERROR;
565 }
566
567 // Don't trust OpenSSL with zero byte reads
568 if (data_len == 0) {
569 if (read)
570 *read = 0;
571 return SR_SUCCESS;
572 }
573
574 ssl_read_needs_write_ = false;
575
henrike@webrtc.orgd89b69a2014-11-06 17:23:09 +0000576 int code = SSL_read(ssl_, data, checked_cast<int>(data_len));
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000577 int ssl_error = SSL_get_error(ssl_, code);
578 switch (ssl_error) {
579 case SSL_ERROR_NONE:
580 LOG(LS_VERBOSE) << " -- success";
581 ASSERT(0 < code && static_cast<unsigned>(code) <= data_len);
582 if (read)
583 *read = code;
584
585 if (ssl_mode_ == SSL_MODE_DTLS) {
586 // Enforce atomic reads -- this is a short read
587 unsigned int pending = SSL_pending(ssl_);
588
589 if (pending) {
590 LOG(LS_INFO) << " -- short DTLS read. flushing";
591 FlushInput(pending);
592 if (error)
593 *error = SSE_MSG_TRUNC;
594 return SR_ERROR;
595 }
596 }
597 return SR_SUCCESS;
598 case SSL_ERROR_WANT_READ:
599 LOG(LS_VERBOSE) << " -- error want read";
600 return SR_BLOCK;
601 case SSL_ERROR_WANT_WRITE:
602 LOG(LS_VERBOSE) << " -- error want write";
603 ssl_read_needs_write_ = true;
604 return SR_BLOCK;
605 case SSL_ERROR_ZERO_RETURN:
606 LOG(LS_VERBOSE) << " -- remote side closed";
607 return SR_EOS;
608 break;
609 default:
610 LOG(LS_VERBOSE) << " -- error " << code;
611 Error("SSL_read", (ssl_error ? ssl_error : -1), false);
612 if (error)
613 *error = ssl_error_code_;
614 return SR_ERROR;
615 }
616 // not reached
617}
618
619void OpenSSLStreamAdapter::FlushInput(unsigned int left) {
620 unsigned char buf[2048];
621
622 while (left) {
623 // This should always succeed
624 int toread = (sizeof(buf) < left) ? sizeof(buf) : left;
625 int code = SSL_read(ssl_, buf, toread);
626
627 int ssl_error = SSL_get_error(ssl_, code);
628 ASSERT(ssl_error == SSL_ERROR_NONE);
629
630 if (ssl_error != SSL_ERROR_NONE) {
631 LOG(LS_VERBOSE) << " -- error " << code;
632 Error("SSL_read", (ssl_error ? ssl_error : -1), false);
633 return;
634 }
635
636 LOG(LS_VERBOSE) << " -- flushed " << code << " bytes";
637 left -= code;
638 }
639}
640
641void OpenSSLStreamAdapter::Close() {
642 Cleanup();
643 ASSERT(state_ == SSL_CLOSED || state_ == SSL_ERROR);
644 StreamAdapterInterface::Close();
645}
646
647StreamState OpenSSLStreamAdapter::GetState() const {
648 switch (state_) {
649 case SSL_WAIT:
650 case SSL_CONNECTING:
651 return SS_OPENING;
652 case SSL_CONNECTED:
653 return SS_OPEN;
654 default:
655 return SS_CLOSED;
656 };
657 // not reached
658}
659
660void OpenSSLStreamAdapter::OnEvent(StreamInterface* stream, int events,
661 int err) {
662 int events_to_signal = 0;
663 int signal_error = 0;
664 ASSERT(stream == this->stream());
665 if ((events & SE_OPEN)) {
666 LOG(LS_VERBOSE) << "OpenSSLStreamAdapter::OnEvent SE_OPEN";
667 if (state_ != SSL_WAIT) {
668 ASSERT(state_ == SSL_NONE);
669 events_to_signal |= SE_OPEN;
670 } else {
671 state_ = SSL_CONNECTING;
672 if (int err = BeginSSL()) {
673 Error("BeginSSL", err, true);
674 return;
675 }
676 }
677 }
678 if ((events & (SE_READ|SE_WRITE))) {
679 LOG(LS_VERBOSE) << "OpenSSLStreamAdapter::OnEvent"
680 << ((events & SE_READ) ? " SE_READ" : "")
681 << ((events & SE_WRITE) ? " SE_WRITE" : "");
682 if (state_ == SSL_NONE) {
683 events_to_signal |= events & (SE_READ|SE_WRITE);
684 } else if (state_ == SSL_CONNECTING) {
685 if (int err = ContinueSSL()) {
686 Error("ContinueSSL", err, true);
687 return;
688 }
689 } else if (state_ == SSL_CONNECTED) {
690 if (((events & SE_READ) && ssl_write_needs_read_) ||
691 (events & SE_WRITE)) {
692 LOG(LS_VERBOSE) << " -- onStreamWriteable";
693 events_to_signal |= SE_WRITE;
694 }
695 if (((events & SE_WRITE) && ssl_read_needs_write_) ||
696 (events & SE_READ)) {
697 LOG(LS_VERBOSE) << " -- onStreamReadable";
698 events_to_signal |= SE_READ;
699 }
700 }
701 }
702 if ((events & SE_CLOSE)) {
703 LOG(LS_VERBOSE) << "OpenSSLStreamAdapter::OnEvent(SE_CLOSE, " << err << ")";
704 Cleanup();
705 events_to_signal |= SE_CLOSE;
706 // SE_CLOSE is the only event that uses the final parameter to OnEvent().
707 ASSERT(signal_error == 0);
708 signal_error = err;
709 }
710 if (events_to_signal)
711 StreamAdapterInterface::OnEvent(stream, events_to_signal, signal_error);
712}
713
714int OpenSSLStreamAdapter::StartSSL() {
715 ASSERT(state_ == SSL_NONE);
716
717 if (StreamAdapterInterface::GetState() != SS_OPEN) {
718 state_ = SSL_WAIT;
719 return 0;
720 }
721
722 state_ = SSL_CONNECTING;
723 if (int err = BeginSSL()) {
724 Error("BeginSSL", err, false);
725 return err;
726 }
727
728 return 0;
729}
730
731int OpenSSLStreamAdapter::BeginSSL() {
732 ASSERT(state_ == SSL_CONNECTING);
733 // The underlying stream has open. If we are in peer-to-peer mode
734 // then a peer certificate must have been specified by now.
735 ASSERT(!ssl_server_name_.empty() ||
736 !peer_certificate_digest_algorithm_.empty());
737 LOG(LS_INFO) << "BeginSSL: "
738 << (!ssl_server_name_.empty() ? ssl_server_name_ :
739 "with peer");
740
741 BIO* bio = NULL;
742
743 // First set up the context
744 ASSERT(ssl_ctx_ == NULL);
745 ssl_ctx_ = SetupSSLContext();
746 if (!ssl_ctx_)
747 return -1;
748
749 bio = BIO_new_stream(static_cast<StreamInterface*>(stream()));
750 if (!bio)
751 return -1;
752
753 ssl_ = SSL_new(ssl_ctx_);
754 if (!ssl_) {
755 BIO_free(bio);
756 return -1;
757 }
758
759 SSL_set_app_data(ssl_, this);
760
761 SSL_set_bio(ssl_, bio, bio); // the SSL object owns the bio now.
Joachim Baucha3980202015-06-02 23:07:43 +0200762#ifndef OPENSSL_IS_BORINGSSL
Joachim Bauch5ca688b2015-05-20 10:40:15 +0200763 if (ssl_mode_ == SSL_MODE_DTLS) {
764 // Enable read-ahead for DTLS so whole packets are read from internal BIO
Joachim Baucha3980202015-06-02 23:07:43 +0200765 // before parsing. This is done internally by BoringSSL for DTLS.
Joachim Bauch5ca688b2015-05-20 10:40:15 +0200766 SSL_set_read_ahead(ssl_, 1);
767 }
Joachim Baucha3980202015-06-02 23:07:43 +0200768#endif
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000769
770 SSL_set_mode(ssl_, SSL_MODE_ENABLE_PARTIAL_WRITE |
771 SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER);
772
jiayl@webrtc.org11c6bde2014-08-28 16:14:38 +0000773 // Specify an ECDH group for ECDHE ciphers, otherwise they cannot be
774 // negotiated when acting as the server. Use NIST's P-256 which is commonly
775 // supported.
776 EC_KEY* ecdh = EC_KEY_new_by_curve_name(NID_X9_62_prime256v1);
777 if (ecdh == NULL)
778 return -1;
779 SSL_set_options(ssl_, SSL_OP_SINGLE_ECDH_USE);
780 SSL_set_tmp_ecdh(ssl_, ecdh);
781 EC_KEY_free(ecdh);
782
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000783 // Do the connect
784 return ContinueSSL();
785}
786
787int OpenSSLStreamAdapter::ContinueSSL() {
788 LOG(LS_VERBOSE) << "ContinueSSL";
789 ASSERT(state_ == SSL_CONNECTING);
790
791 // Clear the DTLS timer
792 Thread::Current()->Clear(this, MSG_TIMEOUT);
793
794 int code = (role_ == SSL_CLIENT) ? SSL_connect(ssl_) : SSL_accept(ssl_);
795 int ssl_error;
796 switch (ssl_error = SSL_get_error(ssl_, code)) {
797 case SSL_ERROR_NONE:
798 LOG(LS_VERBOSE) << " -- success";
799
800 if (!SSLPostConnectionCheck(ssl_, ssl_server_name_.c_str(), NULL,
801 peer_certificate_digest_algorithm_)) {
802 LOG(LS_ERROR) << "TLS post connection check failed";
803 return -1;
804 }
805
806 state_ = SSL_CONNECTED;
807 StreamAdapterInterface::OnEvent(stream(), SE_OPEN|SE_READ|SE_WRITE, 0);
808 break;
809
810 case SSL_ERROR_WANT_READ: {
811 LOG(LS_VERBOSE) << " -- error want read";
812 struct timeval timeout;
813 if (DTLSv1_get_timeout(ssl_, &timeout)) {
814 int delay = timeout.tv_sec * 1000 + timeout.tv_usec/1000;
815
816 Thread::Current()->PostDelayed(delay, this, MSG_TIMEOUT, 0);
817 }
818 }
819 break;
820
821 case SSL_ERROR_WANT_WRITE:
822 LOG(LS_VERBOSE) << " -- error want write";
823 break;
824
825 case SSL_ERROR_ZERO_RETURN:
826 default:
827 LOG(LS_VERBOSE) << " -- error " << code;
828 return (ssl_error != 0) ? ssl_error : -1;
829 }
830
831 return 0;
832}
833
834void OpenSSLStreamAdapter::Error(const char* context, int err, bool signal) {
835 LOG(LS_WARNING) << "OpenSSLStreamAdapter::Error("
836 << context << ", " << err << ")";
837 state_ = SSL_ERROR;
838 ssl_error_code_ = err;
839 Cleanup();
840 if (signal)
841 StreamAdapterInterface::OnEvent(stream(), SE_CLOSE, err);
842}
843
844void OpenSSLStreamAdapter::Cleanup() {
845 LOG(LS_INFO) << "Cleanup";
846
847 if (state_ != SSL_ERROR) {
848 state_ = SSL_CLOSED;
849 ssl_error_code_ = 0;
850 }
851
852 if (ssl_) {
jiayl@webrtc.orgf1d751c2014-09-25 16:38:46 +0000853 int ret = SSL_shutdown(ssl_);
854 if (ret < 0) {
855 LOG(LS_WARNING) << "SSL_shutdown failed, error = "
856 << SSL_get_error(ssl_, ret);
857 }
858
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000859 SSL_free(ssl_);
860 ssl_ = NULL;
861 }
862 if (ssl_ctx_) {
863 SSL_CTX_free(ssl_ctx_);
864 ssl_ctx_ = NULL;
865 }
866 identity_.reset();
867 peer_certificate_.reset();
868
869 // Clear the DTLS timer
870 Thread::Current()->Clear(this, MSG_TIMEOUT);
871}
872
873
874void OpenSSLStreamAdapter::OnMessage(Message* msg) {
875 // Process our own messages and then pass others to the superclass
876 if (MSG_TIMEOUT == msg->message_id) {
877 LOG(LS_INFO) << "DTLS timeout expired";
878 DTLSv1_handle_timeout(ssl_);
879 ContinueSSL();
880 } else {
881 StreamInterface::OnMessage(msg);
882 }
883}
884
885SSL_CTX* OpenSSLStreamAdapter::SetupSSLContext() {
886 SSL_CTX *ctx = NULL;
887
Joachim Bauch831c5582015-05-20 12:48:41 +0200888#ifdef OPENSSL_IS_BORINGSSL
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000889 ctx = SSL_CTX_new(ssl_mode_ == SSL_MODE_DTLS ?
Joachim Bauch831c5582015-05-20 12:48:41 +0200890 DTLS_method() : TLS_method());
891 // Version limiting for BoringSSL will be done below.
892#else
893 const SSL_METHOD* method;
894 switch (ssl_max_version_) {
895 case SSL_PROTOCOL_TLS_10:
896 case SSL_PROTOCOL_TLS_11:
897 // OpenSSL doesn't support setting min/max versions, so we always use
898 // (D)TLS 1.0 if a max. version below the max. available is requested.
899 if (ssl_mode_ == SSL_MODE_DTLS) {
900 if (role_ == SSL_CLIENT) {
901 method = DTLSv1_client_method();
902 } else {
903 method = DTLSv1_server_method();
904 }
905 } else {
906 if (role_ == SSL_CLIENT) {
907 method = TLSv1_client_method();
908 } else {
909 method = TLSv1_server_method();
910 }
911 }
912 break;
913 case SSL_PROTOCOL_TLS_12:
914 default:
915 if (ssl_mode_ == SSL_MODE_DTLS) {
916#if (OPENSSL_VERSION_NUMBER >= 0x10002000L)
917 // DTLS 1.2 only available starting from OpenSSL 1.0.2
918 if (role_ == SSL_CLIENT) {
919 method = DTLS_client_method();
920 } else {
921 method = DTLS_server_method();
922 }
923#else
924 if (role_ == SSL_CLIENT) {
925 method = DTLSv1_client_method();
926 } else {
927 method = DTLSv1_server_method();
928 }
929#endif
930 } else {
931#if (OPENSSL_VERSION_NUMBER >= 0x10100000L)
932 // New API only available starting from OpenSSL 1.1.0
933 if (role_ == SSL_CLIENT) {
934 method = TLS_client_method();
935 } else {
936 method = TLS_server_method();
937 }
938#else
939 if (role_ == SSL_CLIENT) {
940 method = SSLv23_client_method();
941 } else {
942 method = SSLv23_server_method();
943 }
944#endif
945 }
946 break;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000947 }
Joachim Bauch831c5582015-05-20 12:48:41 +0200948 ctx = SSL_CTX_new(method);
949#endif // OPENSSL_IS_BORINGSSL
950
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000951 if (ctx == NULL)
952 return NULL;
953
Joachim Bauch831c5582015-05-20 12:48:41 +0200954#ifdef OPENSSL_IS_BORINGSSL
955 SSL_CTX_set_min_version(ctx, ssl_mode_ == SSL_MODE_DTLS ?
956 DTLS1_VERSION : TLS1_VERSION);
957 switch (ssl_max_version_) {
958 case SSL_PROTOCOL_TLS_10:
959 SSL_CTX_set_max_version(ctx, ssl_mode_ == SSL_MODE_DTLS ?
960 DTLS1_VERSION : TLS1_VERSION);
961 break;
962 case SSL_PROTOCOL_TLS_11:
963 SSL_CTX_set_max_version(ctx, ssl_mode_ == SSL_MODE_DTLS ?
964 DTLS1_VERSION : TLS1_1_VERSION);
965 break;
966 case SSL_PROTOCOL_TLS_12:
967 default:
968 SSL_CTX_set_max_version(ctx, ssl_mode_ == SSL_MODE_DTLS ?
969 DTLS1_2_VERSION : TLS1_2_VERSION);
970 break;
971 }
972#endif
973
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000974 if (identity_ && !identity_->ConfigureIdentity(ctx)) {
975 SSL_CTX_free(ctx);
976 return NULL;
977 }
978
979#ifdef _DEBUG
980 SSL_CTX_set_info_callback(ctx, OpenSSLAdapter::SSLInfoCallback);
981#endif
982
tkchin@webrtc.orgc569a492014-09-23 05:56:44 +0000983 int mode = SSL_VERIFY_PEER;
984 if (client_auth_enabled()) {
985 // Require a certificate from the client.
986 // Note: Normally this is always true in production, but it may be disabled
987 // for testing purposes (e.g. SSLAdapter unit tests).
988 mode |= SSL_VERIFY_FAIL_IF_NO_PEER_CERT;
989 }
990
991 SSL_CTX_set_verify(ctx, mode, SSLVerifyCallback);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000992 SSL_CTX_set_verify_depth(ctx, 4);
Joachim Bauch831c5582015-05-20 12:48:41 +0200993 // Select list of available ciphers. Note that !SHA256 and !SHA384 only
994 // remove HMAC-SHA256 and HMAC-SHA384 cipher suites, not GCM cipher suites
995 // with SHA256 or SHA384 as the handshake hash.
996 // This matches the list of SSLClientSocketOpenSSL in Chromium.
997 SSL_CTX_set_cipher_list(ctx,
998 "DEFAULT:!NULL:!aNULL:!SHA256:!SHA384:!aECDH:!AESGCM+AES256:!aPSK");
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000999
1000#ifdef HAVE_DTLS_SRTP
1001 if (!srtp_ciphers_.empty()) {
1002 if (SSL_CTX_set_tlsext_use_srtp(ctx, srtp_ciphers_.c_str())) {
1003 SSL_CTX_free(ctx);
1004 return NULL;
1005 }
1006 }
1007#endif
1008
1009 return ctx;
1010}
1011
1012int OpenSSLStreamAdapter::SSLVerifyCallback(int ok, X509_STORE_CTX* store) {
1013 // Get our SSL structure from the store
1014 SSL* ssl = reinterpret_cast<SSL*>(X509_STORE_CTX_get_ex_data(
1015 store,
1016 SSL_get_ex_data_X509_STORE_CTX_idx()));
1017 OpenSSLStreamAdapter* stream =
1018 reinterpret_cast<OpenSSLStreamAdapter*>(SSL_get_app_data(ssl));
1019
1020 if (stream->peer_certificate_digest_algorithm_.empty()) {
1021 return 0;
1022 }
1023 X509* cert = X509_STORE_CTX_get_current_cert(store);
henrike@webrtc.org4e5f65a2014-06-05 20:40:11 +00001024 int depth = X509_STORE_CTX_get_error_depth(store);
1025
1026 // For now We ignore the parent certificates and verify the leaf against
1027 // the digest.
1028 //
1029 // TODO(jiayl): Verify the chain is a proper chain and report the chain to
1030 // |stream->peer_certificate_|, like what NSS does.
1031 if (depth > 0) {
1032 LOG(LS_INFO) << "Ignored chained certificate at depth " << depth;
1033 return 1;
1034 }
1035
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001036 unsigned char digest[EVP_MAX_MD_SIZE];
1037 size_t digest_length;
1038 if (!OpenSSLCertificate::ComputeDigest(
1039 cert,
1040 stream->peer_certificate_digest_algorithm_,
1041 digest, sizeof(digest),
1042 &digest_length)) {
1043 LOG(LS_WARNING) << "Failed to compute peer cert digest.";
1044 return 0;
1045 }
henrike@webrtc.org4e5f65a2014-06-05 20:40:11 +00001046
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001047 Buffer computed_digest(digest, digest_length);
1048 if (computed_digest != stream->peer_certificate_digest_value_) {
1049 LOG(LS_WARNING) << "Rejected peer certificate due to mismatched digest.";
1050 return 0;
1051 }
1052 // Ignore any verification error if the digest matches, since there is no
1053 // value in checking the validity of a self-signed cert issued by untrusted
1054 // sources.
1055 LOG(LS_INFO) << "Accepted peer certificate.";
henrike@webrtc.org4e5f65a2014-06-05 20:40:11 +00001056
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001057 // Record the peer's certificate.
1058 stream->peer_certificate_.reset(new OpenSSLCertificate(cert));
1059 return 1;
1060}
1061
1062// This code is taken from the "Network Security with OpenSSL"
1063// sample in chapter 5
1064bool OpenSSLStreamAdapter::SSLPostConnectionCheck(SSL* ssl,
1065 const char* server_name,
1066 const X509* peer_cert,
1067 const std::string
1068 &peer_digest) {
1069 ASSERT(server_name != NULL);
1070 bool ok;
1071 if (server_name[0] != '\0') { // traditional mode
1072 ok = OpenSSLAdapter::VerifyServerName(ssl, server_name, ignore_bad_cert());
1073
1074 if (ok) {
1075 ok = (SSL_get_verify_result(ssl) == X509_V_OK ||
1076 custom_verification_succeeded_);
1077 }
1078 } else { // peer-to-peer mode
1079 ASSERT((peer_cert != NULL) || (!peer_digest.empty()));
1080 // no server name validation
1081 ok = true;
1082 }
1083
1084 if (!ok && ignore_bad_cert()) {
1085 LOG(LS_ERROR) << "SSL_get_verify_result(ssl) = "
1086 << SSL_get_verify_result(ssl);
1087 LOG(LS_INFO) << "Other TLS post connection checks failed.";
1088 ok = true;
1089 }
1090
1091 return ok;
1092}
1093
1094bool OpenSSLStreamAdapter::HaveDtls() {
1095 return true;
1096}
1097
1098bool OpenSSLStreamAdapter::HaveDtlsSrtp() {
1099#ifdef HAVE_DTLS_SRTP
1100 return true;
1101#else
1102 return false;
1103#endif
1104}
1105
1106bool OpenSSLStreamAdapter::HaveExporter() {
1107#ifdef HAVE_DTLS_SRTP
1108 return true;
1109#else
1110 return false;
1111#endif
1112}
1113
Joachim Bauch831c5582015-05-20 12:48:41 +02001114std::string OpenSSLStreamAdapter::GetDefaultSslCipher(
1115 SSLProtocolVersion version) {
1116 switch (version) {
1117 case SSL_PROTOCOL_TLS_10:
1118 case SSL_PROTOCOL_TLS_11:
1119 return kDefaultSslCipher10;
1120 case SSL_PROTOCOL_TLS_12:
1121 default:
1122#ifdef OPENSSL_IS_BORINGSSL
1123 if (EVP_has_aes_hardware()) {
1124 return kDefaultSslCipher12;
1125 } else {
1126 return kDefaultSslCipher12NoAesGcm;
1127 }
1128#else // !OPENSSL_IS_BORINGSSL
1129 return kDefaultSslCipher12;
1130#endif
1131 }
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +00001132}
1133
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001134} // namespace rtc
1135
1136#endif // HAVE_OPENSSL_SSL_H