SSL/TLS安全Socket类更多...

#include <ssl_socket.hpp>

类 ssl_socket 继承关系图:

Public 成员函数
	ssl_socket ()=default
	默认构造函数
	ssl_socket (const native_handle_type fd)
	从原生句柄构造
	ssl_socket (tcp_socket sock)
	从TCP socket转移构造
	~ssl_socket () override=default
	析构函数
void	init_server_ssl (const ssl_context &ctx)
	初始化服务器端SSL
void	init_client_ssl (const ssl_context &ctx, const string &hostname="")
	初始化客户端端SSL
NEFORCE_NODISCARD string	peer_certificate_info () const
	获取对等方证书信息
ssize_t	send (memory_view< const char > data, int flags=0) override
	发送加密数据
ssize_t	receive (memory_view< char > buffer, int flags=0) override
	接收解密数据
NEFORCE_NODISCARD bool	is_ssl () const noexcept override
	检查是否为SSL/TLS socket
NEFORCE_NODISCARD ssl_stream &	ssl () noexcept
	获取SSL流对象的引用
NEFORCE_NODISCARD const ssl_stream &	ssl () const noexcept
	获取SSL流对象的常量引用
Public 成员函数继承自 tcp_socket
	tcp_socket ()=default
	默认构造函数
	tcp_socket (native_handle_type fd)
	从原生句柄构造
	~tcp_socket () override=default
	析构函数
void	open (int family=AF_INET)
	打开TCP socket
bool	connect (const ip_address &endpoint, milliseconds timeout, bool was_blocking=true)
	连接到远程服务器
ssize_t	send (memory_view< const char > data, milliseconds timeout, int flags=0)
	带超时的发送数据
void	send_all (memory_view< const char > data)
	发送所有数据
vector< char >	receive_all (size_t expected_size)
	接收指定大小的所有数据
Public 成员函数继承自 ip_socket
	ip_socket ()=default
	默认构造函数
	ip_socket (const native_handle_type fd) noexcept
	从原生句柄构造
	~ip_socket () override=default
	析构函数
NEFORCE_NODISCARD int	address_family () const noexcept
	获取地址族
NEFORCE_NODISCARD bool	is_ipv4 () const noexcept
	检查是否为IPv4 socket
NEFORCE_NODISCARD bool	is_ipv6 () const noexcept
	检查是否为IPv6 socket
virtual void	connect (const ip_address &endpoint)
	连接到远程端点（TCP客户端）
bool	close () noexcept override
	关闭socket
Public 成员函数继承自 socket_base
	socket_base ()
	默认构造函数
	socket_base (const native_handle_type fd) noexcept
	从原生句柄构造
	socket_base (socket_base &&other) noexcept
	移动构造函数
socket_base &	operator= (socket_base &&other) noexcept
	移动赋值运算符
virtual	~socket_base ()
	析构函数
NEFORCE_NODISCARD native_handle_type	native_handle () const noexcept
	获取原生句柄
NEFORCE_NODISCARD bool	is_open () const noexcept
	检查socket是否已打开
	operator bool () const noexcept
	布尔转换运算符
void	open (int family, int type, int protocol)
	打开socket
bool	try_open (int family, int type, int protocol) noexcept
	尝试打开socket（不抛出异常）
bool	set_nonblocking (bool enable) noexcept
	设置非阻塞模式
bool	shutdown_send () noexcept
	关闭发送方向
bool	shutdown_receive () noexcept
	关闭接收方向
bool	shutdown_both () noexcept
	关闭双向通信
bool	set_option (int level, int optname, const void *value, ::socklen_t len) noexcept
	设置socket选项
bool	get_option (int level, int optname, void optval, ::socklen_t optlen) const noexcept
	获取socket选项
bool	set_reuse_address (bool enable=true) noexcept
	设置地址重用（SO_REUSEADDR）
bool	set_reuse_port (bool enable=true) noexcept
	设置端口重用（SO_REUSEPORT）
bool	set_keep_alive (bool enable=true) noexcept
	设置TCP KeepAlive
bool	set_tcp_nodelay (bool enable=true) noexcept
	设置TCP_NODELAY（禁用Nagle算法）
bool	set_receive_buffer_size (int size) noexcept
	设置接收缓冲区大小
bool	set_send_buffer_size (int size) noexcept
	设置发送缓冲区大小
bool	set_send_timeout (milliseconds timeout) noexcept
	设置发送超时时间
bool	set_receive_timeout (milliseconds timeout) noexcept
	设置接收超时时间
NEFORCE_NODISCARD optional< ip_address >	local_endpoint () const
	获取本地端点地址
NEFORCE_NODISCARD optional< ip_address >	remote_endpoint () const
	获取远程端点地址
void	bind (const ip_address &endpoint)
	绑定socket到本地地址
void	listen (int backlog)
	开始监听连接（TCP）
NEFORCE_NODISCARD native_handle_type	release () noexcept
	释放socket所有权

额外继承的成员函数
Public 类型继承自 socket_base
using	native_handle_type
	平台原生句柄类型
静态 Public 属性继承自 socket_base
static constexpr native_handle_type	invalid_handle
	无效句柄常量
Protected 属性继承自 ip_socket
int	family_ = AF_UNSPEC
	地址族
Protected 属性继承自 socket_base
native_handle_type	fd_ = invalid_handle
	Socket句柄

详细描述

SSL/TLS安全Socket类

实现SSL/TLS加密的TCP socket，提供安全的网络通信。继承自tcp_socket，可以透明地替换普通TCP socket。

主要功能：

SSL/TLS客户端初始化
SSL/TLS服务器端初始化
加密数据发送和接收
对等方证书信息获取
无缝透明替换TCP socket

使用示例：

ssl_context ctx(ssl_method::TLS_CLIENT);
ctx.load_verify_locations("ca-bundle.crt");
 
ssl_socket client;
client.open(AF_INET);
 
auto server = ip_address::parse("example.com", ports::https);
client.connect(*server, milliseconds(3000));
client.init_client_ssl(ctx, "example.com");
 
// 发送HTTPS请求
string request = "GET / HTTP/1.1\r\nHost: example.com\r\n\r\n";
client.send_all(request.view());
 
// 接收响应
char buffer[4096];
ssize_t received = client.receive({buffer, sizeof(buffer)});
if (received > 0) {
    println(string_view(buffer, received));
}
 
// 获取证书信息
println(client.peer_certificate_info());
 
// SSL服务器示例
ssl_context server_ctx(ssl_method::TLS_SERVER);
server_ctx.load_certificate("server.crt", "server.key");
 
ssl_acceptor acceptor;
acceptor.open(ip_address::any(ports::https));
 
auto client_sock = acceptor.accept_ssl();
client_sock.set_ssl_context(server_ctx);
 
// 与客户端进行加密通信

在文件 ssl_socket.hpp 第 79 行定义.

构造及析构函数说明

◆ ssl_socket() [1/2]

ssl_socket::ssl_socket ( const native_handle_type fd )

inlineexplicit

从原生句柄构造

参数

fd	原生socket句柄

在文件 ssl_socket.hpp 第 93 行定义.

引用了 tcp_socket::tcp_socket().

◆ ssl_socket() [2/2]

ssl_socket::ssl_socket ( tcp_socket sock )

inlineexplicit

从TCP socket转移构造

参数

sock	TCP socket对象

将普通TCP socket转换为SSL socket。适用于接受连接后升级为TLS的场景。

在文件 ssl_socket.hpp 第 103 行定义.

引用了 move() , 以及 tcp_socket::tcp_socket().

成员函数说明

◆ init_client_ssl()

void ssl_socket::init_client_ssl	(	const ssl_context &	ctx,
		const string &	hostname = "" )

初始化客户端端SSL

参数

ctx	SSL上下文（需已加载CA证书）
hostname	服务器主机名（用于SNI和证书验证）

异常

ssl_exception	SSL握手失败时抛出
value_exception	socket未打开时抛出

作为客户端发起SSL/TLS握手。需要在连接建立后调用。

◆ init_server_ssl()

void ssl_socket::init_server_ssl ( const ssl_context & ctx )

初始化服务器端SSL

参数

ctx	SSL上下文（需已加载CA证书）

异常

ssl_exception	SSL握手失败时抛出
value_exception	socket未打开时抛出

作为服务器端执行SSL/TLS握手。需要在连接建立后调用。

◆ is_ssl()

NEFORCE_NODISCARD bool ssl_socket::is_ssl ( ) const

inlineoverridevirtualnoexcept

检查是否为SSL/TLS socket

返回: 始终返回true（SSL/TLS激活时）

重载 tcp_socket .

在文件 ssl_socket.hpp 第 169 行定义.

◆ peer_certificate_info()

NEFORCE_NODISCARD string ssl_socket::peer_certificate_info ( ) const

获取对等方证书信息

返回: 证书信息字符串（主题和颁发者）

返回对等方证书的可读信息，用于调试和验证。

◆ receive()

ssize_t ssl_socket::receive	(	memory_view< char >	buffer,
		int	flags = 0 )

overridevirtual

接收解密数据

参数

buffer	接收缓冲区
flags	接收标志（忽略）

返回: 实际接收的字节数

异常

ssl_exception 接收失败时抛出

如果TLS已激活，通过ssl_stream接收解密数据；否则回退到普通接收。

重载 tcp_socket .

◆ send()

ssize_t ssl_socket::send	(	memory_view< const char >	data,
		int	flags = 0 )

overridevirtual

发送加密数据

参数

data	要发送的数据
flags	发送标志（忽略）

返回: 实际发送的字节数

异常

ssl_exception 发送失败时抛出

如果TLS已激活，通过ssl_stream发送加密数据；否则回退到普通发送。

重载 tcp_socket .

引用了 data().

◆ ssl() [1/2]

NEFORCE_NODISCARD const ssl_stream & ssl_socket::ssl ( ) const

inlinenoexcept

获取SSL流对象的常量引用

返回: SSL流常量引用

在文件 ssl_socket.hpp 第 181 行定义.

◆ ssl() [2/2]

NEFORCE_NODISCARD ssl_stream & ssl_socket::ssl ( )

inlinenoexcept

获取SSL流对象的引用

返回: SSL流引用

在文件 ssl_socket.hpp 第 175 行定义.

该类的文档由以下文件生成:

ssl_socket.hpp

Public 成员函数

额外继承的成员函数

详细描述

构造及析构函数说明

◆ ssl_socket() [1/2]

◆ ssl_socket() [2/2]

成员函数说明

◆ init_client_ssl()

◆ init_server_ssl()

◆ is_ssl()

◆ peer_certificate_info()

◆ receive()

◆ send()

◆ ssl() [1/2]

◆ ssl() [2/2]