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