blob: 61bf6743d6479784017458a89f75338028af3f59 [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
Steve Anton10542f22019-01-11 09:11:00 -080011#include "rtc_base/openssl_stream_adapter.h"
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000012
13#include <openssl/bio.h>
14#include <openssl/crypto.h>
15#include <openssl/err.h>
16#include <openssl/rand.h>
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +000017#include <openssl/tls1.h>
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000018#include <openssl/x509v3.h>
Ali Tofigh7fa90572022-03-17 15:47:49 +010019
20#include "absl/strings/string_view.h"
torbjorngaad67802016-04-07 08:55:28 -070021#ifndef OPENSSL_IS_BORINGSSL
22#include <openssl/dtls1.h>
ssarohabbfed522016-12-11 18:42:07 -080023#include <openssl/ssl.h>
torbjorngaad67802016-04-07 08:55:28 -070024#endif
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000025
Guido Urdaneta14bba6e2020-09-25 16:00:51 +020026#include <atomic>
jbauch555604a2016-04-26 03:13:22 -070027#include <memory>
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -070028#include <utility>
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000029#include <vector>
30
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020031#include "rtc_base/checks.h"
32#include "rtc_base/logging.h"
Karl Wiberge40468b2017-11-22 10:42:26 +010033#include "rtc_base/numerics/safe_conversions.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020034#include "rtc_base/openssl.h"
Steve Anton10542f22019-01-11 09:11:00 -080035#include "rtc_base/openssl_adapter.h"
36#include "rtc_base/openssl_digest.h"
Taylor Brandstetter165c6182020-12-10 16:23:03 -080037#ifdef OPENSSL_IS_BORINGSSL
38#include "rtc_base/boringssl_identity.h"
39#else
Steve Anton10542f22019-01-11 09:11:00 -080040#include "rtc_base/openssl_identity.h"
Taylor Brandstetter165c6182020-12-10 16:23:03 -080041#endif
42#include "rtc_base/openssl_utility.h"
Steve Anton10542f22019-01-11 09:11:00 -080043#include "rtc_base/ssl_certificate.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020044#include "rtc_base/stream.h"
Philipp Hancke117e6922022-06-17 14:14:55 +020045#include "rtc_base/string_encode.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020046#include "rtc_base/thread.h"
Steve Anton10542f22019-01-11 09:11:00 -080047#include "rtc_base/time_utils.h"
Harald Alvestrand13799132020-03-09 19:39:36 +010048#include "system_wrappers/include/field_trial.h"
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000049
Jiawei Oua9c94d52018-01-30 23:05:07 -080050#if (OPENSSL_VERSION_NUMBER < 0x10100000L)
51#error "webrtc requires at least OpenSSL version 1.1.0, to support DTLS-SRTP"
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +010052#endif
53
Benjamin Wright8e98c602019-02-28 17:25:01 -080054// Defines for the TLS Cipher Suite Map.
55#define DEFINE_CIPHER_ENTRY_SSL3(name) \
56 { SSL3_CK_##name, "TLS_" #name }
57#define DEFINE_CIPHER_ENTRY_TLS1(name) \
58 { TLS1_CK_##name, "TLS_" #name }
59
60namespace rtc {
61namespace {
Danil Chapovalov5286dcf2022-07-18 17:04:56 +020062using ::webrtc::SafeTask;
Artem Titov96e3b992021-07-26 16:03:14 +020063// SRTP cipher suite table. `internal_name` is used to construct a
Guo-wei Shieh521ed7b2015-11-18 19:41:53 -080064// colon-separated profile strings which is needed by
65// SSL_CTX_set_tlsext_use_srtp().
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000066struct SrtpCipherMapEntry {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000067 const char* internal_name;
Guo-wei Shieh521ed7b2015-11-18 19:41:53 -080068 const int id;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000069};
70
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +010071// Cipher name table. Maps internal OpenSSL cipher ids to the RFC name.
72struct SslCipherMapEntry {
73 uint32_t openssl_id;
74 const char* rfc_name;
75};
76
Benjamin Wright8e98c602019-02-28 17:25:01 -080077// This isn't elegant, but it's better than an external reference
78constexpr SrtpCipherMapEntry kSrtpCipherMap[] = {
Mirko Bonadei7750d802021-07-26 17:27:42 +020079 {"SRTP_AES128_CM_SHA1_80", kSrtpAes128CmSha1_80},
80 {"SRTP_AES128_CM_SHA1_32", kSrtpAes128CmSha1_32},
81 {"SRTP_AEAD_AES_128_GCM", kSrtpAeadAes128Gcm},
82 {"SRTP_AEAD_AES_256_GCM", kSrtpAeadAes256Gcm}};
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +010083
Benjamin Wright8e98c602019-02-28 17:25:01 -080084#ifndef OPENSSL_IS_BORINGSSL
David Benjamin3c1f05d2017-12-01 17:28:03 -050085// The "SSL_CIPHER_standard_name" function is only available in OpenSSL when
86// compiled with tracing, so we need to define the mapping manually here.
Benjamin Wright8e98c602019-02-28 17:25:01 -080087constexpr SslCipherMapEntry kSslCipherMap[] = {
deadbeef37f5ecf2017-02-27 14:06:41 -080088 // TLS v1.0 ciphersuites from RFC2246.
89 DEFINE_CIPHER_ENTRY_SSL3(RSA_RC4_128_SHA),
90 {SSL3_CK_RSA_DES_192_CBC3_SHA, "TLS_RSA_WITH_3DES_EDE_CBC_SHA"},
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +010091
deadbeef37f5ecf2017-02-27 14:06:41 -080092 // AES ciphersuites from RFC3268.
93 {TLS1_CK_RSA_WITH_AES_128_SHA, "TLS_RSA_WITH_AES_128_CBC_SHA"},
94 {TLS1_CK_DHE_RSA_WITH_AES_128_SHA, "TLS_DHE_RSA_WITH_AES_128_CBC_SHA"},
95 {TLS1_CK_RSA_WITH_AES_256_SHA, "TLS_RSA_WITH_AES_256_CBC_SHA"},
96 {TLS1_CK_DHE_RSA_WITH_AES_256_SHA, "TLS_DHE_RSA_WITH_AES_256_CBC_SHA"},
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +010097
deadbeef37f5ecf2017-02-27 14:06:41 -080098 // ECC ciphersuites from RFC4492.
99 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_ECDSA_WITH_RC4_128_SHA),
100 {TLS1_CK_ECDHE_ECDSA_WITH_DES_192_CBC3_SHA,
101 "TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA"},
102 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_ECDSA_WITH_AES_128_CBC_SHA),
103 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_ECDSA_WITH_AES_256_CBC_SHA),
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +0100104
deadbeef37f5ecf2017-02-27 14:06:41 -0800105 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_RSA_WITH_RC4_128_SHA),
106 {TLS1_CK_ECDHE_RSA_WITH_DES_192_CBC3_SHA,
107 "TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA"},
108 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_RSA_WITH_AES_128_CBC_SHA),
109 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_RSA_WITH_AES_256_CBC_SHA),
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +0100110
deadbeef37f5ecf2017-02-27 14:06:41 -0800111 // TLS v1.2 ciphersuites.
112 {TLS1_CK_RSA_WITH_AES_128_SHA256, "TLS_RSA_WITH_AES_128_CBC_SHA256"},
113 {TLS1_CK_RSA_WITH_AES_256_SHA256, "TLS_RSA_WITH_AES_256_CBC_SHA256"},
114 {TLS1_CK_DHE_RSA_WITH_AES_128_SHA256,
115 "TLS_DHE_RSA_WITH_AES_128_CBC_SHA256"},
116 {TLS1_CK_DHE_RSA_WITH_AES_256_SHA256,
117 "TLS_DHE_RSA_WITH_AES_256_CBC_SHA256"},
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +0100118
deadbeef37f5ecf2017-02-27 14:06:41 -0800119 // TLS v1.2 GCM ciphersuites from RFC5288.
120 DEFINE_CIPHER_ENTRY_TLS1(RSA_WITH_AES_128_GCM_SHA256),
121 DEFINE_CIPHER_ENTRY_TLS1(RSA_WITH_AES_256_GCM_SHA384),
122 DEFINE_CIPHER_ENTRY_TLS1(DHE_RSA_WITH_AES_128_GCM_SHA256),
123 DEFINE_CIPHER_ENTRY_TLS1(DHE_RSA_WITH_AES_256_GCM_SHA384),
124 DEFINE_CIPHER_ENTRY_TLS1(DH_RSA_WITH_AES_128_GCM_SHA256),
125 DEFINE_CIPHER_ENTRY_TLS1(DH_RSA_WITH_AES_256_GCM_SHA384),
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +0100126
deadbeef37f5ecf2017-02-27 14:06:41 -0800127 // ECDH HMAC based ciphersuites from RFC5289.
128 {TLS1_CK_ECDHE_ECDSA_WITH_AES_128_SHA256,
129 "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256"},
130 {TLS1_CK_ECDHE_ECDSA_WITH_AES_256_SHA384,
131 "TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384"},
132 {TLS1_CK_ECDHE_RSA_WITH_AES_128_SHA256,
133 "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256"},
134 {TLS1_CK_ECDHE_RSA_WITH_AES_256_SHA384,
135 "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384"},
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +0100136
deadbeef37f5ecf2017-02-27 14:06:41 -0800137 // ECDH GCM based ciphersuites from RFC5289.
138 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_ECDSA_WITH_AES_128_GCM_SHA256),
139 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_ECDSA_WITH_AES_256_GCM_SHA384),
140 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_RSA_WITH_AES_128_GCM_SHA256),
141 DEFINE_CIPHER_ENTRY_TLS1(ECDHE_RSA_WITH_AES_256_GCM_SHA384),
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +0100142
deadbeef37f5ecf2017-02-27 14:06:41 -0800143 {0, nullptr}};
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +0100144#endif // #ifndef OPENSSL_IS_BORINGSSL
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +0000145
Benjamin Wright8e98c602019-02-28 17:25:01 -0800146#ifdef OPENSSL_IS_BORINGSSL
147// Enabled by EnableTimeCallbackForTesting. Should never be set in production
148// code.
149bool g_use_time_callback_for_testing = false;
150// Not used in production code. Actual time should be relative to Jan 1, 1970.
151void TimeCallbackForTesting(const SSL* ssl, struct timeval* out_clock) {
152 int64_t time = TimeNanos();
153 out_clock->tv_sec = time / kNumNanosecsPerSec;
154 out_clock->tv_usec = (time % kNumNanosecsPerSec) / kNumNanosecsPerMicrosec;
155}
156#endif
Guo-wei Shieh456696a2015-09-30 21:48:54 -0700157
Benjamin Wright8e98c602019-02-28 17:25:01 -0800158} // namespace
Guo-wei Shieh456696a2015-09-30 21:48:54 -0700159
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
Jiawei Oueb0df082018-02-02 14:51:18 -0800171static BIO_METHOD* BIO_stream_method() {
172 static BIO_METHOD* method = [] {
173 BIO_METHOD* method = BIO_meth_new(BIO_TYPE_BIO, "stream");
174 BIO_meth_set_write(method, stream_write);
175 BIO_meth_set_read(method, stream_read);
176 BIO_meth_set_puts(method, stream_puts);
177 BIO_meth_set_ctrl(method, stream_ctrl);
178 BIO_meth_set_create(method, stream_new);
179 BIO_meth_set_destroy(method, stream_free);
180 return method;
181 }();
182 return method;
183}
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000184
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000185static BIO* BIO_new_stream(StreamInterface* stream) {
Jiawei Oueb0df082018-02-02 14:51:18 -0800186 BIO* ret = BIO_new(BIO_stream_method());
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700187 if (ret == nullptr) {
deadbeef37f5ecf2017-02-27 14:06:41 -0800188 return nullptr;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700189 }
Jiawei Oueb0df082018-02-02 14:51:18 -0800190 BIO_set_data(ret, stream);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000191 return ret;
192}
193
194// bio methods return 1 (or at least non-zero) on success and 0 on failure.
195
196static int stream_new(BIO* b) {
Jiawei Oueb0df082018-02-02 14:51:18 -0800197 BIO_set_shutdown(b, 0);
198 BIO_set_init(b, 1);
199 BIO_set_data(b, 0);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000200 return 1;
201}
202
203static int stream_free(BIO* b) {
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700204 if (b == nullptr) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000205 return 0;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700206 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000207 return 1;
208}
209
210static int stream_read(BIO* b, char* out, int outl) {
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700211 if (!out) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000212 return -1;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700213 }
Jiawei Oueb0df082018-02-02 14:51:18 -0800214 StreamInterface* stream = static_cast<StreamInterface*>(BIO_get_data(b));
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000215 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_BLOCK) {
222 BIO_set_retry_read(b);
223 }
224 return -1;
225}
226
227static int stream_write(BIO* b, const char* in, int inl) {
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700228 if (!in) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000229 return -1;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700230 }
Jiawei Oueb0df082018-02-02 14:51:18 -0800231 StreamInterface* stream = static_cast<StreamInterface*>(BIO_get_data(b));
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000232 BIO_clear_retry_flags(b);
233 size_t written;
234 int error;
235 StreamResult result = stream->Write(in, inl, &written, &error);
236 if (result == SR_SUCCESS) {
henrike@webrtc.orgd89b69a2014-11-06 17:23:09 +0000237 return checked_cast<int>(written);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000238 } else if (result == SR_BLOCK) {
239 BIO_set_retry_write(b);
240 }
241 return -1;
242}
243
244static int stream_puts(BIO* b, const char* str) {
henrike@webrtc.orgd89b69a2014-11-06 17:23:09 +0000245 return stream_write(b, str, checked_cast<int>(strlen(str)));
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000246}
247
248static long stream_ctrl(BIO* b, int cmd, long num, void* ptr) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000249 switch (cmd) {
250 case BIO_CTRL_RESET:
251 return 0;
Jiawei Ou018dd6e2018-01-30 12:13:48 -0800252 case BIO_CTRL_EOF: {
253 StreamInterface* stream = static_cast<StreamInterface*>(ptr);
254 // 1 means end-of-stream.
255 return (stream->GetState() == SS_CLOSED) ? 1 : 0;
256 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000257 case BIO_CTRL_WPENDING:
258 case BIO_CTRL_PENDING:
259 return 0;
260 case BIO_CTRL_FLUSH:
261 return 1;
Henrik Lundinf4baca52015-06-10 09:45:58 +0200262 case BIO_CTRL_DGRAM_QUERY_MTU:
263 // openssl defaults to mtu=256 unless we return something here.
264 // The handshake doesn't actually need to send packets above 1k,
265 // so this seems like a sensible value that should work in most cases.
266 // Webrtc uses the same value for video packets.
267 return 1200;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000268 default:
269 return 0;
270 }
271}
272
273/////////////////////////////////////////////////////////////////////////////
274// OpenSSLStreamAdapter
275/////////////////////////////////////////////////////////////////////////////
276
Guido Urdaneta14bba6e2020-09-25 16:00:51 +0200277static std::atomic<bool> g_use_legacy_tls_protocols_override(false);
278static std::atomic<bool> g_allow_legacy_tls_protocols(false);
279
280void SetAllowLegacyTLSProtocols(const absl::optional<bool>& allow) {
281 g_use_legacy_tls_protocols_override.store(allow.has_value());
282 if (allow.has_value())
283 g_allow_legacy_tls_protocols.store(allow.value());
284}
285
286bool ShouldAllowLegacyTLSProtocols() {
287 return g_use_legacy_tls_protocols_override.load()
288 ? g_allow_legacy_tls_protocols.load()
Guido Urdanetaae2e8642020-10-26 09:55:26 +0100289 : webrtc::field_trial::IsEnabled("WebRTC-LegacyTlsProtocols");
Guido Urdaneta14bba6e2020-09-25 16:00:51 +0200290}
291
Harald Alvestrand8515d5a2020-03-20 22:51:32 +0100292OpenSSLStreamAdapter::OpenSSLStreamAdapter(
293 std::unique_ptr<StreamInterface> stream)
Niels Möller0131a4d2021-04-16 09:16:21 +0200294 : stream_(std::move(stream)),
Tommi04482982020-10-05 12:43:53 +0000295 owner_(rtc::Thread::Current()),
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000296 state_(SSL_NONE),
297 role_(SSL_CLIENT),
Guo-wei Shieha7446d22016-01-11 15:27:03 -0800298 ssl_read_needs_write_(false),
299 ssl_write_needs_read_(false),
deadbeef37f5ecf2017-02-27 14:06:41 -0800300 ssl_(nullptr),
301 ssl_ctx_(nullptr),
Joachim Bauch831c5582015-05-20 12:48:41 +0200302 ssl_mode_(SSL_MODE_TLS),
Harald Alvestrand13799132020-03-09 19:39:36 +0100303 ssl_max_version_(SSL_PROTOCOL_TLS_12),
304 // Default is to support legacy TLS protocols.
305 // This will be changed to default non-support in M82 or M83.
Niels Möller0131a4d2021-04-16 09:16:21 +0200306 support_legacy_tls_protocols_flag_(ShouldAllowLegacyTLSProtocols()) {
307 stream_->SignalEvent.connect(this, &OpenSSLStreamAdapter::OnEvent);
308}
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000309
310OpenSSLStreamAdapter::~OpenSSLStreamAdapter() {
Tommi04482982020-10-05 12:43:53 +0000311 timeout_task_.Stop();
deadbeef89824f62016-09-30 11:55:43 -0700312 Cleanup(0);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000313}
314
Harald Alvestrand8515d5a2020-03-20 22:51:32 +0100315void OpenSSLStreamAdapter::SetIdentity(std::unique_ptr<SSLIdentity> identity) {
deadbeef89824f62016-09-30 11:55:43 -0700316 RTC_DCHECK(!identity_);
Taylor Brandstetter165c6182020-12-10 16:23:03 -0800317#ifdef OPENSSL_IS_BORINGSSL
318 identity_.reset(static_cast<BoringSSLIdentity*>(identity.release()));
319#else
Harald Alvestrand8515d5a2020-03-20 22:51:32 +0100320 identity_.reset(static_cast<OpenSSLIdentity*>(identity.release()));
Taylor Brandstetter165c6182020-12-10 16:23:03 -0800321#endif
Harald Alvestrand8515d5a2020-03-20 22:51:32 +0100322}
323
Taylor Brandstetter165c6182020-12-10 16:23:03 -0800324SSLIdentity* OpenSSLStreamAdapter::GetIdentityForTesting() const {
Harald Alvestrand8515d5a2020-03-20 22:51:32 +0100325 return identity_.get();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000326}
327
328void OpenSSLStreamAdapter::SetServerRole(SSLRole role) {
329 role_ = role;
330}
331
deadbeef89824f62016-09-30 11:55:43 -0700332bool OpenSSLStreamAdapter::SetPeerCertificateDigest(
Ali Tofigh7fa90572022-03-17 15:47:49 +0100333 absl::string_view digest_alg,
deadbeef89824f62016-09-30 11:55:43 -0700334 const unsigned char* digest_val,
335 size_t digest_len,
336 SSLPeerCertificateDigestError* error) {
337 RTC_DCHECK(!peer_certificate_verified_);
Benjamin Wright5d355542018-10-26 17:57:00 -0700338 RTC_DCHECK(!HasPeerCertificateDigest());
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000339 size_t expected_len;
deadbeef89824f62016-09-30 11:55:43 -0700340 if (error) {
341 *error = SSLPeerCertificateDigestError::NONE;
342 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000343
344 if (!OpenSSLDigest::GetDigestSize(digest_alg, &expected_len)) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100345 RTC_LOG(LS_WARNING) << "Unknown digest algorithm: " << digest_alg;
deadbeef89824f62016-09-30 11:55:43 -0700346 if (error) {
347 *error = SSLPeerCertificateDigestError::UNKNOWN_ALGORITHM;
348 }
deadbeef81f6f4f2016-09-19 17:20:52 -0700349 return false;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000350 }
deadbeef89824f62016-09-30 11:55:43 -0700351 if (expected_len != digest_len) {
352 if (error) {
353 *error = SSLPeerCertificateDigestError::INVALID_LENGTH;
354 }
deadbeef81f6f4f2016-09-19 17:20:52 -0700355 return false;
deadbeef89824f62016-09-30 11:55:43 -0700356 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000357
358 peer_certificate_digest_value_.SetData(digest_val, digest_len);
Ali Tofigh7fa90572022-03-17 15:47:49 +0100359 peer_certificate_digest_algorithm_ = std::string(digest_alg);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000360
Taylor Brandstetterc3928662018-02-23 13:04:51 -0800361 if (!peer_cert_chain_) {
deadbeef89824f62016-09-30 11:55:43 -0700362 // Normal case, where the digest is set before we obtain the certificate
363 // from the handshake.
364 return true;
365 }
366
367 if (!VerifyPeerCertificate()) {
368 Error("SetPeerCertificateDigest", -1, SSL_AD_BAD_CERTIFICATE, false);
369 if (error) {
370 *error = SSLPeerCertificateDigestError::VERIFICATION_FAILED;
371 }
372 return false;
373 }
374
375 if (state_ == SSL_CONNECTED) {
376 // Post the event asynchronously to unwind the stack. The caller
377 // of ContinueSSL may be the same object listening for these
378 // events and may not be prepared for reentrancy.
379 PostEvent(SE_OPEN | SE_READ | SE_WRITE, 0);
380 }
381
deadbeef81f6f4f2016-09-19 17:20:52 -0700382 return true;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000383}
384
Guo-wei Shieh521ed7b2015-11-18 19:41:53 -0800385std::string OpenSSLStreamAdapter::SslCipherSuiteToName(int cipher_suite) {
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +0100386#ifdef OPENSSL_IS_BORINGSSL
Guo-wei Shieh521ed7b2015-11-18 19:41:53 -0800387 const SSL_CIPHER* ssl_cipher = SSL_get_cipher_by_value(cipher_suite);
Guo-wei Shieh456696a2015-09-30 21:48:54 -0700388 if (!ssl_cipher) {
389 return std::string();
390 }
David Benjamina8f73762017-09-28 15:49:42 -0400391 return SSL_CIPHER_standard_name(ssl_cipher);
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +0100392#else
Joachim Reiersene457e432022-10-21 12:08:22 -0700393 const int openssl_cipher_id = 0x03000000L | cipher_suite;
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +0100394 for (const SslCipherMapEntry* entry = kSslCipherMap; entry->rfc_name;
395 ++entry) {
Joachim Reiersene457e432022-10-21 12:08:22 -0700396 if (openssl_cipher_id == static_cast<int>(entry->openssl_id)) {
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +0100397 return entry->rfc_name;
398 }
399 }
400 return std::string();
401#endif
Guo-wei Shieh456696a2015-09-30 21:48:54 -0700402}
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +0000403
Guo-wei Shieh521ed7b2015-11-18 19:41:53 -0800404bool OpenSSLStreamAdapter::GetSslCipherSuite(int* cipher_suite) {
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700405 if (state_ != SSL_CONNECTED) {
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +0000406 return false;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700407 }
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +0000408
409 const SSL_CIPHER* current_cipher = SSL_get_current_cipher(ssl_);
deadbeef37f5ecf2017-02-27 14:06:41 -0800410 if (current_cipher == nullptr) {
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +0000411 return false;
412 }
413
Guo-wei Shieh521ed7b2015-11-18 19:41:53 -0800414 *cipher_suite = static_cast<uint16_t>(SSL_CIPHER_get_id(current_cipher));
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +0000415 return true;
416}
417
Harald Alvestrand5cb78072019-10-28 09:51:17 +0100418SSLProtocolVersion OpenSSLStreamAdapter::GetSslVersion() const {
Benjamin Wright8e98c602019-02-28 17:25:01 -0800419 if (state_ != SSL_CONNECTED) {
Harald Alvestrand5cb78072019-10-28 09:51:17 +0100420 return SSL_PROTOCOL_NOT_GIVEN;
Benjamin Wright8e98c602019-02-28 17:25:01 -0800421 }
torbjorng43166b82016-03-11 00:06:47 -0800422
423 int ssl_version = SSL_version(ssl_);
424 if (ssl_mode_ == SSL_MODE_DTLS) {
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700425 if (ssl_version == DTLS1_VERSION) {
torbjorng43166b82016-03-11 00:06:47 -0800426 return SSL_PROTOCOL_DTLS_10;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700427 } else if (ssl_version == DTLS1_2_VERSION) {
torbjorng43166b82016-03-11 00:06:47 -0800428 return SSL_PROTOCOL_DTLS_12;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700429 }
torbjorng43166b82016-03-11 00:06:47 -0800430 } else {
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700431 if (ssl_version == TLS1_VERSION) {
torbjorng43166b82016-03-11 00:06:47 -0800432 return SSL_PROTOCOL_TLS_10;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700433 } else if (ssl_version == TLS1_1_VERSION) {
torbjorng43166b82016-03-11 00:06:47 -0800434 return SSL_PROTOCOL_TLS_11;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700435 } else if (ssl_version == TLS1_2_VERSION) {
torbjorng43166b82016-03-11 00:06:47 -0800436 return SSL_PROTOCOL_TLS_12;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700437 }
torbjorng43166b82016-03-11 00:06:47 -0800438 }
439
Harald Alvestrand5cb78072019-10-28 09:51:17 +0100440 return SSL_PROTOCOL_NOT_GIVEN;
441}
442
443bool OpenSSLStreamAdapter::GetSslVersionBytes(int* version) const {
444 if (state_ != SSL_CONNECTED) {
445 return false;
446 }
447 *version = SSL_version(ssl_);
448 return true;
torbjorng43166b82016-03-11 00:06:47 -0800449}
450
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000451// Key Extractor interface
Ali Tofigh7fa90572022-03-17 15:47:49 +0100452bool OpenSSLStreamAdapter::ExportKeyingMaterial(absl::string_view label,
Peter Boström0c4e06b2015-10-07 12:23:21 +0200453 const uint8_t* context,
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000454 size_t context_len,
455 bool use_context,
Peter Boström0c4e06b2015-10-07 12:23:21 +0200456 uint8_t* result,
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000457 size_t result_len) {
Ali Tofigh7fa90572022-03-17 15:47:49 +0100458 if (SSL_export_keying_material(ssl_, result, result_len, label.data(),
459 label.length(), context, context_len,
460 use_context) != 1) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000461 return false;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700462 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000463 return true;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000464}
465
Guo-wei Shieh521ed7b2015-11-18 19:41:53 -0800466bool OpenSSLStreamAdapter::SetDtlsSrtpCryptoSuites(
467 const std::vector<int>& ciphers) {
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700468 if (state_ != SSL_NONE) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000469 return false;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700470 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000471
Benjamin Wright8e98c602019-02-28 17:25:01 -0800472 std::string internal_ciphers;
473 for (const int cipher : ciphers) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000474 bool found = false;
Benjamin Wright8e98c602019-02-28 17:25:01 -0800475 for (const auto& entry : kSrtpCipherMap) {
476 if (cipher == entry.id) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000477 found = true;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700478 if (!internal_ciphers.empty()) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000479 internal_ciphers += ":";
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700480 }
Benjamin Wright8e98c602019-02-28 17:25:01 -0800481 internal_ciphers += entry.internal_name;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000482 break;
483 }
484 }
485
486 if (!found) {
Benjamin Wright8e98c602019-02-28 17:25:01 -0800487 RTC_LOG(LS_ERROR) << "Could not find cipher: " << cipher;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000488 return false;
489 }
490 }
491
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700492 if (internal_ciphers.empty()) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000493 return false;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700494 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000495
496 srtp_ciphers_ = internal_ciphers;
497 return true;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000498}
499
Guo-wei Shieh521ed7b2015-11-18 19:41:53 -0800500bool OpenSSLStreamAdapter::GetDtlsSrtpCryptoSuite(int* crypto_suite) {
deadbeef89824f62016-09-30 11:55:43 -0700501 RTC_DCHECK(state_ == SSL_CONNECTED);
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700502 if (state_ != SSL_CONNECTED) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000503 return false;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700504 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000505
Yves Gerey665174f2018-06-19 15:03:05 +0200506 const SRTP_PROTECTION_PROFILE* srtp_profile =
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000507 SSL_get_selected_srtp_profile(ssl_);
508
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700509 if (!srtp_profile) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000510 return false;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700511 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000512
Guo-wei Shieh521ed7b2015-11-18 19:41:53 -0800513 *crypto_suite = srtp_profile->id;
deadbeef89824f62016-09-30 11:55:43 -0700514 RTC_DCHECK(!SrtpCryptoSuiteToName(*crypto_suite).empty());
Guo-wei Shieh521ed7b2015-11-18 19:41:53 -0800515 return true;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000516}
517
deadbeef89824f62016-09-30 11:55:43 -0700518bool OpenSSLStreamAdapter::IsTlsConnected() {
519 return state_ == SSL_CONNECTED;
520}
521
Taylor Brandstetterc8762a82016-08-11 12:01:49 -0700522int OpenSSLStreamAdapter::StartSSL() {
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700523 // Don't allow StartSSL to be called twice.
deadbeef89824f62016-09-30 11:55:43 -0700524 if (state_ != SSL_NONE) {
deadbeef89824f62016-09-30 11:55:43 -0700525 return -1;
526 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000527
Niels Möller0131a4d2021-04-16 09:16:21 +0200528 if (stream_->GetState() != SS_OPEN) {
Taylor Brandstetterc8762a82016-08-11 12:01:49 -0700529 state_ = SSL_WAIT;
530 return 0;
531 }
532
533 state_ = SSL_CONNECTING;
534 if (int err = BeginSSL()) {
deadbeef89824f62016-09-30 11:55:43 -0700535 Error("BeginSSL", err, 0, false);
Taylor Brandstetterc8762a82016-08-11 12:01:49 -0700536 return err;
537 }
538
539 return 0;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000540}
541
542void OpenSSLStreamAdapter::SetMode(SSLMode mode) {
deadbeef89824f62016-09-30 11:55:43 -0700543 RTC_DCHECK(state_ == SSL_NONE);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000544 ssl_mode_ = mode;
545}
546
Joachim Bauch831c5582015-05-20 12:48:41 +0200547void OpenSSLStreamAdapter::SetMaxProtocolVersion(SSLProtocolVersion version) {
deadbeef37f5ecf2017-02-27 14:06:41 -0800548 RTC_DCHECK(ssl_ctx_ == nullptr);
Joachim Bauch831c5582015-05-20 12:48:41 +0200549 ssl_max_version_ = version;
550}
551
Yves Gerey665174f2018-06-19 15:03:05 +0200552void OpenSSLStreamAdapter::SetInitialRetransmissionTimeout(int timeout_ms) {
deadbeef37f5ecf2017-02-27 14:06:41 -0800553 RTC_DCHECK(ssl_ctx_ == nullptr);
skvladd0309122017-02-02 17:18:37 -0800554 dtls_handshake_timeout_ms_ = timeout_ms;
555}
556
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000557//
558// StreamInterface Implementation
559//
560
Yves Gerey665174f2018-06-19 15:03:05 +0200561StreamResult OpenSSLStreamAdapter::Write(const void* data,
562 size_t data_len,
563 size_t* written,
564 int* error) {
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200565 RTC_DLOG(LS_VERBOSE) << "OpenSSLStreamAdapter::Write(" << data_len << ")";
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000566
567 switch (state_) {
Yves Gerey665174f2018-06-19 15:03:05 +0200568 case SSL_NONE:
569 // pass-through in clear text
Niels Möller0131a4d2021-04-16 09:16:21 +0200570 return stream_->Write(data, data_len, written, error);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000571
Yves Gerey665174f2018-06-19 15:03:05 +0200572 case SSL_WAIT:
573 case SSL_CONNECTING:
deadbeef89824f62016-09-30 11:55:43 -0700574 return SR_BLOCK;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000575
Yves Gerey665174f2018-06-19 15:03:05 +0200576 case SSL_CONNECTED:
Benjamin Wright5d355542018-10-26 17:57:00 -0700577 if (WaitingToVerifyPeerCertificate()) {
Yves Gerey665174f2018-06-19 15:03:05 +0200578 return SR_BLOCK;
579 }
580 break;
581
582 case SSL_ERROR:
583 case SSL_CLOSED:
584 default:
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700585 if (error) {
Yves Gerey665174f2018-06-19 15:03:05 +0200586 *error = ssl_error_code_;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700587 }
Yves Gerey665174f2018-06-19 15:03:05 +0200588 return SR_ERROR;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000589 }
590
591 // OpenSSL will return an error if we try to write zero bytes
592 if (data_len == 0) {
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700593 if (written) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000594 *written = 0;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700595 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000596 return SR_SUCCESS;
597 }
598
599 ssl_write_needs_read_ = false;
600
henrike@webrtc.orgd89b69a2014-11-06 17:23:09 +0000601 int code = SSL_write(ssl_, data, checked_cast<int>(data_len));
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000602 int ssl_error = SSL_get_error(ssl_, code);
603 switch (ssl_error) {
Yves Gerey665174f2018-06-19 15:03:05 +0200604 case SSL_ERROR_NONE:
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200605 RTC_DLOG(LS_VERBOSE) << " -- success";
Yves Gerey665174f2018-06-19 15:03:05 +0200606 RTC_DCHECK_GT(code, 0);
607 RTC_DCHECK_LE(code, data_len);
608 if (written)
609 *written = code;
610 return SR_SUCCESS;
611 case SSL_ERROR_WANT_READ:
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200612 RTC_DLOG(LS_VERBOSE) << " -- error want read";
Yves Gerey665174f2018-06-19 15:03:05 +0200613 ssl_write_needs_read_ = true;
614 return SR_BLOCK;
615 case SSL_ERROR_WANT_WRITE:
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200616 RTC_DLOG(LS_VERBOSE) << " -- error want write";
Yves Gerey665174f2018-06-19 15:03:05 +0200617 return SR_BLOCK;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000618
Yves Gerey665174f2018-06-19 15:03:05 +0200619 case SSL_ERROR_ZERO_RETURN:
620 default:
621 Error("SSL_write", (ssl_error ? ssl_error : -1), 0, false);
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700622 if (error) {
Yves Gerey665174f2018-06-19 15:03:05 +0200623 *error = ssl_error_code_;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700624 }
Yves Gerey665174f2018-06-19 15:03:05 +0200625 return SR_ERROR;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000626 }
627 // not reached
628}
629
Yves Gerey665174f2018-06-19 15:03:05 +0200630StreamResult OpenSSLStreamAdapter::Read(void* data,
631 size_t data_len,
632 size_t* read,
633 int* error) {
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200634 RTC_DLOG(LS_VERBOSE) << "OpenSSLStreamAdapter::Read(" << data_len << ")";
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000635 switch (state_) {
636 case SSL_NONE:
637 // pass-through in clear text
Niels Möller0131a4d2021-04-16 09:16:21 +0200638 return stream_->Read(data, data_len, read, error);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000639 case SSL_WAIT:
640 case SSL_CONNECTING:
641 return SR_BLOCK;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000642 case SSL_CONNECTED:
Benjamin Wright5d355542018-10-26 17:57:00 -0700643 if (WaitingToVerifyPeerCertificate()) {
deadbeef89824f62016-09-30 11:55:43 -0700644 return SR_BLOCK;
645 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000646 break;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000647 case SSL_CLOSED:
648 return SR_EOS;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000649 case SSL_ERROR:
650 default:
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700651 if (error) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000652 *error = ssl_error_code_;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700653 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000654 return SR_ERROR;
655 }
656
657 // Don't trust OpenSSL with zero byte reads
658 if (data_len == 0) {
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700659 if (read) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000660 *read = 0;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700661 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000662 return SR_SUCCESS;
663 }
664
665 ssl_read_needs_write_ = false;
666
Benjamin Wrightf54e30b2019-02-26 17:33:50 -0800667 const int code = SSL_read(ssl_, data, checked_cast<int>(data_len));
668 const int ssl_error = SSL_get_error(ssl_, code);
669
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000670 switch (ssl_error) {
671 case SSL_ERROR_NONE:
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200672 RTC_DLOG(LS_VERBOSE) << " -- success";
kwibergee89e782017-08-09 17:22:01 -0700673 RTC_DCHECK_GT(code, 0);
674 RTC_DCHECK_LE(code, data_len);
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700675 if (read) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000676 *read = code;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700677 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000678
679 if (ssl_mode_ == SSL_MODE_DTLS) {
680 // Enforce atomic reads -- this is a short read
681 unsigned int pending = SSL_pending(ssl_);
682
683 if (pending) {
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200684 RTC_DLOG(LS_INFO) << " -- short DTLS read. flushing";
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000685 FlushInput(pending);
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700686 if (error) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000687 *error = SSE_MSG_TRUNC;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700688 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000689 return SR_ERROR;
690 }
691 }
692 return SR_SUCCESS;
693 case SSL_ERROR_WANT_READ:
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200694 RTC_DLOG(LS_VERBOSE) << " -- error want read";
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000695 return SR_BLOCK;
696 case SSL_ERROR_WANT_WRITE:
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200697 RTC_DLOG(LS_VERBOSE) << " -- error want write";
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000698 ssl_read_needs_write_ = true;
699 return SR_BLOCK;
700 case SSL_ERROR_ZERO_RETURN:
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200701 RTC_DLOG(LS_VERBOSE) << " -- remote side closed";
deadbeef89824f62016-09-30 11:55:43 -0700702 Close();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000703 return SR_EOS;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000704 default:
deadbeef89824f62016-09-30 11:55:43 -0700705 Error("SSL_read", (ssl_error ? ssl_error : -1), 0, false);
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700706 if (error) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000707 *error = ssl_error_code_;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700708 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000709 return SR_ERROR;
710 }
711 // not reached
712}
713
714void OpenSSLStreamAdapter::FlushInput(unsigned int left) {
715 unsigned char buf[2048];
716
717 while (left) {
718 // This should always succeed
Benjamin Wrightf54e30b2019-02-26 17:33:50 -0800719 const int toread = (sizeof(buf) < left) ? sizeof(buf) : left;
720 const int code = SSL_read(ssl_, buf, toread);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000721
Benjamin Wrightf54e30b2019-02-26 17:33:50 -0800722 const int ssl_error = SSL_get_error(ssl_, code);
deadbeef89824f62016-09-30 11:55:43 -0700723 RTC_DCHECK(ssl_error == SSL_ERROR_NONE);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000724
725 if (ssl_error != SSL_ERROR_NONE) {
Jonas Olssonaddc3802018-02-01 09:53:06 +0100726 RTC_DLOG(LS_VERBOSE) << " -- error " << code;
deadbeef89824f62016-09-30 11:55:43 -0700727 Error("SSL_read", (ssl_error ? ssl_error : -1), 0, false);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000728 return;
729 }
730
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200731 RTC_DLOG(LS_VERBOSE) << " -- flushed " << code << " bytes";
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000732 left -= code;
733 }
734}
735
736void OpenSSLStreamAdapter::Close() {
deadbeef89824f62016-09-30 11:55:43 -0700737 Cleanup(0);
738 RTC_DCHECK(state_ == SSL_CLOSED || state_ == SSL_ERROR);
739 // When we're closed at SSL layer, also close the stream level which
740 // performs necessary clean up. Otherwise, a new incoming packet after
741 // this could overflow the stream buffer.
Niels Möller0131a4d2021-04-16 09:16:21 +0200742 stream_->Close();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000743}
744
745StreamState OpenSSLStreamAdapter::GetState() const {
746 switch (state_) {
747 case SSL_WAIT:
748 case SSL_CONNECTING:
749 return SS_OPENING;
750 case SSL_CONNECTED:
Benjamin Wright5d355542018-10-26 17:57:00 -0700751 if (WaitingToVerifyPeerCertificate()) {
deadbeef89824f62016-09-30 11:55:43 -0700752 return SS_OPENING;
753 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000754 return SS_OPEN;
755 default:
756 return SS_CLOSED;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700757 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000758 // not reached
759}
760
Yves Gerey665174f2018-06-19 15:03:05 +0200761void OpenSSLStreamAdapter::OnEvent(StreamInterface* stream,
762 int events,
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000763 int err) {
764 int events_to_signal = 0;
765 int signal_error = 0;
Niels Möller0131a4d2021-04-16 09:16:21 +0200766 RTC_DCHECK(stream == stream_.get());
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700767
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000768 if ((events & SE_OPEN)) {
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200769 RTC_DLOG(LS_VERBOSE) << "OpenSSLStreamAdapter::OnEvent SE_OPEN";
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000770 if (state_ != SSL_WAIT) {
deadbeef89824f62016-09-30 11:55:43 -0700771 RTC_DCHECK(state_ == SSL_NONE);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000772 events_to_signal |= SE_OPEN;
773 } else {
774 state_ = SSL_CONNECTING;
775 if (int err = BeginSSL()) {
deadbeef89824f62016-09-30 11:55:43 -0700776 Error("BeginSSL", err, 0, true);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000777 return;
778 }
779 }
780 }
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700781
Yves Gerey665174f2018-06-19 15:03:05 +0200782 if ((events & (SE_READ | SE_WRITE))) {
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200783 RTC_DLOG(LS_VERBOSE) << "OpenSSLStreamAdapter::OnEvent"
784 << ((events & SE_READ) ? " SE_READ" : "")
785 << ((events & SE_WRITE) ? " SE_WRITE" : "");
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000786 if (state_ == SSL_NONE) {
Yves Gerey665174f2018-06-19 15:03:05 +0200787 events_to_signal |= events & (SE_READ | SE_WRITE);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000788 } else if (state_ == SSL_CONNECTING) {
789 if (int err = ContinueSSL()) {
deadbeef89824f62016-09-30 11:55:43 -0700790 Error("ContinueSSL", err, 0, true);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000791 return;
792 }
793 } else if (state_ == SSL_CONNECTED) {
794 if (((events & SE_READ) && ssl_write_needs_read_) ||
795 (events & SE_WRITE)) {
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200796 RTC_DLOG(LS_VERBOSE) << " -- onStreamWriteable";
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000797 events_to_signal |= SE_WRITE;
798 }
799 if (((events & SE_WRITE) && ssl_read_needs_write_) ||
800 (events & SE_READ)) {
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200801 RTC_DLOG(LS_VERBOSE) << " -- onStreamReadable";
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000802 events_to_signal |= SE_READ;
803 }
804 }
805 }
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700806
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000807 if ((events & SE_CLOSE)) {
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200808 RTC_DLOG(LS_VERBOSE) << "OpenSSLStreamAdapter::OnEvent(SE_CLOSE, " << err
809 << ")";
deadbeef89824f62016-09-30 11:55:43 -0700810 Cleanup(0);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000811 events_to_signal |= SE_CLOSE;
812 // SE_CLOSE is the only event that uses the final parameter to OnEvent().
deadbeef89824f62016-09-30 11:55:43 -0700813 RTC_DCHECK(signal_error == 0);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000814 signal_error = err;
815 }
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700816
817 if (events_to_signal) {
Niels Möller0131a4d2021-04-16 09:16:21 +0200818 // Note that the adapter presents itself as the origin of the stream events,
819 // since users of the adapter may not recognize the adapted object.
820 SignalEvent(this, events_to_signal, signal_error);
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700821 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000822}
823
Tommi04482982020-10-05 12:43:53 +0000824void OpenSSLStreamAdapter::PostEvent(int events, int err) {
Danil Chapovalov5286dcf2022-07-18 17:04:56 +0200825 owner_->PostTask(SafeTask(task_safety_.flag(), [this, events, err]() {
826 SignalEvent(this, events, err);
827 }));
Tommi04482982020-10-05 12:43:53 +0000828}
829
830void OpenSSLStreamAdapter::SetTimeout(int delay_ms) {
831 // We need to accept 0 delay here as well as >0 delay, because
832 // DTLSv1_get_timeout seems to frequently return 0 ms.
833 RTC_DCHECK_GE(delay_ms, 0);
834 RTC_DCHECK(!timeout_task_.Running());
835
836 timeout_task_ = webrtc::RepeatingTaskHandle::DelayedStart(
837 owner_, webrtc::TimeDelta::Millis(delay_ms),
838 [flag = task_safety_.flag(), this]() {
839 if (flag->alive()) {
840 RTC_DLOG(LS_INFO) << "DTLS timeout expired";
841 timeout_task_.Stop();
Jonas Oreland808f4942021-06-16 13:42:20 +0200842 int res = DTLSv1_handle_timeout(ssl_);
843 if (res > 0) {
844 RTC_LOG(LS_INFO) << "DTLS retransmission";
845 } else if (res < 0) {
846 RTC_LOG(LS_INFO) << "DTLSv1_handle_timeout() return -1";
Philipp Hancke9c83d9d2022-04-28 19:01:28 +0200847 Error("DTLSv1_handle_timeout", res, -1, true);
848 return webrtc::TimeDelta::PlusInfinity();
Jonas Oreland808f4942021-06-16 13:42:20 +0200849 }
Tommi04482982020-10-05 12:43:53 +0000850 ContinueSSL();
851 } else {
Artem Titovd3251962021-11-15 16:57:07 +0100852 RTC_DCHECK_NOTREACHED();
Tommi04482982020-10-05 12:43:53 +0000853 }
854 // This callback will never run again (stopped above).
855 return webrtc::TimeDelta::PlusInfinity();
856 });
857}
858
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000859int OpenSSLStreamAdapter::BeginSSL() {
deadbeef89824f62016-09-30 11:55:43 -0700860 RTC_DCHECK(state_ == SSL_CONNECTING);
Taylor Brandstetterc8762a82016-08-11 12:01:49 -0700861 // The underlying stream has opened.
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200862 RTC_DLOG(LS_INFO) << "BeginSSL with peer.";
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000863
deadbeef37f5ecf2017-02-27 14:06:41 -0800864 BIO* bio = nullptr;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000865
Taylor Brandstetterc8762a82016-08-11 12:01:49 -0700866 // First set up the context.
deadbeef37f5ecf2017-02-27 14:06:41 -0800867 RTC_DCHECK(ssl_ctx_ == nullptr);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000868 ssl_ctx_ = SetupSSLContext();
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700869 if (!ssl_ctx_) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000870 return -1;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700871 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000872
Niels Möller0131a4d2021-04-16 09:16:21 +0200873 bio = BIO_new_stream(stream_.get());
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700874 if (!bio) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000875 return -1;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700876 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000877
878 ssl_ = SSL_new(ssl_ctx_);
879 if (!ssl_) {
880 BIO_free(bio);
881 return -1;
882 }
883
884 SSL_set_app_data(ssl_, this);
885
886 SSL_set_bio(ssl_, bio, bio); // the SSL object owns the bio now.
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +0100887 if (ssl_mode_ == SSL_MODE_DTLS) {
Taylor Brandstetter4f0dfbd2016-06-15 17:15:23 -0700888#ifdef OPENSSL_IS_BORINGSSL
skvladd0309122017-02-02 17:18:37 -0800889 DTLSv1_set_initial_timeout_duration(ssl_, dtls_handshake_timeout_ms_);
Taylor Brandstetter4f0dfbd2016-06-15 17:15:23 -0700890#else
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +0100891 // Enable read-ahead for DTLS so whole packets are read from internal BIO
892 // before parsing. This is done internally by BoringSSL for DTLS.
893 SSL_set_read_ahead(ssl_, 1);
philipel49c08692016-05-24 01:49:43 -0700894#endif
Taylor Brandstetter4f0dfbd2016-06-15 17:15:23 -0700895 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000896
897 SSL_set_mode(ssl_, SSL_MODE_ENABLE_PARTIAL_WRITE |
Yves Gerey665174f2018-06-19 15:03:05 +0200898 SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000899
900 // Do the connect
901 return ContinueSSL();
902}
903
904int OpenSSLStreamAdapter::ContinueSSL() {
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200905 RTC_DLOG(LS_VERBOSE) << "ContinueSSL";
deadbeef89824f62016-09-30 11:55:43 -0700906 RTC_DCHECK(state_ == SSL_CONNECTING);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000907
908 // Clear the DTLS timer
Tommi04482982020-10-05 12:43:53 +0000909 timeout_task_.Stop();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000910
Benjamin Wrightf54e30b2019-02-26 17:33:50 -0800911 const int code = (role_ == SSL_CLIENT) ? SSL_connect(ssl_) : SSL_accept(ssl_);
912 const int ssl_error = SSL_get_error(ssl_, code);
913
914 switch (ssl_error) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000915 case SSL_ERROR_NONE:
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200916 RTC_DLOG(LS_VERBOSE) << " -- success";
deadbeef89824f62016-09-30 11:55:43 -0700917 // By this point, OpenSSL should have given us a certificate, or errored
918 // out if one was missing.
Benjamin Wrightb19b4972018-10-25 10:46:49 -0700919 RTC_DCHECK(peer_cert_chain_ || !GetClientAuthEnabled());
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000920
921 state_ = SSL_CONNECTED;
Benjamin Wright5d355542018-10-26 17:57:00 -0700922 if (!WaitingToVerifyPeerCertificate()) {
deadbeef89824f62016-09-30 11:55:43 -0700923 // We have everything we need to start the connection, so signal
924 // SE_OPEN. If we need a client certificate fingerprint and don't have
925 // it yet, we'll instead signal SE_OPEN in SetPeerCertificateDigest.
926 //
Taylor Brandstetterfe69a742016-09-30 17:34:32 -0700927 // TODO(deadbeef): Post this event asynchronously to unwind the stack.
928 // The caller of ContinueSSL may be the same object listening for these
929 // events and may not be prepared for reentrancy.
930 // PostEvent(SE_OPEN | SE_READ | SE_WRITE, 0);
Niels Möller0131a4d2021-04-16 09:16:21 +0200931 SignalEvent(this, SE_OPEN | SE_READ | SE_WRITE, 0);
deadbeef89824f62016-09-30 11:55:43 -0700932 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000933 break;
934
935 case SSL_ERROR_WANT_READ: {
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200936 RTC_DLOG(LS_VERBOSE) << " -- error want read";
Mirko Bonadei675513b2017-11-09 11:09:25 +0100937 struct timeval timeout;
938 if (DTLSv1_get_timeout(ssl_, &timeout)) {
939 int delay = timeout.tv_sec * 1000 + timeout.tv_usec / 1000;
Tommi04482982020-10-05 12:43:53 +0000940 SetTimeout(delay);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000941 }
Yves Gerey665174f2018-06-19 15:03:05 +0200942 } break;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000943
944 case SSL_ERROR_WANT_WRITE:
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200945 RTC_DLOG(LS_VERBOSE) << " -- error want write";
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000946 break;
947
948 case SSL_ERROR_ZERO_RETURN:
949 default:
zhihuangd82eee02016-08-26 11:25:05 -0700950 SSLHandshakeError ssl_handshake_err = SSLHandshakeError::UNKNOWN;
951 int err_code = ERR_peek_last_error();
952 if (err_code != 0 && ERR_GET_REASON(err_code) == SSL_R_NO_SHARED_CIPHER) {
953 ssl_handshake_err = SSLHandshakeError::INCOMPATIBLE_CIPHERSUITE;
954 }
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200955 RTC_DLOG(LS_VERBOSE) << " -- error " << code << ", " << err_code << ", "
956 << ERR_GET_REASON(err_code);
Sam Zackrissonb298f742020-10-06 11:40:30 +0000957 SignalSSLHandshakeError(ssl_handshake_err);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000958 return (ssl_error != 0) ? ssl_error : -1;
959 }
960
961 return 0;
962}
963
Ali Tofigh2ab914c2022-04-13 12:55:15 +0200964void OpenSSLStreamAdapter::Error(absl::string_view context,
deadbeef89824f62016-09-30 11:55:43 -0700965 int err,
966 uint8_t alert,
967 bool signal) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100968 RTC_LOG(LS_WARNING) << "OpenSSLStreamAdapter::Error(" << context << ", "
969 << err << ", " << static_cast<int>(alert) << ")";
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000970 state_ = SSL_ERROR;
971 ssl_error_code_ = err;
deadbeef89824f62016-09-30 11:55:43 -0700972 Cleanup(alert);
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700973 if (signal) {
Niels Möller0131a4d2021-04-16 09:16:21 +0200974 SignalEvent(this, SE_CLOSE, err);
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -0700975 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000976}
977
deadbeef89824f62016-09-30 11:55:43 -0700978void OpenSSLStreamAdapter::Cleanup(uint8_t alert) {
Tomas Gunnarssond48ff452020-10-02 18:28:46 +0200979 RTC_DLOG(LS_INFO) << "Cleanup";
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000980
981 if (state_ != SSL_ERROR) {
982 state_ = SSL_CLOSED;
983 ssl_error_code_ = 0;
984 }
985
986 if (ssl_) {
deadbeef89824f62016-09-30 11:55:43 -0700987 int ret;
988// SSL_send_fatal_alert is only available in BoringSSL.
989#ifdef OPENSSL_IS_BORINGSSL
990 if (alert) {
991 ret = SSL_send_fatal_alert(ssl_, alert);
992 if (ret < 0) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100993 RTC_LOG(LS_WARNING) << "SSL_send_fatal_alert failed, error = "
994 << SSL_get_error(ssl_, ret);
deadbeef89824f62016-09-30 11:55:43 -0700995 }
996 } else {
997#endif
998 ret = SSL_shutdown(ssl_);
999 if (ret < 0) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01001000 RTC_LOG(LS_WARNING)
1001 << "SSL_shutdown failed, error = " << SSL_get_error(ssl_, ret);
deadbeef89824f62016-09-30 11:55:43 -07001002 }
1003#ifdef OPENSSL_IS_BORINGSSL
jiayl@webrtc.orgf1d751c2014-09-25 16:38:46 +00001004 }
deadbeef89824f62016-09-30 11:55:43 -07001005#endif
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001006 SSL_free(ssl_);
deadbeef37f5ecf2017-02-27 14:06:41 -08001007 ssl_ = nullptr;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001008 }
1009 if (ssl_ctx_) {
1010 SSL_CTX_free(ssl_ctx_);
deadbeef37f5ecf2017-02-27 14:06:41 -08001011 ssl_ctx_ = nullptr;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001012 }
1013 identity_.reset();
Taylor Brandstetterc3928662018-02-23 13:04:51 -08001014 peer_cert_chain_.reset();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001015
1016 // Clear the DTLS timer
Tommi04482982020-10-05 12:43:53 +00001017 timeout_task_.Stop();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001018}
1019
1020SSL_CTX* OpenSSLStreamAdapter::SetupSSLContext() {
Taylor Brandstetter165c6182020-12-10 16:23:03 -08001021#ifdef OPENSSL_IS_BORINGSSL
1022 // If X509 objects aren't used, we can use these methods to avoid
1023 // linking the sizable crypto/x509 code, using CRYPTO_BUFFER instead.
1024 SSL_CTX* ctx =
1025 SSL_CTX_new(ssl_mode_ == SSL_MODE_DTLS ? DTLS_with_buffers_method()
1026 : TLS_with_buffers_method());
1027#else
David Benjamin170a4b32019-01-30 09:46:16 -06001028 SSL_CTX* ctx =
1029 SSL_CTX_new(ssl_mode_ == SSL_MODE_DTLS ? DTLS_method() : TLS_method());
Taylor Brandstetter165c6182020-12-10 16:23:03 -08001030#endif
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -07001031 if (ctx == nullptr) {
deadbeef37f5ecf2017-02-27 14:06:41 -08001032 return nullptr;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -07001033 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001034
Harald Alvestrand13799132020-03-09 19:39:36 +01001035 if (support_legacy_tls_protocols_flag_) {
1036 // TODO(https://bugs.webrtc.org/10261): Completely remove this branch in
1037 // M84.
1038 SSL_CTX_set_min_proto_version(
1039 ctx, ssl_mode_ == SSL_MODE_DTLS ? DTLS1_VERSION : TLS1_VERSION);
1040 switch (ssl_max_version_) {
1041 case SSL_PROTOCOL_TLS_10:
1042 SSL_CTX_set_max_proto_version(
1043 ctx, ssl_mode_ == SSL_MODE_DTLS ? DTLS1_VERSION : TLS1_VERSION);
1044 break;
1045 case SSL_PROTOCOL_TLS_11:
1046 SSL_CTX_set_max_proto_version(
1047 ctx, ssl_mode_ == SSL_MODE_DTLS ? DTLS1_VERSION : TLS1_1_VERSION);
1048 break;
1049 case SSL_PROTOCOL_TLS_12:
1050 default:
1051 SSL_CTX_set_max_proto_version(
1052 ctx, ssl_mode_ == SSL_MODE_DTLS ? DTLS1_2_VERSION : TLS1_2_VERSION);
1053 break;
1054 }
1055 } else {
1056 // TODO(https://bugs.webrtc.org/10261): Make this the default in M84.
1057 SSL_CTX_set_min_proto_version(
1058 ctx, ssl_mode_ == SSL_MODE_DTLS ? DTLS1_2_VERSION : TLS1_2_VERSION);
1059 SSL_CTX_set_max_proto_version(
1060 ctx, ssl_mode_ == SSL_MODE_DTLS ? DTLS1_2_VERSION : TLS1_2_VERSION);
Joachim Bauch831c5582015-05-20 12:48:41 +02001061 }
Harald Alvestrand13799132020-03-09 19:39:36 +01001062
David Benjamin170a4b32019-01-30 09:46:16 -06001063#ifdef OPENSSL_IS_BORINGSSL
1064 // SSL_CTX_set_current_time_cb is only supported in BoringSSL.
deadbeef6cf94a02016-11-28 17:38:34 -08001065 if (g_use_time_callback_for_testing) {
1066 SSL_CTX_set_current_time_cb(ctx, &TimeCallbackForTesting);
1067 }
Taylor Brandstetter165c6182020-12-10 16:23:03 -08001068 SSL_CTX_set0_buffer_pool(ctx, openssl::GetBufferPool());
Torbjorn Granlund9adc91d2016-03-24 14:05:06 +01001069#endif
Joachim Bauch831c5582015-05-20 12:48:41 +02001070
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001071 if (identity_ && !identity_->ConfigureIdentity(ctx)) {
1072 SSL_CTX_free(ctx);
deadbeef37f5ecf2017-02-27 14:06:41 -08001073 return nullptr;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001074 }
1075
tfarinaa41ab932015-10-30 16:08:48 -07001076#if !defined(NDEBUG)
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001077 SSL_CTX_set_info_callback(ctx, OpenSSLAdapter::SSLInfoCallback);
1078#endif
1079
tkchin@webrtc.orgc569a492014-09-23 05:56:44 +00001080 int mode = SSL_VERIFY_PEER;
Benjamin Wrightb19b4972018-10-25 10:46:49 -07001081 if (GetClientAuthEnabled()) {
tkchin@webrtc.orgc569a492014-09-23 05:56:44 +00001082 // Require a certificate from the client.
1083 // Note: Normally this is always true in production, but it may be disabled
1084 // for testing purposes (e.g. SSLAdapter unit tests).
1085 mode |= SSL_VERIFY_FAIL_IF_NO_PEER_CERT;
1086 }
1087
David Benjamindc246562017-09-29 12:14:08 -04001088 // Configure a custom certificate verification callback to check the peer
Taylor Brandstetter165c6182020-12-10 16:23:03 -08001089 // certificate digest.
1090#ifdef OPENSSL_IS_BORINGSSL
1091 // Use CRYPTO_BUFFER version of the callback if building with BoringSSL.
1092 SSL_CTX_set_custom_verify(ctx, mode, SSLVerifyCallback);
1093#else
1094 // Note the second argument to SSL_CTX_set_verify is to override individual
1095 // errors in the default verification logic, which is not what we want here.
David Benjamindc246562017-09-29 12:14:08 -04001096 SSL_CTX_set_verify(ctx, mode, nullptr);
1097 SSL_CTX_set_cert_verify_callback(ctx, SSLVerifyCallback, nullptr);
Taylor Brandstetter165c6182020-12-10 16:23:03 -08001098#endif
David Benjamindc246562017-09-29 12:14:08 -04001099
Joachim Bauch831c5582015-05-20 12:48:41 +02001100 // Select list of available ciphers. Note that !SHA256 and !SHA384 only
1101 // remove HMAC-SHA256 and HMAC-SHA384 cipher suites, not GCM cipher suites
1102 // with SHA256 or SHA384 as the handshake hash.
David Benjamin7a46cc52021-08-17 16:56:20 -04001103 // This matches the list of SSLClientSocketImpl in Chromium.
deadbeef37f5ecf2017-02-27 14:06:41 -08001104 SSL_CTX_set_cipher_list(
David Benjamin7a46cc52021-08-17 16:56:20 -04001105 ctx,
1106 "DEFAULT:!NULL:!aNULL:!SHA256:!SHA384:!aECDH:!AESGCM+AES256:!aPSK:!3DES");
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001107
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001108 if (!srtp_ciphers_.empty()) {
1109 if (SSL_CTX_set_tlsext_use_srtp(ctx, srtp_ciphers_.c_str())) {
1110 SSL_CTX_free(ctx);
deadbeef37f5ecf2017-02-27 14:06:41 -08001111 return nullptr;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001112 }
1113 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001114
1115 return ctx;
1116}
1117
deadbeef89824f62016-09-30 11:55:43 -07001118bool OpenSSLStreamAdapter::VerifyPeerCertificate() {
Benjamin Wright5d355542018-10-26 17:57:00 -07001119 if (!HasPeerCertificateDigest() || !peer_cert_chain_ ||
Taylor Brandstetterc3928662018-02-23 13:04:51 -08001120 !peer_cert_chain_->GetSize()) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01001121 RTC_LOG(LS_WARNING) << "Missing digest or peer certificate.";
deadbeef89824f62016-09-30 11:55:43 -07001122 return false;
1123 }
deadbeef81f6f4f2016-09-19 17:20:52 -07001124
deadbeef89824f62016-09-30 11:55:43 -07001125 unsigned char digest[EVP_MAX_MD_SIZE];
1126 size_t digest_length;
Taylor Brandstetter165c6182020-12-10 16:23:03 -08001127 if (!peer_cert_chain_->Get(0).ComputeDigest(
1128 peer_certificate_digest_algorithm_, digest, sizeof(digest),
1129 &digest_length)) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01001130 RTC_LOG(LS_WARNING) << "Failed to compute peer cert digest.";
deadbeef89824f62016-09-30 11:55:43 -07001131 return false;
1132 }
1133
1134 Buffer computed_digest(digest, digest_length);
1135 if (computed_digest != peer_certificate_digest_value_) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01001136 RTC_LOG(LS_WARNING)
Philipp Hancke117e6922022-06-17 14:14:55 +02001137 << "Rejected peer certificate due to mismatched digest using "
1138 << peer_certificate_digest_algorithm_ << ". Expected "
1139 << rtc::hex_encode_with_delimiter(peer_certificate_digest_value_, ':')
1140 << " got " << rtc::hex_encode_with_delimiter(computed_digest, ':');
jbauchf8f457b2017-03-09 16:24:57 -08001141 return false;
deadbeef81f6f4f2016-09-19 17:20:52 -07001142 }
deadbeef89824f62016-09-30 11:55:43 -07001143 // Ignore any verification error if the digest matches, since there is no
1144 // value in checking the validity of a self-signed cert issued by untrusted
1145 // sources.
Tomas Gunnarssond48ff452020-10-02 18:28:46 +02001146 RTC_DLOG(LS_INFO) << "Accepted peer certificate.";
deadbeef89824f62016-09-30 11:55:43 -07001147 peer_certificate_verified_ = true;
1148 return true;
1149}
1150
Jian Cui0a8798b2017-11-16 16:58:02 -08001151std::unique_ptr<SSLCertChain> OpenSSLStreamAdapter::GetPeerSSLCertChain()
1152 const {
Steve Antonf25303e2018-10-16 15:23:31 -07001153 return peer_cert_chain_ ? peer_cert_chain_->Clone() : nullptr;
Jian Cui0a8798b2017-11-16 16:58:02 -08001154}
1155
Taylor Brandstetter165c6182020-12-10 16:23:03 -08001156#ifdef OPENSSL_IS_BORINGSSL
1157enum ssl_verify_result_t OpenSSLStreamAdapter::SSLVerifyCallback(
1158 SSL* ssl,
1159 uint8_t* out_alert) {
1160 // Get our OpenSSLStreamAdapter from the context.
1161 OpenSSLStreamAdapter* stream =
1162 reinterpret_cast<OpenSSLStreamAdapter*>(SSL_get_app_data(ssl));
1163 const STACK_OF(CRYPTO_BUFFER)* chain = SSL_get0_peer_certificates(ssl);
1164 // Creates certificate chain.
1165 std::vector<std::unique_ptr<SSLCertificate>> cert_chain;
1166 for (CRYPTO_BUFFER* cert : chain) {
1167 cert_chain.emplace_back(new BoringSSLCertificate(bssl::UpRef(cert)));
1168 }
1169 stream->peer_cert_chain_.reset(new SSLCertChain(std::move(cert_chain)));
1170
1171 // If the peer certificate digest isn't known yet, we'll wait to verify
1172 // until it's known, and for now just return a success status.
1173 if (stream->peer_certificate_digest_algorithm_.empty()) {
1174 RTC_LOG(LS_INFO) << "Waiting to verify certificate until digest is known.";
1175 // TODO(deadbeef): Use ssl_verify_retry?
1176 return ssl_verify_ok;
1177 }
1178
1179 if (!stream->VerifyPeerCertificate()) {
1180 return ssl_verify_invalid;
1181 }
1182
1183 return ssl_verify_ok;
1184}
1185#else // OPENSSL_IS_BORINGSSL
David Benjamindc246562017-09-29 12:14:08 -04001186int OpenSSLStreamAdapter::SSLVerifyCallback(X509_STORE_CTX* store, void* arg) {
1187 // Get our SSL structure and OpenSSLStreamAdapter from the store.
deadbeef89824f62016-09-30 11:55:43 -07001188 SSL* ssl = reinterpret_cast<SSL*>(
1189 X509_STORE_CTX_get_ex_data(store, SSL_get_ex_data_X509_STORE_CTX_idx()));
deadbeef89824f62016-09-30 11:55:43 -07001190 OpenSSLStreamAdapter* stream =
1191 reinterpret_cast<OpenSSLStreamAdapter*>(SSL_get_app_data(ssl));
henrike@webrtc.org4e5f65a2014-06-05 20:40:11 +00001192
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001193 // Record the peer's certificate.
Jiawei Ou9d4e8402018-05-23 15:44:20 -07001194 X509* cert = X509_STORE_CTX_get0_cert(store);
Taylor Brandstetterc3928662018-02-23 13:04:51 -08001195 stream->peer_cert_chain_.reset(
Mirko Bonadei317a1f02019-09-17 17:06:18 +02001196 new SSLCertChain(std::make_unique<OpenSSLCertificate>(cert)));
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001197
deadbeef89824f62016-09-30 11:55:43 -07001198 // If the peer certificate digest isn't known yet, we'll wait to verify
1199 // until it's known, and for now just return a success status.
1200 if (stream->peer_certificate_digest_algorithm_.empty()) {
Tomas Gunnarssond48ff452020-10-02 18:28:46 +02001201 RTC_DLOG(LS_INFO) << "Waiting to verify certificate until digest is known.";
deadbeef89824f62016-09-30 11:55:43 -07001202 return 1;
1203 }
1204
David Benjamindc246562017-09-29 12:14:08 -04001205 if (!stream->VerifyPeerCertificate()) {
1206 X509_STORE_CTX_set_error(store, X509_V_ERR_CERT_REJECTED);
1207 return 0;
1208 }
1209
1210 return 1;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001211}
Taylor Brandstetter165c6182020-12-10 16:23:03 -08001212#endif // !OPENSSL_IS_BORINGSSL
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001213
Taylor Brandstetter4f0dfbd2016-06-15 17:15:23 -07001214bool OpenSSLStreamAdapter::IsBoringSsl() {
1215#ifdef OPENSSL_IS_BORINGSSL
1216 return true;
1217#else
1218 return false;
1219#endif
1220}
1221
torbjorng43166b82016-03-11 00:06:47 -08001222#define CDEF(X) \
1223 { static_cast<uint16_t>(TLS1_CK_##X & 0xffff), "TLS_" #X }
1224
1225struct cipher_list {
1226 uint16_t cipher;
1227 const char* cipher_str;
1228};
1229
1230// TODO(torbjorng): Perhaps add more cipher suites to these lists.
1231static const cipher_list OK_RSA_ciphers[] = {
Yves Gerey665174f2018-06-19 15:03:05 +02001232 CDEF(ECDHE_RSA_WITH_AES_128_CBC_SHA),
1233 CDEF(ECDHE_RSA_WITH_AES_256_CBC_SHA),
1234 CDEF(ECDHE_RSA_WITH_AES_128_GCM_SHA256),
torbjorng43166b82016-03-11 00:06:47 -08001235#ifdef TLS1_CK_ECDHE_RSA_WITH_AES_256_GCM_SHA256
Yves Gerey665174f2018-06-19 15:03:05 +02001236 CDEF(ECDHE_RSA_WITH_AES_256_GCM_SHA256),
torbjorng43166b82016-03-11 00:06:47 -08001237#endif
torbjorngaad67802016-04-07 08:55:28 -07001238#ifdef TLS1_CK_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
Yves Gerey665174f2018-06-19 15:03:05 +02001239 CDEF(ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256),
torbjorngaad67802016-04-07 08:55:28 -07001240#endif
torbjorng43166b82016-03-11 00:06:47 -08001241};
1242
1243static const cipher_list OK_ECDSA_ciphers[] = {
Yves Gerey665174f2018-06-19 15:03:05 +02001244 CDEF(ECDHE_ECDSA_WITH_AES_128_CBC_SHA),
1245 CDEF(ECDHE_ECDSA_WITH_AES_256_CBC_SHA),
1246 CDEF(ECDHE_ECDSA_WITH_AES_128_GCM_SHA256),
torbjorng43166b82016-03-11 00:06:47 -08001247#ifdef TLS1_CK_ECDHE_ECDSA_WITH_AES_256_GCM_SHA256
Yves Gerey665174f2018-06-19 15:03:05 +02001248 CDEF(ECDHE_ECDSA_WITH_AES_256_GCM_SHA256),
torbjorng43166b82016-03-11 00:06:47 -08001249#endif
torbjorngaad67802016-04-07 08:55:28 -07001250#ifdef TLS1_CK_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
Yves Gerey665174f2018-06-19 15:03:05 +02001251 CDEF(ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256),
torbjorngaad67802016-04-07 08:55:28 -07001252#endif
torbjorng43166b82016-03-11 00:06:47 -08001253};
1254#undef CDEF
1255
1256bool OpenSSLStreamAdapter::IsAcceptableCipher(int cipher, KeyType key_type) {
Torbjorn Granlundb6d4ec42015-08-17 14:08:59 +02001257 if (key_type == KT_RSA) {
torbjorng43166b82016-03-11 00:06:47 -08001258 for (const cipher_list& c : OK_RSA_ciphers) {
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -07001259 if (cipher == c.cipher) {
torbjorng43166b82016-03-11 00:06:47 -08001260 return true;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -07001261 }
Torbjorn Granlundb6d4ec42015-08-17 14:08:59 +02001262 }
Joachim Bauch831c5582015-05-20 12:48:41 +02001263 }
torbjorng43166b82016-03-11 00:06:47 -08001264
1265 if (key_type == KT_ECDSA) {
1266 for (const cipher_list& c : OK_ECDSA_ciphers) {
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -07001267 if (cipher == c.cipher) {
torbjorng43166b82016-03-11 00:06:47 -08001268 return true;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -07001269 }
torbjorng43166b82016-03-11 00:06:47 -08001270 }
1271 }
1272
1273 return false;
1274}
1275
Ali Tofigh7fa90572022-03-17 15:47:49 +01001276bool OpenSSLStreamAdapter::IsAcceptableCipher(absl::string_view cipher,
torbjorng43166b82016-03-11 00:06:47 -08001277 KeyType key_type) {
1278 if (key_type == KT_RSA) {
1279 for (const cipher_list& c : OK_RSA_ciphers) {
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -07001280 if (cipher == c.cipher_str) {
torbjorng43166b82016-03-11 00:06:47 -08001281 return true;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -07001282 }
torbjorng43166b82016-03-11 00:06:47 -08001283 }
1284 }
1285
1286 if (key_type == KT_ECDSA) {
1287 for (const cipher_list& c : OK_ECDSA_ciphers) {
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -07001288 if (cipher == c.cipher_str) {
torbjorng43166b82016-03-11 00:06:47 -08001289 return true;
Benjamin Wrightd4d5f8a2018-10-15 11:19:39 -07001290 }
torbjorng43166b82016-03-11 00:06:47 -08001291 }
1292 }
1293
1294 return false;
pthatcher@webrtc.org3ee4fe52015-02-11 22:34:36 +00001295}
1296
Benjamin Wrightb19b4972018-10-25 10:46:49 -07001297void OpenSSLStreamAdapter::EnableTimeCallbackForTesting() {
Joachim Reiersen637bed52019-04-25 10:41:35 -07001298#ifdef OPENSSL_IS_BORINGSSL
deadbeef6cf94a02016-11-28 17:38:34 -08001299 g_use_time_callback_for_testing = true;
Joachim Reiersen637bed52019-04-25 10:41:35 -07001300#endif
deadbeef6cf94a02016-11-28 17:38:34 -08001301}
1302
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001303} // namespace rtc