#pragma once #include #include #include #include #include #include #include "config.h" #include "circular_buffer.hh" #include "lock.hh" enum class LibsslTLSVersion : uint8_t { Unknown, TLS10, TLS11, TLS12, TLS13 }; class TLSConfig { public: std::vector> d_certKeyPairs; std::vector d_ocspFiles; std::string d_ciphers; std::string d_ciphers13; std::string d_ticketKeyFile; std::string d_keyLogFile; size_t d_maxStoredSessions{20480}; time_t d_sessionTimeout{0}; time_t d_ticketsKeyRotationDelay{43200}; uint8_t d_numberOfTicketsKeys{5}; LibsslTLSVersion d_minTLSVersion{LibsslTLSVersion::TLS10}; bool d_preferServerCiphers{true}; bool d_enableTickets{true}; /* whether OpenSSL will release I/O buffers when the connection becomes idle, saving memory */ bool d_releaseBuffers{true}; /* whether so-called secure renegotiation should be allowed for TLS < 1.3 */ bool d_enableRenegotiation{false}; }; struct TLSErrorCounters { std::atomic d_dhKeyTooSmall{0}; /* the other side sent a DH value that is not large enough */ std::atomic d_inappropriateFallBack{0}; /* SCSV indicates that the client previously tried a higher version, something bad is happening */ std::atomic d_noSharedCipher{0}; /* we could not agree on a cipher to use */ std::atomic d_unknownCipherType{0}; /* unknown cipher type */ std::atomic d_unknownKeyExchangeType{0}; /* * unknown exchange type, weird */ std::atomic d_unknownProtocol{0}; /* unknown protocol (SSLv2 or TLS 1.4, who knows? */ std::atomic d_unsupportedEC{0}; /* unsupported elliptic curve */ std::atomic d_unsupportedProtocol{0}; /* we don't accept this TLS version, sorry */ }; #ifdef HAVE_LIBSSL #include void registerOpenSSLUser(); void unregisterOpenSSLUser(); /* From rfc5077 Section 4. Recommended Ticket Construction */ #define TLS_TICKETS_KEY_NAME_SIZE (16) /* AES-256 */ #define TLS_TICKETS_CIPHER_KEY_SIZE (32) #define TLS_TICKETS_CIPHER_ALGO (EVP_aes_256_cbc) /* HMAC SHA-256 */ #define TLS_TICKETS_MAC_KEY_SIZE (32) #define TLS_TICKETS_MAC_ALGO (EVP_sha256) class OpenSSLTLSTicketKey { public: OpenSSLTLSTicketKey(); OpenSSLTLSTicketKey(std::ifstream& file); ~OpenSSLTLSTicketKey(); bool nameMatches(const unsigned char name[TLS_TICKETS_KEY_NAME_SIZE]) const; int encrypt(unsigned char keyName[TLS_TICKETS_KEY_NAME_SIZE], unsigned char *iv, EVP_CIPHER_CTX *ectx, HMAC_CTX *hctx) const; bool decrypt(const unsigned char* iv, EVP_CIPHER_CTX *ectx, HMAC_CTX *hctx) const; private: unsigned char d_name[TLS_TICKETS_KEY_NAME_SIZE]; unsigned char d_cipherKey[TLS_TICKETS_CIPHER_KEY_SIZE]; unsigned char d_hmacKey[TLS_TICKETS_MAC_KEY_SIZE]; }; class OpenSSLTLSTicketKeysRing { public: OpenSSLTLSTicketKeysRing(size_t capacity); ~OpenSSLTLSTicketKeysRing(); void addKey(std::shared_ptr newKey); std::shared_ptr getEncryptionKey(); std::shared_ptr getDecryptionKey(unsigned char name[TLS_TICKETS_KEY_NAME_SIZE], bool& activeKey); size_t getKeysCount(); void loadTicketsKeys(const std::string& keyFile); void rotateTicketsKey(time_t now); private: SharedLockGuarded > > d_ticketKeys; }; void* libssl_get_ticket_key_callback_data(SSL* s); void libssl_set_ticket_key_callback_data(SSL_CTX* ctx, void* data); int libssl_ticket_key_callback(SSL *s, OpenSSLTLSTicketKeysRing& keyring, unsigned char keyName[TLS_TICKETS_KEY_NAME_SIZE], unsigned char *iv, EVP_CIPHER_CTX *ectx, HMAC_CTX *hctx, int enc); int libssl_ocsp_stapling_callback(SSL* ssl, const std::map& ocspMap); std::map libssl_load_ocsp_responses(const std::vector& ocspFiles, std::vector keyTypes); int libssl_get_last_key_type(std::unique_ptr& ctx); #ifdef HAVE_OCSP_BASIC_SIGN bool libssl_generate_ocsp_response(const std::string& certFile, const std::string& caCert, const std::string& caKey, const std::string& outFile, int ndays, int nmin); #endif void libssl_set_error_counters_callback(std::unique_ptr& ctx, TLSErrorCounters* counters); LibsslTLSVersion libssl_tls_version_from_string(const std::string& str); const std::string& libssl_tls_version_to_string(LibsslTLSVersion version); bool libssl_set_min_tls_version(std::unique_ptr& ctx, LibsslTLSVersion version); std::unique_ptr libssl_init_server_context(const TLSConfig& config, std::map& ocspResponses); std::unique_ptr libssl_set_key_log_file(std::unique_ptr& ctx, const std::string& logFile); /* called in a client context, if the client advertised more than one ALPN values and the server returned more than one as well, to select the one to use. */ void libssl_set_npn_select_callback(SSL_CTX* ctx, int (*cb)(SSL* s, unsigned char** out, unsigned char* outlen, const unsigned char* in, unsigned int inlen, void* arg), void* arg); /* called in a server context, to select an ALPN value advertised by the client if any */ void libssl_set_alpn_select_callback(SSL_CTX* ctx, int (*cb)(SSL* s, const unsigned char** out, unsigned char* outlen, const unsigned char* in, unsigned int inlen, void* arg), void* arg); /* set the supported ALPN protos in client context */ bool libssl_set_alpn_protos(SSL_CTX* ctx, const std::vector>& protos); std::string libssl_get_error_string(); #endif /* HAVE_LIBSSL */