aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/restricted/aws/s2n/tls/s2n_key_update.c
blob: 02e5cf9978a5aae288677ee69dc8e3866b2d11a6 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
/* 
 * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. 
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"). 
 * You may not use this file except in compliance with the License. 
 * A copy of the License is located at 
 * 
 *  http://aws.amazon.com/apache2.0 
 * 
 * or in the "license" file accompanying this file. This file is distributed 
 * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either 
 * express or implied. See the License for the specific language governing 
 * permissions and limitations under the License. 
 */ 
 
#include "error/s2n_errno.h" 
 
#include "tls/s2n_connection.h" 
#include "tls/s2n_key_update.h" 
#include "tls/s2n_tls13_handshake.h" 
#include "tls/s2n_record.h" 
 
#include "crypto/s2n_sequence.h" 
 
#include "utils/s2n_safety.h" 
 
int s2n_key_update_write(struct s2n_blob *out); 
int s2n_check_record_limit(struct s2n_connection *conn, struct s2n_blob *sequence_number);  
 
 
int s2n_key_update_recv(struct s2n_connection *conn, struct s2n_stuffer *request) 
{ 
    notnull_check(conn); 
    ENSURE_POSIX(!conn->config->quic_enabled, S2N_ERR_BAD_MESSAGE); 
 
    uint8_t key_update_request; 
    GUARD(s2n_stuffer_read_uint8(request, &key_update_request)); 
    S2N_ERROR_IF(key_update_request != S2N_KEY_UPDATE_NOT_REQUESTED && key_update_request != S2N_KEY_UPDATE_REQUESTED, 
            S2N_ERR_BAD_MESSAGE); 
    conn->key_update_pending = key_update_request; 
 
    /* Update peer's key since a key_update was received */ 
    if (conn->mode == S2N_CLIENT){ 
        GUARD(s2n_update_application_traffic_keys(conn, S2N_SERVER, RECEIVING)); 
    } else { 
        GUARD(s2n_update_application_traffic_keys(conn, S2N_CLIENT, RECEIVING)); 
    } 
 
    return S2N_SUCCESS; 
} 
 
int s2n_key_update_send(struct s2n_connection *conn)  
{ 
    notnull_check(conn); 
 
    struct s2n_blob sequence_number = {0}; 
    if (conn->mode == S2N_CLIENT) { 
        GUARD(s2n_blob_init(&sequence_number, conn->secure.client_sequence_number, S2N_TLS_SEQUENCE_NUM_LEN)); 
    } else { 
        GUARD(s2n_blob_init(&sequence_number, conn->secure.server_sequence_number, S2N_TLS_SEQUENCE_NUM_LEN)); 
    } 
 
    GUARD(s2n_check_record_limit(conn, &sequence_number)); 
 
    if (conn->key_update_pending) { 
        uint8_t key_update_data[S2N_KEY_UPDATE_MESSAGE_SIZE]; 
        struct s2n_blob key_update_blob = {0}; 
        GUARD(s2n_blob_init(&key_update_blob, key_update_data, sizeof(key_update_data))); 
 
        /* Write key update message */ 
        GUARD(s2n_key_update_write(&key_update_blob)); 
 
        /* Encrypt the message */ 
        GUARD(s2n_record_write(conn, TLS_HANDSHAKE,  &key_update_blob)); 
 
        /* Update encryption key */ 
        GUARD(s2n_update_application_traffic_keys(conn, conn->mode, SENDING)); 
        conn->key_update_pending = false; 
    } 
 
    return S2N_SUCCESS; 
} 
 
int s2n_key_update_write(struct s2n_blob *out) 
{ 
    notnull_check(out); 
 
    struct s2n_stuffer key_update_stuffer = {0}; 
    GUARD(s2n_stuffer_init(&key_update_stuffer, out)); 
    GUARD(s2n_stuffer_write_uint8(&key_update_stuffer, TLS_KEY_UPDATE)); 
    GUARD(s2n_stuffer_write_uint24(&key_update_stuffer, S2N_KEY_UPDATE_LENGTH)); 
 
    /* s2n currently does not require peers to update their encryption keys. */ 
    GUARD(s2n_stuffer_write_uint8(&key_update_stuffer, S2N_KEY_UPDATE_NOT_REQUESTED)); 
 
    return S2N_SUCCESS; 
} 
 
int s2n_check_record_limit(struct s2n_connection *conn, struct s2n_blob *sequence_number) 
{ 
    notnull_check(conn); 
    notnull_check(sequence_number); 
    notnull_check(conn->secure.cipher_suite); 
    notnull_check(conn->secure.cipher_suite->record_alg); 
 
    uint64_t output = 0; 
    GUARD(s2n_sequence_number_to_uint64(sequence_number, &output)); 
 
    if (output + 1 > conn->secure.cipher_suite->record_alg->encryption_limit) { 
        conn->key_update_pending = true; 
    } 
 
    return S2N_SUCCESS; 
}