mirror of
https://gitee.com/acl-dev/acl.git
synced 2024-12-15 09:20:52 +08:00
135 lines
3.0 KiB
C++
135 lines
3.0 KiB
C++
#pragma once
|
|
#include "../acl_cpp_define.hpp"
|
|
#include "../stdlib/thread_mutex.hpp"
|
|
#include "sslbase_conf.hpp"
|
|
#include <vector>
|
|
|
|
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 append_key_cert(const char* crt_file, const char* key_file,
|
|
const char* key_pass = NULL);
|
|
|
|
/**
|
|
* @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* create(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_;
|
|
std::vector<std::pair<void*, void*> > cert_keys_;
|
|
|
|
private:
|
|
bool init_once(void);
|
|
bool init_rand(void);
|
|
void free_ca(void);
|
|
};
|
|
|
|
} // namespace acl
|