Branch data     Line data    Source code

       1                 :            : /*
       2                 :            :  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
       3                 :            :  *
       4                 :            :  * Licensed under the Apache License, Version 2.0 (the "License").
       5                 :            :  * You may not use this file except in compliance with the License.
       6                 :            :  * A copy of the License is located at
       7                 :            :  *
       8                 :            :  *  http://aws.amazon.com/apache2.0
       9                 :            :  *
      10                 :            :  * or in the "license" file accompanying this file. This file is distributed
      11                 :            :  * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
      12                 :            :  * express or implied. See the License for the specific language governing
      13                 :            :  * permissions and limitations under the License.
      14                 :            :  */
      15                 :            : 
      16                 :            : #include <stdint.h>
      17                 :            : #include <sys/param.h>
      18                 :            : 
      19                 :            : #include "tls/extensions/s2n_ems.h"
      20                 :            : #include "tls/s2n_tls.h"
      21                 :            : #include "utils/s2n_safety.h"
      22                 :            : 
      23                 :            : static int s2n_server_ems_recv(struct s2n_connection *conn, struct s2n_stuffer *extension);
      24                 :            : static bool s2n_server_ems_should_send(struct s2n_connection *conn);
      25                 :            : static int s2n_server_ems_if_missing(struct s2n_connection *conn);
      26                 :            : 
      27                 :            : /**
      28                 :            :  *= https://www.rfc-editor.org/rfc/rfc7627#section-5.1
      29                 :            :  *#
      30                 :            :  *#   This document defines a new TLS extension, "extended_master_secret"
      31                 :            :  *#   (with extension type 0x0017), which is used to signal both client and
      32                 :            :  *#   server to use the extended master secret computation.  The
      33                 :            :  *#   "extension_data" field of this extension is empty.  Thus, the entire
      34                 :            :  *#   encoding of the extension is 00 17 00 00 (in hexadecimal.)
      35                 :            :  **/
      36                 :            : const s2n_extension_type s2n_server_ems_extension = {
      37                 :            :     .iana_value = TLS_EXTENSION_EMS,
      38                 :            :     .is_response = true,
      39                 :            :     .send = s2n_extension_send_noop,
      40                 :            :     .recv = s2n_server_ems_recv,
      41                 :            :     .should_send = s2n_server_ems_should_send,
      42                 :            :     .if_missing = s2n_server_ems_if_missing,
      43                 :            : };
      44                 :            : 
      45                 :            : static int s2n_server_ems_recv(struct s2n_connection *conn, struct s2n_stuffer *extension)
      46                 :       2262 : {
      47 [ -  + ][ #  # ]:       2262 :     POSIX_ENSURE_REF(conn);
      48                 :            : 
      49                 :            :     /* Read nothing. The extension just needs to exist without any data. */
      50 [ -  + ][ #  # ]:       2262 :     POSIX_ENSURE(s2n_stuffer_data_available(extension) == 0, S2N_ERR_UNSUPPORTED_EXTENSION);
      51                 :       2262 :     conn->ems_negotiated = true;
      52                 :            : 
      53                 :       2262 :     return S2N_SUCCESS;
      54                 :       2262 : }
      55                 :            : 
      56                 :            : static bool s2n_server_ems_should_send(struct s2n_connection *conn)
      57                 :       2322 : {
      58 [ +  - ][ +  + ]:       2322 :     return conn && conn->actual_protocol_version < S2N_TLS13;
      59                 :       2322 : }
      60                 :            : 
      61                 :            : static int s2n_server_ems_if_missing(struct s2n_connection *conn)
      62                 :         10 : {
      63 [ -  + ][ #  # ]:         10 :     POSIX_ENSURE_REF(conn);
      64                 :            : 
      65                 :            :     /**
      66                 :            :      *= https://www.rfc-editor.org/rfc/rfc7627#section-5.3
      67                 :            :      *#    If the original session used the extension but the new ServerHello
      68                 :            :      *#    does not contain the extension, the client MUST abort the
      69                 :            :      *#    handshake.
      70                 :            :      **/
      71 [ +  + ][ +  - ]:         10 :     POSIX_ENSURE(!conn->ems_negotiated, S2N_ERR_MISSING_EXTENSION);
      72                 :            : 
      73                 :          9 :     return S2N_SUCCESS;
      74                 :         10 : }