2014-06-20 20:00:00 +01:00
|
|
|
/*
|
|
|
|
* DTLS implementation written by Nagendra Modadugu
|
|
|
|
* (nagendra@cs.stanford.edu) for the OpenSSL project 2005.
|
|
|
|
*/
|
|
|
|
/* ====================================================================
|
|
|
|
* Copyright (c) 1999-2005 The OpenSSL Project. All rights reserved.
|
|
|
|
*
|
|
|
|
* Redistribution and use in source and binary forms, with or without
|
|
|
|
* modification, are permitted provided that the following conditions
|
|
|
|
* are met:
|
|
|
|
*
|
|
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer.
|
|
|
|
*
|
|
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer in
|
|
|
|
* the documentation and/or other materials provided with the
|
|
|
|
* distribution.
|
|
|
|
*
|
|
|
|
* 3. All advertising materials mentioning features or use of this
|
|
|
|
* software must display the following acknowledgment:
|
|
|
|
* "This product includes software developed by the OpenSSL Project
|
|
|
|
* for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
|
|
|
|
*
|
|
|
|
* 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
|
|
|
|
* endorse or promote products derived from this software without
|
|
|
|
* prior written permission. For written permission, please contact
|
|
|
|
* openssl-core@OpenSSL.org.
|
|
|
|
*
|
|
|
|
* 5. Products derived from this software may not be called "OpenSSL"
|
|
|
|
* nor may "OpenSSL" appear in their names without prior written
|
|
|
|
* permission of the OpenSSL Project.
|
|
|
|
*
|
|
|
|
* 6. Redistributions of any form whatsoever must retain the following
|
|
|
|
* acknowledgment:
|
|
|
|
* "This product includes software developed by the OpenSSL Project
|
|
|
|
* for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
|
|
|
|
*
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
|
|
|
|
* EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
|
|
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
|
|
|
|
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
|
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
|
|
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
|
|
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
|
|
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
|
|
|
|
* OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
* ====================================================================
|
|
|
|
*
|
|
|
|
* This product includes cryptographic software written by Eric Young
|
|
|
|
* (eay@cryptsoft.com). This product includes software written by Tim
|
|
|
|
* Hudson (tjh@cryptsoft.com). */
|
|
|
|
|
2015-09-15 06:48:04 +01:00
|
|
|
#include <openssl/ssl.h>
|
|
|
|
|
2016-06-21 15:33:21 +01:00
|
|
|
#include <assert.h>
|
2016-07-15 04:10:43 +01:00
|
|
|
#include <string.h>
|
2016-06-21 15:33:21 +01:00
|
|
|
|
2016-07-08 17:16:50 +01:00
|
|
|
#include <openssl/buf.h>
|
2016-07-15 04:10:43 +01:00
|
|
|
#include <openssl/err.h>
|
2016-07-08 17:16:50 +01:00
|
|
|
|
2016-12-13 06:07:13 +00:00
|
|
|
#include "../crypto/internal.h"
|
2015-04-08 03:38:30 +01:00
|
|
|
#include "internal.h"
|
2014-06-20 20:00:00 +01:00
|
|
|
|
|
|
|
|
Move libssl's internals into the bssl namespace.
This is horrible, but everything else I tried was worse. The goal with
this CL is to take the extern "C" out of ssl/internal.h and move most
symbols to namespace bssl, so we can start using C++ helpers and
destructors without worry.
Complications:
- Public API functions must be extern "C" and match their declaration in
ssl.h, which is unnamespaced. C++ really does not want you to
interleave namespaced and unnamespaced things. One can actually write
a namespaced extern "C" function, but this means, from C++'s
perspective, the function is namespaced. Trying to namespace the
public header would worked but ended up too deep a rabbithole.
- Our STACK_OF macros do not work right in namespaces.
- The typedefs for our exposed but opaque types are visible in the
header files and copied into consuming projects as forward
declarations. We ultimately want to give SSL a destructor, but
clobbering an unnamespaced ssl_st::~ssl_st seems bad manners.
- MSVC complains about ambiguous names if one typedefs SSL to bssl::SSL.
This CL opts for:
- ssl/*.cc must begin with #define BORINGSSL_INTERNAL_CXX_TYPES. This
informs the public headers to create forward declarations which are
compatible with our namespaces.
- For now, C++-defined type FOO ends up at bssl::FOO with a typedef
outside. Later I imagine we'll rename many of them.
- Internal functions get namespace bssl, so we stop worrying about
stomping the tls1_prf symbol. Exported C functions are stuck as they
are. Rather than try anything weird, bite the bullet and reorder files
which have a mix of public and private functions. I expect that over
time, the public functions will become fairly small as we move logic
to more idiomatic C++.
Files without any public C functions can just be written normally.
- To avoid MSVC troubles, some bssl types are renamed to CPlusPlusStyle
in advance of them being made idiomatic C++.
Bug: 132
Change-Id: Ic931895e117c38b14ff8d6e5a273e868796c7581
Reviewed-on: https://boringssl-review.googlesource.com/18124
Reviewed-by: David Benjamin <davidben@google.com>
2017-07-18 21:34:25 +01:00
|
|
|
using namespace bssl;
|
|
|
|
|
2016-12-04 04:23:52 +00:00
|
|
|
static int dtls1_supports_cipher(const SSL_CIPHER *cipher) {
|
|
|
|
return cipher->algorithm_enc != SSL_eNULL;
|
|
|
|
}
|
|
|
|
|
2017-08-03 00:46:29 +01:00
|
|
|
static void dtls1_on_handshake_complete(SSL *ssl) {
|
2017-08-03 01:06:53 +01:00
|
|
|
dtls1_release_current_message(ssl);
|
2017-08-03 00:46:29 +01:00
|
|
|
/* If we wrote the last flight, we'll have a timer left over without waiting
|
|
|
|
* for a read. Stop the timer but leave the flight around for post-handshake
|
|
|
|
* transmission logic. */
|
|
|
|
dtls1_stop_timer(ssl);
|
|
|
|
}
|
2016-12-04 04:23:52 +00:00
|
|
|
|
2017-07-19 03:45:18 +01:00
|
|
|
static int dtls1_set_read_state(SSL *ssl, UniquePtr<SSLAEADContext> aead_ctx) {
|
2016-07-15 04:10:43 +01:00
|
|
|
/* Cipher changes are illegal when there are buffered incoming messages. */
|
2017-06-26 03:42:55 +01:00
|
|
|
if (dtls_has_incoming_messages(ssl) || ssl->d1->has_change_cipher_spec) {
|
2016-07-15 04:10:43 +01:00
|
|
|
OPENSSL_PUT_ERROR(SSL, SSL_R_BUFFERED_MESSAGES_ON_CIPHER_CHANGE);
|
|
|
|
ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_UNEXPECTED_MESSAGE);
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
ssl->d1->r_epoch++;
|
2016-12-13 06:07:13 +00:00
|
|
|
OPENSSL_memset(&ssl->d1->bitmap, 0, sizeof(ssl->d1->bitmap));
|
|
|
|
OPENSSL_memset(ssl->s3->read_sequence, 0, sizeof(ssl->s3->read_sequence));
|
2016-07-15 04:10:43 +01:00
|
|
|
|
2017-07-19 03:45:18 +01:00
|
|
|
Delete(ssl->s3->aead_read_ctx);
|
|
|
|
ssl->s3->aead_read_ctx = aead_ctx.release();
|
2016-07-15 04:10:43 +01:00
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
|
2017-07-19 03:45:18 +01:00
|
|
|
static int dtls1_set_write_state(SSL *ssl, UniquePtr<SSLAEADContext> aead_ctx) {
|
2016-07-15 04:10:43 +01:00
|
|
|
ssl->d1->w_epoch++;
|
2016-12-13 06:07:13 +00:00
|
|
|
OPENSSL_memcpy(ssl->d1->last_write_sequence, ssl->s3->write_sequence,
|
|
|
|
sizeof(ssl->s3->write_sequence));
|
|
|
|
OPENSSL_memset(ssl->s3->write_sequence, 0, sizeof(ssl->s3->write_sequence));
|
2016-07-15 04:10:43 +01:00
|
|
|
|
2017-07-19 03:45:18 +01:00
|
|
|
Delete(ssl->d1->last_aead_write_ctx);
|
|
|
|
ssl->d1->last_aead_write_ctx = ssl->s3->aead_write_ctx;
|
|
|
|
ssl->s3->aead_write_ctx = aead_ctx.release();
|
2016-07-15 04:10:43 +01:00
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
|
2016-07-08 17:05:45 +01:00
|
|
|
static const SSL_PROTOCOL_METHOD kDTLSProtocolMethod = {
|
2015-03-05 06:56:32 +00:00
|
|
|
1 /* is_dtls */,
|
|
|
|
dtls1_new,
|
|
|
|
dtls1_free,
|
|
|
|
dtls1_get_message,
|
2016-11-14 08:12:11 +00:00
|
|
|
dtls1_get_current_message,
|
2016-07-27 22:51:49 +01:00
|
|
|
dtls1_release_current_message,
|
2015-05-30 21:22:10 +01:00
|
|
|
dtls1_read_app_data,
|
2015-11-26 07:16:49 +00:00
|
|
|
dtls1_read_change_cipher_spec,
|
2015-05-30 21:22:10 +01:00
|
|
|
dtls1_read_close_notify,
|
2015-05-30 21:14:58 +01:00
|
|
|
dtls1_write_app_data,
|
2015-03-05 06:56:32 +00:00
|
|
|
dtls1_dispatch_alert,
|
2015-05-30 22:03:14 +01:00
|
|
|
dtls1_supports_cipher,
|
2016-06-17 23:48:29 +01:00
|
|
|
dtls1_init_message,
|
|
|
|
dtls1_finish_message,
|
Don't use the buffer BIO in TLS.
On the TLS side, we introduce a running buffer of ciphertext. Queuing up
pending data consists of encrypting the record into the buffer. This
effectively reimplements what the buffer BIO was doing previously, but
this resizes to fit the whole flight.
As part of this, rename all the functions to add to the pending flight
to be more uniform. This CL proposes "add_foo" to add to the pending
flight and "flush_flight" to drain it.
We add an add_alert hook for alerts but, for now, only the SSL 3.0
warning alert (sent mid-handshake) uses this mechanism. Later work will
push this down to the rest of the write path so closure alerts use it
too, as in DTLS. The intended end state is that all the ssl_buffer.c and
wpend_ret logic will only be used for application data and eventually
optionally replaced by the in-place API, while all "incidental" data
will be handled internally.
For now, the two buffers are mutually exclusive. Moving closure alerts
to "incidentals" will change this, but flushing application data early
is tricky due to wpend_ret. (If we call ssl_write_buffer_flush,
do_ssl3_write doesn't realize it still has a wpend_ret to replay.) That
too is all left alone in this change.
To keep the diff down, write_message is retained for now and will be
removed from the state machines in a follow-up change.
BUG=72
Change-Id: Ibce882f5f7196880648f25d5005322ca4055c71d
Reviewed-on: https://boringssl-review.googlesource.com/13224
Reviewed-by: Adam Langley <agl@google.com>
2017-01-03 23:37:41 +00:00
|
|
|
dtls1_add_message,
|
|
|
|
dtls1_add_change_cipher_spec,
|
|
|
|
dtls1_add_alert,
|
2017-01-01 22:41:30 +00:00
|
|
|
dtls1_flush_flight,
|
2017-08-03 00:46:29 +01:00
|
|
|
dtls1_on_handshake_complete,
|
2016-07-15 04:10:43 +01:00
|
|
|
dtls1_set_read_state,
|
|
|
|
dtls1_set_write_state,
|
2014-12-12 20:55:27 +00:00
|
|
|
};
|
2014-06-20 20:00:00 +01:00
|
|
|
|
2014-12-12 20:55:27 +00:00
|
|
|
const SSL_METHOD *DTLS_method(void) {
|
2016-07-08 17:05:45 +01:00
|
|
|
static const SSL_METHOD kMethod = {
|
2014-12-12 20:55:27 +00:00
|
|
|
0,
|
2016-07-08 17:05:45 +01:00
|
|
|
&kDTLSProtocolMethod,
|
2017-02-01 19:59:18 +00:00
|
|
|
&ssl_crypto_x509_method,
|
2014-12-12 20:55:27 +00:00
|
|
|
};
|
2016-07-08 17:05:45 +01:00
|
|
|
return &kMethod;
|
2014-12-12 20:55:27 +00:00
|
|
|
}
|
2014-06-20 20:00:00 +01:00
|
|
|
|
2017-08-04 18:59:24 +01:00
|
|
|
const SSL_METHOD *DTLS_with_buffers_method(void) {
|
|
|
|
static const SSL_METHOD kMethod = {
|
|
|
|
0,
|
|
|
|
&kDTLSProtocolMethod,
|
|
|
|
&ssl_noop_x509_method,
|
|
|
|
};
|
|
|
|
return &kMethod;
|
|
|
|
}
|
|
|
|
|
2014-12-12 20:55:27 +00:00
|
|
|
/* Legacy version-locked methods. */
|
2014-11-23 20:47:20 +00:00
|
|
|
|
2014-12-12 20:55:27 +00:00
|
|
|
const SSL_METHOD *DTLSv1_2_method(void) {
|
2016-07-08 17:05:45 +01:00
|
|
|
static const SSL_METHOD kMethod = {
|
2014-12-12 20:55:27 +00:00
|
|
|
DTLS1_2_VERSION,
|
2016-07-08 17:05:45 +01:00
|
|
|
&kDTLSProtocolMethod,
|
2017-02-01 19:59:18 +00:00
|
|
|
&ssl_crypto_x509_method,
|
2014-12-12 20:55:27 +00:00
|
|
|
};
|
2016-07-08 17:05:45 +01:00
|
|
|
return &kMethod;
|
2014-12-12 20:55:27 +00:00
|
|
|
}
|
2014-11-23 20:47:20 +00:00
|
|
|
|
2014-12-12 20:55:27 +00:00
|
|
|
const SSL_METHOD *DTLSv1_method(void) {
|
2016-07-08 17:05:45 +01:00
|
|
|
static const SSL_METHOD kMethod = {
|
2014-12-12 20:55:27 +00:00
|
|
|
DTLS1_VERSION,
|
2016-07-08 17:05:45 +01:00
|
|
|
&kDTLSProtocolMethod,
|
2017-02-01 19:59:18 +00:00
|
|
|
&ssl_crypto_x509_method,
|
2014-12-12 20:55:27 +00:00
|
|
|
};
|
2016-07-08 17:05:45 +01:00
|
|
|
return &kMethod;
|
2014-12-12 20:55:27 +00:00
|
|
|
}
|
2014-11-23 20:47:20 +00:00
|
|
|
|
2014-12-12 20:55:27 +00:00
|
|
|
/* Legacy side-specific methods. */
|
2014-11-23 20:47:20 +00:00
|
|
|
|
2014-12-12 20:55:27 +00:00
|
|
|
const SSL_METHOD *DTLSv1_2_server_method(void) {
|
|
|
|
return DTLSv1_2_method();
|
|
|
|
}
|
2014-11-23 20:47:20 +00:00
|
|
|
|
2014-12-12 20:55:27 +00:00
|
|
|
const SSL_METHOD *DTLSv1_server_method(void) {
|
|
|
|
return DTLSv1_method();
|
|
|
|
}
|
2014-11-23 20:47:20 +00:00
|
|
|
|
2014-12-12 20:55:27 +00:00
|
|
|
const SSL_METHOD *DTLSv1_2_client_method(void) {
|
|
|
|
return DTLSv1_2_method();
|
|
|
|
}
|
|
|
|
|
|
|
|
const SSL_METHOD *DTLSv1_client_method(void) {
|
|
|
|
return DTLSv1_method();
|
|
|
|
}
|
|
|
|
|
|
|
|
const SSL_METHOD *DTLS_server_method(void) {
|
|
|
|
return DTLS_method();
|
|
|
|
}
|
|
|
|
|
|
|
|
const SSL_METHOD *DTLS_client_method(void) {
|
|
|
|
return DTLS_method();
|
|
|
|
}
|