blob: c67085e1c26e9874a01deeb71a7dfe2c400666f8 [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 Tarreau8dd0d552020-03-06 18:43:08 +010030#include <common/mini-clist.h>
Willy Tarreau55994562019-05-09 14:52:44 +020031#include <common/openssl-compat.h>
Christopher Faulet16f45c82018-02-16 11:23:49 +010032
Emmanuel Hocdetddc090b2017-10-27 18:43:29 +020033struct pkey_info {
34 uint8_t sig; /* TLSEXT_signature_[rsa,ecdsa,...] */
35 uint16_t bits; /* key size in bits */
36};
37
Emeric Brunfc0421f2012-09-07 17:30:07 +020038struct sni_ctx {
39 SSL_CTX *ctx; /* context associated to the certificate */
40 int order; /* load order for the certificate */
Tim Duesterhus6a0dd732020-01-18 01:32:49 +010041 unsigned int neg:1; /* reject if match */
42 unsigned int wild:1; /* wildcard sni */
Emmanuel Hocdetddc090b2017-10-27 18:43:29 +020043 struct pkey_info kinfo; /* pkey info */
Emmanuel Hocdet98263292016-12-29 18:26:15 +010044 struct ssl_bind_conf *conf; /* ssl "bind" conf for the certificate */
William Lallemand9117de92019-10-04 00:29:42 +020045 struct list by_ckch_inst; /* chained in ckch_inst's list of sni_ctx */
William Lallemandcfca1422020-03-05 10:17:47 +010046 struct ckch_inst *ckch_inst; /* instance used to create this sni_ctx */
Emeric Brunfc0421f2012-09-07 17:30:07 +020047 struct ebmb_node name; /* node holding the servername value */
48};
49
Emmanuel Hocdet5db33cb2017-03-30 19:19:37 +020050struct tls_version_filter {
51 uint16_t flags; /* ssl options */
52 uint8_t min; /* min TLS version */
53 uint8_t max; /* max TLS version */
54};
55
Nenad Merdanovic200b0fa2015-05-09 08:46:01 +020056extern struct list tlskeys_reference;
57
Emeric Brun9e754772019-01-10 17:51:55 +010058struct tls_sess_key_128 {
Nenad Merdanovic05552d42015-02-27 19:56:49 +010059 unsigned char name[16];
60 unsigned char aes_key[16];
61 unsigned char hmac_key[16];
62} __attribute__((packed));
63
Emeric Brun9e754772019-01-10 17:51:55 +010064struct tls_sess_key_256 {
65 unsigned char name[16];
66 unsigned char aes_key[32];
67 unsigned char hmac_key[32];
68} __attribute__((packed));
69
70union tls_sess_key{
71 unsigned char name[16];
Nenad Merdanovic8ef70652019-04-14 16:06:46 +020072 struct tls_sess_key_128 key_128;
Emeric Brun9e754772019-01-10 17:51:55 +010073 struct tls_sess_key_256 key_256;
74} __attribute__((packed));
75
Nenad Merdanovic146defa2015-05-09 08:46:00 +020076struct tls_keys_ref {
77 struct list list; /* Used to chain refs. */
78 char *filename;
79 int unique_id; /* Each pattern reference have unique id. */
Willy Tarreau17b4aa12018-07-17 10:05:32 +020080 int refcount; /* number of users of this tls_keys_ref. */
Emeric Brun9e754772019-01-10 17:51:55 +010081 union tls_sess_key *tlskeys;
Nenad Merdanovic146defa2015-05-09 08:46:00 +020082 int tls_ticket_enc_index;
Emeric Brun9e754772019-01-10 17:51:55 +010083 int key_size_bits;
Christopher Faulet16f45c82018-02-16 11:23:49 +010084 __decl_hathreads(HA_RWLOCK_T lock); /* lock used to protect the ref */
Nenad Merdanovic146defa2015-05-09 08:46:00 +020085};
86
William Lallemand4f45bb92017-10-30 20:08:51 +010087/* shared ssl session */
88struct sh_ssl_sess_hdr {
89 struct ebmb_node key;
90 unsigned char key_data[SSL_MAX_SSL_SESSION_ID_LENGTH];
91};
92
William Lallemandf6adbe92019-09-11 16:33:52 +020093/* This is used to preload the certifcate, private key
94 * and Cert Chain of a file passed in via the crt
95 * argument
96 *
97 * This way, we do not have to read the file multiple times
98 */
99struct cert_key_and_chain {
100 X509 *cert;
101 EVP_PKEY *key;
102 STACK_OF(X509) *chain;
103 DH *dh;
William Lallemanda17f4112019-10-10 15:16:44 +0200104 struct buffer *sctl;
William Lallemand246c0242019-10-11 08:59:13 +0200105 struct buffer *ocsp_response;
106 X509 *ocsp_issuer;
William Lallemandf6adbe92019-09-11 16:33:52 +0200107};
108
109/*
110 * this is used to store 1 to SSL_SOCK_NUM_KEYTYPES cert_key_and_chain and
111 * metadata.
112 */
113struct ckch_store {
114 struct cert_key_and_chain *ckch;
Tim Duesterhus6a0dd732020-01-18 01:32:49 +0100115 unsigned int multi:1; /* is it a multi-cert bundle ? */
William Lallemand9117de92019-10-04 00:29:42 +0200116 struct list ckch_inst; /* list of ckch_inst which uses this ckch_node */
William Lallemandf6adbe92019-09-11 16:33:52 +0200117 struct ebmb_node node;
118 char path[0];
119};
120
William Lallemand9117de92019-10-04 00:29:42 +0200121/*
122 * This structure describe a ckch instance. An instance is generated for each
123 * bind_conf. The instance contains a linked list of the sni ctx which uses
124 * the ckch in this bind_conf.
125 *
126 * XXX: the instance may evolve to handle ssl_bind_conf instead of bind_conf.
127 */
128struct ckch_inst {
129 struct bind_conf *bind_conf; /* pointer to the bind_conf that uses this ckch_inst */
William Lallemand150bfa82019-09-19 17:12:49 +0200130 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 +0100131 struct ckch_store *ckch_store; /* pointer to the store used to generate this inst */
William Lallemand21724f02019-11-04 17:56:13 +0100132 int is_default; /* This instance is used as the default ctx for this bind_conf */
William Lallemand9117de92019-10-04 00:29:42 +0200133 struct list sni_ctx; /* list of sni_ctx using this ckch_inst */
134 struct list by_ckchs; /* chained in ckch_store's list of ckch_inst */
135};
William Lallemandf6adbe92019-09-11 16:33:52 +0200136
137#if HA_OPENSSL_VERSION_NUMBER >= 0x1000200fL
138
139#define SSL_SOCK_POSSIBLE_KT_COMBOS (1<<(SSL_SOCK_NUM_KEYTYPES))
140
141struct key_combo_ctx {
142 SSL_CTX *ctx;
143 int order;
144};
145
146/* Map used for processing multiple keypairs for a single purpose
147 *
148 * This maps CN/SNI name to certificate type
149 */
150struct sni_keytype {
151 int keytypes; /* BITMASK for keytypes */
152 struct ebmb_node name; /* node holding the servername value */
153};
154
155#endif
156
William Lallemande0f3fd52020-02-25 14:53:06 +0100157/* issuer chain store with hash of Subject Key Identifier
158 certificate/issuer matching is verify with X509_check_issued
159*/
160struct issuer_chain {
161 struct eb64_node node;
162 STACK_OF(X509) *chain;
163 char *path;
164};
165
166
Willy Tarreauc125cef2019-05-10 09:58:43 +0200167#endif /* USE_OPENSSL */
Emeric Brunfc0421f2012-09-07 17:30:07 +0200168#endif /* _TYPES_SSL_SOCK_H */