blob: 9155b6d344841425fef0ba781e7475968f8972e8 [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 */
William Lallemandcfca1422020-03-05 10:17:47 +010045 struct ckch_inst *ckch_inst; /* instance used to create this sni_ctx */
Emeric Brunfc0421f2012-09-07 17:30:07 +020046 struct ebmb_node name; /* node holding the servername value */
47};
48
Emmanuel Hocdet5db33cb2017-03-30 19:19:37 +020049struct tls_version_filter {
50 uint16_t flags; /* ssl options */
51 uint8_t min; /* min TLS version */
52 uint8_t max; /* max TLS version */
53};
54
Nenad Merdanovic200b0fa2015-05-09 08:46:01 +020055extern struct list tlskeys_reference;
56
Emeric Brun9e754772019-01-10 17:51:55 +010057struct tls_sess_key_128 {
Nenad Merdanovic05552d42015-02-27 19:56:49 +010058 unsigned char name[16];
59 unsigned char aes_key[16];
60 unsigned char hmac_key[16];
61} __attribute__((packed));
62
Emeric Brun9e754772019-01-10 17:51:55 +010063struct tls_sess_key_256 {
64 unsigned char name[16];
65 unsigned char aes_key[32];
66 unsigned char hmac_key[32];
67} __attribute__((packed));
68
69union tls_sess_key{
70 unsigned char name[16];
Nenad Merdanovic8ef70652019-04-14 16:06:46 +020071 struct tls_sess_key_128 key_128;
Emeric Brun9e754772019-01-10 17:51:55 +010072 struct tls_sess_key_256 key_256;
73} __attribute__((packed));
74
Nenad Merdanovic146defa2015-05-09 08:46:00 +020075struct tls_keys_ref {
76 struct list list; /* Used to chain refs. */
77 char *filename;
78 int unique_id; /* Each pattern reference have unique id. */
Willy Tarreau17b4aa12018-07-17 10:05:32 +020079 int refcount; /* number of users of this tls_keys_ref. */
Emeric Brun9e754772019-01-10 17:51:55 +010080 union tls_sess_key *tlskeys;
Nenad Merdanovic146defa2015-05-09 08:46:00 +020081 int tls_ticket_enc_index;
Emeric Brun9e754772019-01-10 17:51:55 +010082 int key_size_bits;
Christopher Faulet16f45c82018-02-16 11:23:49 +010083 __decl_hathreads(HA_RWLOCK_T lock); /* lock used to protect the ref */
Nenad Merdanovic146defa2015-05-09 08:46:00 +020084};
85
William Lallemand4f45bb92017-10-30 20:08:51 +010086/* shared ssl session */
87struct sh_ssl_sess_hdr {
88 struct ebmb_node key;
89 unsigned char key_data[SSL_MAX_SSL_SESSION_ID_LENGTH];
90};
91
William Lallemandf6adbe92019-09-11 16:33:52 +020092/* This is used to preload the certifcate, private key
93 * and Cert Chain of a file passed in via the crt
94 * argument
95 *
96 * This way, we do not have to read the file multiple times
97 */
98struct cert_key_and_chain {
99 X509 *cert;
100 EVP_PKEY *key;
101 STACK_OF(X509) *chain;
102 DH *dh;
William Lallemanda17f4112019-10-10 15:16:44 +0200103 struct buffer *sctl;
William Lallemand246c0242019-10-11 08:59:13 +0200104 struct buffer *ocsp_response;
105 X509 *ocsp_issuer;
William Lallemandf6adbe92019-09-11 16:33:52 +0200106};
107
108/*
109 * this is used to store 1 to SSL_SOCK_NUM_KEYTYPES cert_key_and_chain and
110 * metadata.
111 */
112struct ckch_store {
113 struct cert_key_and_chain *ckch;
Tim Duesterhus6a0dd732020-01-18 01:32:49 +0100114 unsigned int multi:1; /* is it a multi-cert bundle ? */
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 Lallemandcfca1422020-03-05 10:17:47 +0100130 struct ckch_store *ckch_store; /* pointer to the store used to generate this inst */
William Lallemand21724f02019-11-04 17:56:13 +0100131 int is_default; /* This instance is used as the default ctx for this bind_conf */
William Lallemand9117de92019-10-04 00:29:42 +0200132 struct list sni_ctx; /* list of sni_ctx using this ckch_inst */
133 struct list by_ckchs; /* chained in ckch_store's list of ckch_inst */
134};
William Lallemandf6adbe92019-09-11 16:33:52 +0200135
136#if HA_OPENSSL_VERSION_NUMBER >= 0x1000200fL
137
138#define SSL_SOCK_POSSIBLE_KT_COMBOS (1<<(SSL_SOCK_NUM_KEYTYPES))
139
140struct key_combo_ctx {
141 SSL_CTX *ctx;
142 int order;
143};
144
145/* Map used for processing multiple keypairs for a single purpose
146 *
147 * This maps CN/SNI name to certificate type
148 */
149struct sni_keytype {
150 int keytypes; /* BITMASK for keytypes */
151 struct ebmb_node name; /* node holding the servername value */
152};
153
154#endif
155
William Lallemande0f3fd52020-02-25 14:53:06 +0100156/* issuer chain store with hash of Subject Key Identifier
157 certificate/issuer matching is verify with X509_check_issued
158*/
159struct issuer_chain {
160 struct eb64_node node;
161 STACK_OF(X509) *chain;
162 char *path;
163};
164
165
Willy Tarreauc125cef2019-05-10 09:58:43 +0200166#endif /* USE_OPENSSL */
Emeric Brunfc0421f2012-09-07 17:30:07 +0200167#endif /* _TYPES_SSL_SOCK_H */