7747ec921f
- 新增 tls.c/tls.h，使用 OpenSSL Memory BIO 与 coco 协程 I/O 集成 - 支持 TLS 1.2+，通过命令行 --cert/--key 或配置文件启用 - 所有静态文件、目录浏览、POST/文件上传功能均已支持 HTTPS - 集成测试新增 TLS 握手 + HTTPS 响应验证 - 单元测试 127 项通过，集成测试 39 项通过
93 lines
2.2 KiB
C
93 lines
2.2 KiB
C
/**
|
||
* tls.h - TLS/SSL 模块接口
|
||
*
|
||
* 基于 OpenSSL 实现 HTTPS 支持，使用 Memory BIO 与 coco 协程 I/O 集成。
|
||
*
|
||
* 设计:
|
||
* - 全局 SSL_CTX 管理证书和私钥
|
||
* - 每个连接独立的 SSL* + Memory BIO 对
|
||
* - fd→SSL 映射表，使 send_all 等现有代码透明支持 TLS
|
||
* - SSL_read/write 的 WANT_READ/WANT_WRITE 通过 coco_read/write 协程化
|
||
*
|
||
* @author xfy
|
||
*/
|
||
|
||
#ifndef COCOON_TLS_H
|
||
#define COCOON_TLS_H
|
||
|
||
#include <stdbool.h>
|
||
#include <stddef.h>
|
||
#include <sys/types.h>
|
||
|
||
/**
|
||
* tls_create_context - 创建全局 TLS 上下文
|
||
*
|
||
* 加载证书和私钥，初始化 OpenSSL。
|
||
*
|
||
* @param cert_path PEM 格式证书路径
|
||
* @param key_path PEM 格式私钥路径
|
||
* @return 0 成功，-1 失败
|
||
*/
|
||
int tls_create_context(const char *cert_path, const char *key_path);
|
||
|
||
/**
|
||
* tls_destroy_context - 销毁全局 TLS 上下文
|
||
*/
|
||
void tls_destroy_context(void);
|
||
|
||
/**
|
||
* tls_has_context - 检查 TLS 上下文是否已创建
|
||
*/
|
||
bool tls_has_context(void);
|
||
|
||
/**
|
||
* tls_accept - 为指定 fd 创建 SSL 连接并完成握手
|
||
*
|
||
* 在协程上下文中调用，WANT_READ/WANT_WRITE 时自动 yield。
|
||
*
|
||
* @param fd 已连接的客户端 socket
|
||
* @return 0 成功，-1 失败
|
||
*/
|
||
int tls_accept(int fd);
|
||
|
||
/**
|
||
* tls_read - 从 TLS 连接读取解密后的数据
|
||
*
|
||
* 在协程上下文中调用，数据不足时自动 yield。
|
||
*
|
||
* @param fd 客户端 socket
|
||
* @param buf 输出缓冲区
|
||
* @param len 最大读取字节数
|
||
* @return 读取字节数，0 对端关闭，-1 错误
|
||
*/
|
||
ssize_t tls_read(int fd, void *buf, size_t len);
|
||
|
||
/**
|
||
* tls_write - 向 TLS 连接写入明文数据（自动加密后发送）
|
||
*
|
||
* @param fd 客户端 socket
|
||
* @param buf 待发送数据
|
||
* @param len 数据长度
|
||
* @return 写入字节数（明文），-1 错误
|
||
*/
|
||
ssize_t tls_write(int fd, const void *buf, size_t len);
|
||
|
||
/**
|
||
* tls_close - 关闭 TLS 连接并释放资源
|
||
*
|
||
* 执行 SSL_shutdown，清理 fd 映射。
|
||
*
|
||
* @param fd 客户端 socket
|
||
*/
|
||
void tls_close(int fd);
|
||
|
||
/**
|
||
* tls_has_connection - 检查 fd 是否关联了 TLS 连接
|
||
*
|
||
* @param fd 客户端 socket
|
||
* @return true 是 TLS 连接
|
||
*/
|
||
bool tls_has_connection(int fd);
|
||
|
||
#endif /* COCOON_TLS_H */
|