#pragma once #include "../acl_cpp_define.hpp" #include "../stdlib/thread_mutex.hpp" #include "sslbase_conf.hpp" #include namespace acl { /** * SSL 证书校验级别类型定义 */ typedef enum { MBEDTLS_VERIFY_NONE, // 不校验证书 MBEDTLS_VERIFY_OPT, // 选择性校验,可以在握手时或握手后校验 MBEDTLS_VERIFY_REQ // 要求在握手时校验 } mbedtls_verify_t; class mbedtls_io; /** * SSL 连接对象的配置类,该类对象一般可以声明为全局对象,用来对每一个 SSL * 连接对象进行证书配置;该类加载了全局性的证书、密钥等信息;每一个 SSL 对象 * (mbedtls_io) 调用本对象的setup_certs 方法来初始化自身的证书、密钥等信息 */ class ACL_CPP_API mbedtls_conf : public sslbase_conf { public: /** * 构造函数 * @param server_side {bool} 用来指定是服务端还是客户端,当为 true 时 * 为服务端模式,否则为客户端模式 * @param verify_mode {mbedtls_verify_t} SSL 证书校验级别 */ mbedtls_conf(bool server_side = false, mbedtls_verify_t verify_mode = MBEDTLS_VERIFY_NONE); ~mbedtls_conf(void); /** * @override */ bool load_ca(const char* ca_file, const char* ca_path); /** * @override */ bool add_cert(const char* crt_file); /** * @override */ bool set_key(const char* key_file, const char* key_pass = NULL); /** * @override */ void enable_cache(bool on); public: /** * mbedtls_io::open 内部会调用本方法用来安装当前 SSL 连接对象的证书 * @param ssl {void*} SSL 连接对象,为 ssl_context 类型 * @return {bool} 配置 SSL 对象是否成功 */ bool setup_certs(void* ssl); /** * 获得随机数生成器的熵对象 * @return {void*},返回值为 entropy_context 类型 */ void* get_entropy(void) { return entropy_; } public: /** * 如果 mbedtls 分成三个库,可以调用本函数设置三个动态库的全路径 * @param libmbedcrypto {const char*} libmbedcrypto 动态库的全路径 * @param libmbedx509 {const char*} libmbedx509 动态库的全路径 * @param libmbedtls {const char*} libmbedtls 动态库的全路径 */ static void set_libpath(const char* libmbedcrypto, const char* libmbedx509, const char* libmbedtls); /** * 如果 mbedtls 合成一个库,可以调用本函数设置一个动态库的全路径 * @param libmbedtls {const char*} libmbedtls 动态库的全路径 */ static void set_libpath(const char* libmbedtls); /** * 显式调用本方法,动态加载 mbedtls 动态库 * @return {bool} 加载是否成功 */ static bool load(void); public: // @override sslbase_conf sslbase_io* open(bool nblock); private: friend class mbedtls_io; unsigned init_status_; unsigned cert_status_; thread_mutex lock_; bool server_side_; void* conf_; void* entropy_; void* rnd_; void* cacert_; void* pkey_; void* cert_chain_; void* cache_; mbedtls_verify_t verify_mode_; private: bool init_once(void); bool init_rand(void); void free_ca(void); }; } // namespace acl