1*de0e0e4dSAntonio Huete Jimenez /* $OpenBSD: tls_internal.h,v 1.9 2022/07/24 14:28:16 jsing Exp $ */ 2*de0e0e4dSAntonio Huete Jimenez /* 3*de0e0e4dSAntonio Huete Jimenez * Copyright (c) 2018, 2019, 2021 Joel Sing <jsing@openbsd.org> 4*de0e0e4dSAntonio Huete Jimenez * 5*de0e0e4dSAntonio Huete Jimenez * Permission to use, copy, modify, and distribute this software for any 6*de0e0e4dSAntonio Huete Jimenez * purpose with or without fee is hereby granted, provided that the above 7*de0e0e4dSAntonio Huete Jimenez * copyright notice and this permission notice appear in all copies. 8*de0e0e4dSAntonio Huete Jimenez * 9*de0e0e4dSAntonio Huete Jimenez * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10*de0e0e4dSAntonio Huete Jimenez * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11*de0e0e4dSAntonio Huete Jimenez * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12*de0e0e4dSAntonio Huete Jimenez * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13*de0e0e4dSAntonio Huete Jimenez * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14*de0e0e4dSAntonio Huete Jimenez * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15*de0e0e4dSAntonio Huete Jimenez * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16*de0e0e4dSAntonio Huete Jimenez */ 17*de0e0e4dSAntonio Huete Jimenez 18*de0e0e4dSAntonio Huete Jimenez #ifndef HEADER_TLS_INTERNAL_H 19*de0e0e4dSAntonio Huete Jimenez #define HEADER_TLS_INTERNAL_H 20*de0e0e4dSAntonio Huete Jimenez 21*de0e0e4dSAntonio Huete Jimenez #include <openssl/dh.h> 22*de0e0e4dSAntonio Huete Jimenez #include <openssl/evp.h> 23*de0e0e4dSAntonio Huete Jimenez 24*de0e0e4dSAntonio Huete Jimenez #include "bytestring.h" 25*de0e0e4dSAntonio Huete Jimenez 26*de0e0e4dSAntonio Huete Jimenez __BEGIN_HIDDEN_DECLS 27*de0e0e4dSAntonio Huete Jimenez 28*de0e0e4dSAntonio Huete Jimenez #define TLS_IO_SUCCESS 1 29*de0e0e4dSAntonio Huete Jimenez #define TLS_IO_EOF 0 30*de0e0e4dSAntonio Huete Jimenez #define TLS_IO_FAILURE -1 31*de0e0e4dSAntonio Huete Jimenez #define TLS_IO_ALERT -2 32*de0e0e4dSAntonio Huete Jimenez #define TLS_IO_WANT_POLLIN -3 33*de0e0e4dSAntonio Huete Jimenez #define TLS_IO_WANT_POLLOUT -4 34*de0e0e4dSAntonio Huete Jimenez #define TLS_IO_WANT_RETRY -5 /* Retry the previous call immediately. */ 35*de0e0e4dSAntonio Huete Jimenez 36*de0e0e4dSAntonio Huete Jimenez enum ssl_encryption_level_t; 37*de0e0e4dSAntonio Huete Jimenez 38*de0e0e4dSAntonio Huete Jimenez struct tls13_secret; 39*de0e0e4dSAntonio Huete Jimenez 40*de0e0e4dSAntonio Huete Jimenez /* 41*de0e0e4dSAntonio Huete Jimenez * Callbacks. 42*de0e0e4dSAntonio Huete Jimenez */ 43*de0e0e4dSAntonio Huete Jimenez typedef ssize_t (*tls_read_cb)(void *_buf, size_t _buflen, void *_cb_arg); 44*de0e0e4dSAntonio Huete Jimenez typedef ssize_t (*tls_write_cb)(const void *_buf, size_t _buflen, 45*de0e0e4dSAntonio Huete Jimenez void *_cb_arg); 46*de0e0e4dSAntonio Huete Jimenez typedef ssize_t (*tls_flush_cb)(void *_cb_arg); 47*de0e0e4dSAntonio Huete Jimenez 48*de0e0e4dSAntonio Huete Jimenez typedef ssize_t (*tls_handshake_read_cb)(void *_buf, size_t _buflen, 49*de0e0e4dSAntonio Huete Jimenez void *_cb_arg); 50*de0e0e4dSAntonio Huete Jimenez typedef ssize_t (*tls_handshake_write_cb)(const void *_buf, size_t _buflen, 51*de0e0e4dSAntonio Huete Jimenez void *_cb_arg); 52*de0e0e4dSAntonio Huete Jimenez typedef int (*tls_traffic_key_cb)(struct tls13_secret *key, 53*de0e0e4dSAntonio Huete Jimenez enum ssl_encryption_level_t level, void *_cb_arg); 54*de0e0e4dSAntonio Huete Jimenez typedef int (*tls_alert_send_cb)(int _alert_desc, void *_cb_arg); 55*de0e0e4dSAntonio Huete Jimenez 56*de0e0e4dSAntonio Huete Jimenez /* 57*de0e0e4dSAntonio Huete Jimenez * Buffers. 58*de0e0e4dSAntonio Huete Jimenez */ 59*de0e0e4dSAntonio Huete Jimenez struct tls_buffer; 60*de0e0e4dSAntonio Huete Jimenez 61*de0e0e4dSAntonio Huete Jimenez struct tls_buffer *tls_buffer_new(size_t init_size); 62*de0e0e4dSAntonio Huete Jimenez void tls_buffer_clear(struct tls_buffer *buf); 63*de0e0e4dSAntonio Huete Jimenez void tls_buffer_free(struct tls_buffer *buf); 64*de0e0e4dSAntonio Huete Jimenez void tls_buffer_set_capacity_limit(struct tls_buffer *buf, size_t limit); 65*de0e0e4dSAntonio Huete Jimenez ssize_t tls_buffer_extend(struct tls_buffer *buf, size_t len, 66*de0e0e4dSAntonio Huete Jimenez tls_read_cb read_cb, void *cb_arg); 67*de0e0e4dSAntonio Huete Jimenez ssize_t tls_buffer_read(struct tls_buffer *buf, uint8_t *rbuf, size_t n); 68*de0e0e4dSAntonio Huete Jimenez ssize_t tls_buffer_write(struct tls_buffer *buf, const uint8_t *wbuf, size_t n); 69*de0e0e4dSAntonio Huete Jimenez int tls_buffer_append(struct tls_buffer *buf, const uint8_t *wbuf, size_t n); 70*de0e0e4dSAntonio Huete Jimenez int tls_buffer_data(struct tls_buffer *buf, CBS *cbs); 71*de0e0e4dSAntonio Huete Jimenez int tls_buffer_finish(struct tls_buffer *buf, uint8_t **out, size_t *out_len); 72*de0e0e4dSAntonio Huete Jimenez 73*de0e0e4dSAntonio Huete Jimenez /* 74*de0e0e4dSAntonio Huete Jimenez * Key shares. 75*de0e0e4dSAntonio Huete Jimenez */ 76*de0e0e4dSAntonio Huete Jimenez struct tls_key_share; 77*de0e0e4dSAntonio Huete Jimenez 78*de0e0e4dSAntonio Huete Jimenez struct tls_key_share *tls_key_share_new(uint16_t group_id); 79*de0e0e4dSAntonio Huete Jimenez struct tls_key_share *tls_key_share_new_nid(int nid); 80*de0e0e4dSAntonio Huete Jimenez void tls_key_share_free(struct tls_key_share *ks); 81*de0e0e4dSAntonio Huete Jimenez 82*de0e0e4dSAntonio Huete Jimenez uint16_t tls_key_share_group(struct tls_key_share *ks); 83*de0e0e4dSAntonio Huete Jimenez int tls_key_share_nid(struct tls_key_share *ks); 84*de0e0e4dSAntonio Huete Jimenez void tls_key_share_set_key_bits(struct tls_key_share *ks, size_t key_bits); 85*de0e0e4dSAntonio Huete Jimenez int tls_key_share_set_dh_params(struct tls_key_share *ks, DH *dh_params); 86*de0e0e4dSAntonio Huete Jimenez int tls_key_share_peer_pkey(struct tls_key_share *ks, EVP_PKEY *pkey); 87*de0e0e4dSAntonio Huete Jimenez int tls_key_share_generate(struct tls_key_share *ks); 88*de0e0e4dSAntonio Huete Jimenez int tls_key_share_params(struct tls_key_share *ks, CBB *cbb); 89*de0e0e4dSAntonio Huete Jimenez int tls_key_share_public(struct tls_key_share *ks, CBB *cbb); 90*de0e0e4dSAntonio Huete Jimenez int tls_key_share_peer_params(struct tls_key_share *ks, CBS *cbs, 91*de0e0e4dSAntonio Huete Jimenez int *decode_error, int *invalid_params); 92*de0e0e4dSAntonio Huete Jimenez int tls_key_share_peer_public(struct tls_key_share *ks, CBS *cbs, 93*de0e0e4dSAntonio Huete Jimenez int *decode_error, int *invalid_key); 94*de0e0e4dSAntonio Huete Jimenez int tls_key_share_derive(struct tls_key_share *ks, uint8_t **shared_key, 95*de0e0e4dSAntonio Huete Jimenez size_t *shared_key_len); 96*de0e0e4dSAntonio Huete Jimenez int tls_key_share_peer_security(const SSL *ssl, struct tls_key_share *ks); 97*de0e0e4dSAntonio Huete Jimenez 98*de0e0e4dSAntonio Huete Jimenez __END_HIDDEN_DECLS 99*de0e0e4dSAntonio Huete Jimenez 100*de0e0e4dSAntonio Huete Jimenez #endif 101