blob: feca100046a05f09134de86eacdb688be75841cf [file] [log] [blame]
Emeric Brunfc0421f2012-09-07 17:30:07 +02001/*
2 * include/types/ssl_sock.h
3 * SSL settings for listeners and servers
4 *
5 * Copyright (C) 2012 EXCELIANCE, Emeric Brun <ebrun@exceliance.fr>
6 *
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation, version 2.1
10 * exclusively.
11 *
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20 */
21
22#ifndef _TYPES_SSL_SOCK_H
23#define _TYPES_SSL_SOCK_H
Willy Tarreauc125cef2019-05-10 09:58:43 +020024#ifdef USE_OPENSSL
Emeric Brunfc0421f2012-09-07 17:30:07 +020025
Emeric Brunfc0421f2012-09-07 17:30:07 +020026#include <ebmbtree.h>
William Lallemande0f3fd52020-02-25 14:53:06 +010027#include <eb64tree.h>
Emeric Brunfc0421f2012-09-07 17:30:07 +020028
Christopher Faulet16f45c82018-02-16 11:23:49 +010029#include <common/hathreads.h>
Willy Tarreau55994562019-05-09 14:52:44 +020030#include <common/openssl-compat.h>
Christopher Faulet16f45c82018-02-16 11:23:49 +010031
Emmanuel Hocdetddc090b2017-10-27 18:43:29 +020032struct pkey_info {
33 uint8_t sig; /* TLSEXT_signature_[rsa,ecdsa,...] */
34 uint16_t bits; /* key size in bits */
35};
36
Emeric Brunfc0421f2012-09-07 17:30:07 +020037struct sni_ctx {
38 SSL_CTX *ctx; /* context associated to the certificate */
39 int order; /* load order for the certificate */
Tim Duesterhus6a0dd732020-01-18 01:32:49 +010040 unsigned int neg:1; /* reject if match */
41 unsigned int wild:1; /* wildcard sni */
Emmanuel Hocdetddc090b2017-10-27 18:43:29 +020042 struct pkey_info kinfo; /* pkey info */
Emmanuel Hocdet98263292016-12-29 18:26:15 +010043 struct ssl_bind_conf *conf; /* ssl "bind" conf for the certificate */
William Lallemand9117de92019-10-04 00:29:42 +020044 struct list by_ckch_inst; /* chained in ckch_inst's list of sni_ctx */
Emeric Brunfc0421f2012-09-07 17:30:07 +020045 struct ebmb_node name; /* node holding the servername value */
46};
47
Emmanuel Hocdet5db33cb2017-03-30 19:19:37 +020048struct tls_version_filter {
49 uint16_t flags; /* ssl options */
50 uint8_t min; /* min TLS version */
51 uint8_t max; /* max TLS version */
52};
53
Nenad Merdanovic200b0fa2015-05-09 08:46:01 +020054extern struct list tlskeys_reference;
55
Emeric Brun9e754772019-01-10 17:51:55 +010056struct tls_sess_key_128 {
Nenad Merdanovic05552d42015-02-27 19:56:49 +010057 unsigned char name[16];
58 unsigned char aes_key[16];
59 unsigned char hmac_key[16];
60} __attribute__((packed));
61
Emeric Brun9e754772019-01-10 17:51:55 +010062struct tls_sess_key_256 {
63 unsigned char name[16];
64 unsigned char aes_key[32];
65 unsigned char hmac_key[32];
66} __attribute__((packed));
67
68union tls_sess_key{
69 unsigned char name[16];
Nenad Merdanovic8ef70652019-04-14 16:06:46 +020070 struct tls_sess_key_128 key_128;
Emeric Brun9e754772019-01-10 17:51:55 +010071 struct tls_sess_key_256 key_256;
72} __attribute__((packed));
73
Nenad Merdanovic146defa2015-05-09 08:46:00 +020074struct tls_keys_ref {
75 struct list list; /* Used to chain refs. */
76 char *filename;
77 int unique_id; /* Each pattern reference have unique id. */
Willy Tarreau17b4aa12018-07-17 10:05:32 +020078 int refcount; /* number of users of this tls_keys_ref. */
Emeric Brun9e754772019-01-10 17:51:55 +010079 union tls_sess_key *tlskeys;
Nenad Merdanovic146defa2015-05-09 08:46:00 +020080 int tls_ticket_enc_index;
Emeric Brun9e754772019-01-10 17:51:55 +010081 int key_size_bits;
Christopher Faulet16f45c82018-02-16 11:23:49 +010082 __decl_hathreads(HA_RWLOCK_T lock); /* lock used to protect the ref */
Nenad Merdanovic146defa2015-05-09 08:46:00 +020083};
84
William Lallemand4f45bb92017-10-30 20:08:51 +010085/* shared ssl session */
86struct sh_ssl_sess_hdr {
87 struct ebmb_node key;
88 unsigned char key_data[SSL_MAX_SSL_SESSION_ID_LENGTH];
89};
90
William Lallemandf6adbe92019-09-11 16:33:52 +020091/* This is used to preload the certifcate, private key
92 * and Cert Chain of a file passed in via the crt
93 * argument
94 *
95 * This way, we do not have to read the file multiple times
96 */
97struct cert_key_and_chain {
98 X509 *cert;
99 EVP_PKEY *key;
100 STACK_OF(X509) *chain;
101 DH *dh;
William Lallemanda17f4112019-10-10 15:16:44 +0200102 struct buffer *sctl;
William Lallemand246c0242019-10-11 08:59:13 +0200103 struct buffer *ocsp_response;
104 X509 *ocsp_issuer;
William Lallemandf6adbe92019-09-11 16:33:52 +0200105};
106
107/*
108 * this is used to store 1 to SSL_SOCK_NUM_KEYTYPES cert_key_and_chain and
109 * metadata.
110 */
111struct ckch_store {
112 struct cert_key_and_chain *ckch;
Tim Duesterhus6a0dd732020-01-18 01:32:49 +0100113 unsigned int multi:1; /* is it a multi-cert bundle ? */
114 unsigned int filters:1;/* one of the instances is using filters, TODO:remove this flag once filters are supported */
William Lallemand9117de92019-10-04 00:29:42 +0200115 struct list ckch_inst; /* list of ckch_inst which uses this ckch_node */
William Lallemandf6adbe92019-09-11 16:33:52 +0200116 struct ebmb_node node;
117 char path[0];
118};
119
William Lallemand9117de92019-10-04 00:29:42 +0200120/*
121 * This structure describe a ckch instance. An instance is generated for each
122 * bind_conf. The instance contains a linked list of the sni ctx which uses
123 * the ckch in this bind_conf.
124 *
125 * XXX: the instance may evolve to handle ssl_bind_conf instead of bind_conf.
126 */
127struct ckch_inst {
128 struct bind_conf *bind_conf; /* pointer to the bind_conf that uses this ckch_inst */
William Lallemand150bfa82019-09-19 17:12:49 +0200129 struct ssl_bind_conf *ssl_conf; /* pointer to the ssl_conf which is used by every sni_ctx of this inst */
William Lallemand21724f02019-11-04 17:56:13 +0100130 int is_default; /* This instance is used as the default ctx for this bind_conf */
William Lallemand9117de92019-10-04 00:29:42 +0200131 struct list sni_ctx; /* list of sni_ctx using this ckch_inst */
132 struct list by_ckchs; /* chained in ckch_store's list of ckch_inst */
133};
William Lallemandf6adbe92019-09-11 16:33:52 +0200134
135#if HA_OPENSSL_VERSION_NUMBER >= 0x1000200fL
136
137#define SSL_SOCK_POSSIBLE_KT_COMBOS (1<<(SSL_SOCK_NUM_KEYTYPES))
138
139struct key_combo_ctx {
140 SSL_CTX *ctx;
141 int order;
142};
143
144/* Map used for processing multiple keypairs for a single purpose
145 *
146 * This maps CN/SNI name to certificate type
147 */
148struct sni_keytype {
149 int keytypes; /* BITMASK for keytypes */
150 struct ebmb_node name; /* node holding the servername value */
151};
152
153#endif
154
William Lallemande0f3fd52020-02-25 14:53:06 +0100155/* issuer chain store with hash of Subject Key Identifier
156 certificate/issuer matching is verify with X509_check_issued
157*/
158struct issuer_chain {
159 struct eb64_node node;
160 STACK_OF(X509) *chain;
161 char *path;
162};
163
164
Willy Tarreauc125cef2019-05-10 09:58:43 +0200165#endif /* USE_OPENSSL */
Emeric Brunfc0421f2012-09-07 17:30:07 +0200166#endif /* _TYPES_SSL_SOCK_H */