96 lines
		
	
	
		
			2.9 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			96 lines
		
	
	
		
			2.9 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
| /*
 | |
|  * Copyright (c) 2018 MariaDB Corporation Ab
 | |
|  *
 | |
|  * Use of this software is governed by the Business Source License included
 | |
|  * in the LICENSE.TXT file and at www.mariadb.com/bsl11.
 | |
|  *
 | |
|  * Change Date: 2022-01-01
 | |
|  *
 | |
|  * On the date above, in accordance with the Business Source License, use
 | |
|  * of this software will be governed by version 2 or later of the General
 | |
|  * Public License.
 | |
|  */
 | |
| #pragma once
 | |
| 
 | |
| /**
 | |
|  * @file ssl.hh
 | |
|  *
 | |
|  * The SSL definitions for MaxScale
 | |
|  */
 | |
| 
 | |
| #include <maxscale/ccdefs.hh>
 | |
| #include <maxscale/protocol.hh>
 | |
| #include <openssl/crypto.h>
 | |
| #include <openssl/ssl.h>
 | |
| #include <openssl/err.h>
 | |
| #include <openssl/dh.h>
 | |
| 
 | |
| struct DCB;
 | |
| 
 | |
| enum ssl_method_type_t
 | |
| {
 | |
| #ifndef OPENSSL_1_1
 | |
|     SERVICE_TLS10,
 | |
| #endif
 | |
| #ifdef OPENSSL_1_0
 | |
|     SERVICE_TLS11,
 | |
|     SERVICE_TLS12,
 | |
| #endif
 | |
|     SERVICE_SSL_MAX,
 | |
|     SERVICE_TLS_MAX,
 | |
|     SERVICE_SSL_TLS_MAX,
 | |
|     SERVICE_SSL_UNKNOWN
 | |
| };
 | |
| 
 | |
| /**
 | |
|  * Return codes for SSL authentication checks
 | |
|  */
 | |
| #define SSL_AUTH_CHECKS_OK       0
 | |
| #define SSL_ERROR_CLIENT_NOT_SSL 1
 | |
| #define SSL_ERROR_ACCEPT_FAILED  2
 | |
| 
 | |
| /**
 | |
|  * The ssl_listener structure is used to aggregate the SSL configuration items
 | |
|  * and data for a particular listener
 | |
|  */
 | |
| struct SSL_LISTENER
 | |
| {
 | |
|     SSL_CTX*    ctx;
 | |
|     SSL_METHOD* method;     /**<  SSLv3 or TLS1.0/1.1/1.2 methods
 | |
|                              * see: https://www.openssl.org/docs/ssl/SSL_CTX_new.html */
 | |
| 
 | |
|     int               ssl_cert_verify_depth;/**< SSL certificate verification depth */
 | |
|     ssl_method_type_t ssl_method_type;      /**< Which of the SSLv3 or TLS1.0/1.1/1.2 methods to use */
 | |
| 
 | |
|     char* ssl_cert;                     /**< SSL certificate */
 | |
|     char* ssl_key;                      /**< SSL private key */
 | |
|     char* ssl_ca_cert;                  /**< SSL CA certificate */
 | |
|     bool  ssl_init_done;                /**< If SSL has already been initialized for this service */
 | |
|     bool  ssl_verify_peer_certificate;  /**< Enable peer certificate verification */
 | |
| 
 | |
|     SSL_LISTENER* next;     /**< Next SSL configuration, currently used to store obsolete configurations */
 | |
| };
 | |
| 
 | |
| int               ssl_authenticate_client(DCB* dcb, bool is_capable);
 | |
| bool              ssl_is_connection_healthy(DCB* dcb);
 | |
| bool              ssl_check_data_to_process(DCB* dcb);
 | |
| bool              ssl_required_by_dcb(DCB* dcb);
 | |
| bool              ssl_required_but_not_negotiated(DCB* dcb);
 | |
| const char*       ssl_method_type_to_string(ssl_method_type_t method_type);
 | |
| ssl_method_type_t string_to_ssl_method_type(const char* str);
 | |
| 
 | |
| /**
 | |
|  * Helper function for client ssl authentication. Authenticates and checks changes
 | |
|  * in ssl status.
 | |
|  *
 | |
|  * @param dcb Client dcb
 | |
|  *
 | |
|  * @return MXS_AUTH_FAILED_SSL or MXS_AUTH_FAILED on error. MXS_AUTH_SSL_INCOMPLETE
 | |
|  * if ssl authentication is in progress and should be retried, MXS_AUTH_SSL_COMPLETE
 | |
|  * if ssl authentication is complete or not required.
 | |
|  */
 | |
| int ssl_authenticate_check_status(DCB* dcb);
 | |
| 
 | |
| // TODO: Move this to an internal ssl.h header
 | |
| void write_ssl_config(int fd, SSL_LISTENER* ssl);
 | 
