1 /* $OpenBSD: tls.h,v 1.38 2016/09/13 13:40:58 tedu Exp $ */ 2 /* 3 * Copyright (c) 2014 Joel Sing <jsing@openbsd.org> 4 * 5 * Permission to use, copy, modify, and distribute this software for any 6 * purpose with or without fee is hereby granted, provided that the above 7 * copyright notice and this permission notice appear in all copies. 8 * 9 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16 */ 17 18 #ifndef HEADER_TLS_H 19 #define HEADER_TLS_H 20 21 #ifdef __cplusplus 22 extern "C" { 23 #endif 24 25 #include <sys/types.h> 26 27 #include <stddef.h> 28 #include <stdint.h> 29 30 #define TLS_API 20160904 31 32 #define TLS_PROTOCOL_TLSv1_0 (1 << 1) 33 #define TLS_PROTOCOL_TLSv1_1 (1 << 2) 34 #define TLS_PROTOCOL_TLSv1_2 (1 << 3) 35 #define TLS_PROTOCOL_TLSv1 \ 36 (TLS_PROTOCOL_TLSv1_0|TLS_PROTOCOL_TLSv1_1|TLS_PROTOCOL_TLSv1_2) 37 38 #define TLS_PROTOCOLS_ALL TLS_PROTOCOL_TLSv1 39 #define TLS_PROTOCOLS_DEFAULT TLS_PROTOCOL_TLSv1_2 40 41 #define TLS_WANT_POLLIN -2 42 #define TLS_WANT_POLLOUT -3 43 44 struct tls; 45 struct tls_config; 46 47 typedef ssize_t (*tls_read_cb)(struct tls *_ctx, void *_buf, size_t _buflen, 48 void *_cb_arg); 49 typedef ssize_t (*tls_write_cb)(struct tls *_ctx, const void *_buf, 50 size_t _buflen, void *_cb_arg); 51 52 int tls_init(void); 53 54 const char *tls_config_error(struct tls_config *_config); 55 const char *tls_error(struct tls *_ctx); 56 57 struct tls_config *tls_config_new(void); 58 void tls_config_free(struct tls_config *_config); 59 60 int tls_config_add_keypair_file(struct tls_config *_config, 61 const char *_cert_file, const char *_key_file); 62 int tls_config_add_keypair_mem(struct tls_config *_config, const uint8_t *_cert, 63 size_t _cert_len, const uint8_t *_key, size_t _key_len); 64 65 int tls_config_set_alpn(struct tls_config *_config, const char *_alpn); 66 int tls_config_set_ca_file(struct tls_config *_config, const char *_ca_file); 67 int tls_config_set_ca_path(struct tls_config *_config, const char *_ca_path); 68 int tls_config_set_ca_mem(struct tls_config *_config, const uint8_t *_ca, 69 size_t _len); 70 int tls_config_set_cert_file(struct tls_config *_config, 71 const char *_cert_file); 72 int tls_config_set_cert_mem(struct tls_config *_config, const uint8_t *_cert, 73 size_t _len); 74 int tls_config_set_ciphers(struct tls_config *_config, const char *_ciphers); 75 int tls_config_set_dheparams(struct tls_config *_config, const char *_params); 76 int tls_config_set_ecdhecurve(struct tls_config *_config, const char *_name); 77 int tls_config_set_key_file(struct tls_config *_config, const char *_key_file); 78 int tls_config_set_key_mem(struct tls_config *_config, const uint8_t *_key, 79 size_t _len); 80 int tls_config_set_keypair_file(struct tls_config *_config, 81 const char *_cert_file, const char *_key_file); 82 int tls_config_set_keypair_mem(struct tls_config *_config, const uint8_t *_cert, 83 size_t _cert_len, const uint8_t *_key, size_t _key_len); 84 void tls_config_set_protocols(struct tls_config *_config, uint32_t _protocols); 85 void tls_config_set_verify_depth(struct tls_config *_config, int _verify_depth); 86 87 void tls_config_prefer_ciphers_client(struct tls_config *_config); 88 void tls_config_prefer_ciphers_server(struct tls_config *_config); 89 90 void tls_config_insecure_noverifycert(struct tls_config *_config); 91 void tls_config_insecure_noverifyname(struct tls_config *_config); 92 void tls_config_insecure_noverifytime(struct tls_config *_config); 93 void tls_config_verify(struct tls_config *_config); 94 95 void tls_config_verify_client(struct tls_config *_config); 96 void tls_config_verify_client_optional(struct tls_config *_config); 97 98 void tls_config_clear_keys(struct tls_config *_config); 99 int tls_config_parse_protocols(uint32_t *_protocols, const char *_protostr); 100 101 struct tls *tls_client(void); 102 struct tls *tls_server(void); 103 int tls_configure(struct tls *_ctx, struct tls_config *_config); 104 void tls_reset(struct tls *_ctx); 105 void tls_free(struct tls *_ctx); 106 107 int tls_accept_fds(struct tls *_ctx, struct tls **_cctx, int _fd_read, 108 int _fd_write); 109 int tls_accept_socket(struct tls *_ctx, struct tls **_cctx, int _socket); 110 int tls_accept_cbs(struct tls *_ctx, struct tls **_cctx, 111 tls_read_cb _read_cb, tls_write_cb _write_cb, void *_cb_arg); 112 int tls_connect(struct tls *_ctx, const char *_host, const char *_port); 113 int tls_connect_fds(struct tls *_ctx, int _fd_read, int _fd_write, 114 const char *_servername); 115 int tls_connect_servername(struct tls *_ctx, const char *_host, 116 const char *_port, const char *_servername); 117 int tls_connect_socket(struct tls *_ctx, int _s, const char *_servername); 118 int tls_connect_cbs(struct tls *_ctx, tls_read_cb _read_cb, 119 tls_write_cb _write_cb, void *_cb_arg, const char *_servername); 120 int tls_handshake(struct tls *_ctx); 121 ssize_t tls_read(struct tls *_ctx, void *_buf, size_t _buflen); 122 ssize_t tls_write(struct tls *_ctx, const void *_buf, size_t _buflen); 123 int tls_close(struct tls *_ctx); 124 125 int tls_peer_cert_provided(struct tls *_ctx); 126 int tls_peer_cert_contains_name(struct tls *_ctx, const char *_name); 127 128 const char *tls_peer_cert_hash(struct tls *_ctx); 129 const char *tls_peer_cert_issuer(struct tls *_ctx); 130 const char *tls_peer_cert_subject(struct tls *_ctx); 131 time_t tls_peer_cert_notbefore(struct tls *_ctx); 132 time_t tls_peer_cert_notafter(struct tls *_ctx); 133 134 const char *tls_conn_alpn_selected(struct tls *_ctx); 135 const char *tls_conn_cipher(struct tls *_ctx); 136 const char *tls_conn_servername(struct tls *_ctx); 137 const char *tls_conn_version(struct tls *_ctx); 138 139 uint8_t *tls_load_file(const char *_file, size_t *_len, char *_password); 140 141 #ifdef __cplusplus 142 } 143 #endif 144 145 #endif /* HEADER_TLS_H */ 146