98 lines
		
	
	
		
			3.0 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			98 lines
		
	
	
		
			3.0 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| #pragma once
 | |
| /*
 | |
|  * Copyright (c) 2016 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: 2020-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.
 | |
|  */
 | |
| 
 | |
| /**
 | |
|  * @file ssl.h
 | |
|  *
 | |
|  * The SSL definitions for MaxScale
 | |
|  */
 | |
| 
 | |
| #include <maxscale/cdefs.h>
 | |
| #include <maxscale/protocol.h>
 | |
| #include <openssl/crypto.h>
 | |
| #include <openssl/ssl.h>
 | |
| #include <openssl/err.h>
 | |
| #include <openssl/dh.h>
 | |
| 
 | |
| MXS_BEGIN_DECLS
 | |
| 
 | |
| struct dcb;
 | |
| 
 | |
| typedef enum ssl_method_type
 | |
| {
 | |
| #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
 | |
| } ssl_method_type_t;
 | |
| 
 | |
| /**
 | |
|  * 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
 | |
|  */
 | |
| typedef 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 */
 | |
|     struct ssl_listener
 | |
|         *next;          /*< Next SSL configuration, currently used to store obsolete configurations */
 | |
| } SSL_LISTENER;
 | |
| 
 | |
| int ssl_authenticate_client(struct dcb *dcb, bool is_capable);
 | |
| bool ssl_is_connection_healthy(struct dcb *dcb);
 | |
| bool ssl_check_data_to_process(struct dcb *dcb);
 | |
| bool ssl_required_by_dcb(struct dcb *dcb);
 | |
| bool ssl_required_but_not_negotiated(struct 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(struct dcb *dcb);
 | |
| 
 | |
| // TODO: Move this to an internal ssl.h header
 | |
| void write_ssl_config(int fd, SSL_LISTENER* ssl);
 | |
| 
 | |
| MXS_END_DECLS
 | 
