// EmbeddedAnchor.cpp — 生成端:把服务端信任锚写进客户端镜像的锚块。 // // 见 docs/ClientEmbeddedTLS_Design.md §3.3、§4.6。要点: // 1. magic 字面量在二进制里不止一份(.rdata 里还有一份),所以不能「找到第一处就写」; // 必须扫出全部命中、逐个做结构校验,恰好一个才写,零个报 NoBlock,多个报 Ambiguous。 // 2. 写之前先读 stub 自己的 capacity 字段——老 stub 没有这个块,我们报错而不是越界。 // 3. 超长一律报错,绝不截断:截断的 PEM 会让客户端进 fail-closed 且没有恢复通道。 #include "StdAfx.h" #include "EmbeddedAnchor.h" #include "ServerTlsSession.h" // ServerTlsIdentity::AnchorPem / IsReady / IsBuiltin #include "common/tls_anchor.h" #include #include #pragma comment(lib, "crypt32.lib") namespace { // 扫出所有通过结构校验的锚块偏移。命中通常只有 0 或 1 个:payload 里出现的另一处 // magic 是 .rdata 里的字面量副本,过不了 version/capacity/hash 校验。 std::vector FindAnchorBlocks(const BYTE* payload, DWORD size) { std::vector hits; if (!payload || size < sizeof(EmbeddedTlsAnchor)) return hits; const size_t last = (size_t)size - sizeof(EmbeddedTlsAnchor); for (size_t i = 0; i <= last; ++i) { const char* p = (const char*)payload + i; if (!IsAnchorMagic(p)) continue; EmbeddedTlsAnchor block; memcpy(&block, p, sizeof(block)); // 对齐安全:不直接解引用未对齐指针 if (IsAnchorBlockValid(block)) hits.push_back(i); } return hits; } bool GetAnchorPem(std::string& pem, std::string& err) { if (!ServerTlsIdentity::IsReady()) { err = "server TLS identity is not ready"; return false; } if (!ServerTlsIdentity::AnchorPem(pem) || pem.empty()) { err = "server TLS anchor is empty"; return false; } return true; } } // namespace EmbedResult EmbedTlsAnchorInto(BYTE* payload, DWORD size, const std::string& master, DWORD& pemLen, std::string& err) { pemLen = 0; std::vector hits = FindAnchorBlocks(payload, size); if (hits.empty()) { err = "no embedded TLS anchor block in payload (stub not rebuilt?)"; return EmbedResult::NoBlock; } if (hits.size() > 1) { err = "multiple embedded TLS anchor blocks in payload"; return EmbedResult::Ambiguous; } std::string pem; if (!GetAnchorPem(pem, err)) return EmbedResult::NoAnchor; if (pem.size() > kAnchorCapacity) { err = "certificate PEM is " + std::to_string(pem.size()) + " bytes, slot holds " + std::to_string(kAnchorCapacity); return EmbedResult::TooLong; } // 主控地址槽位:必须给结尾的 '\0' 留一位,否则客户端 strnlen 读到的地址会被截断。 constexpr size_t kMasterSlot = sizeof(EmbeddedTlsAnchor::master); if (master.size() >= kMasterSlot) { err = "master address is " + std::to_string(master.size()) + " bytes, slot holds " + std::to_string(kMasterSlot - 1); return EmbedResult::TooLong; } // 以 stub 里的块为底稿,只改我们负责的字段——magic/capacity 原样保留。 EmbeddedTlsAnchor block; memcpy(&block, payload + hits[0], sizeof(block)); block.version = kAnchorVersion; block.length = (uint32_t)pem.size(); block.hash = Fnv1a32(pem.data(), pem.size()); memset(block.master, 0, sizeof(block.master)); memcpy(block.master, master.c_str(), master.size()); memset(block.pem, 0, sizeof(block.pem)); memcpy(block.pem, pem.data(), pem.size()); memcpy(payload + hits[0], &block, sizeof(block)); pemLen = (DWORD)pem.size(); return EmbedResult::Ok; } bool TlsAnchorSummary(std::string& out) { std::string pem, err; if (!GetAnchorPem(pem, err)) return false; // 只取 PEM 里的第一张证书算指纹:fullchain 时第一张就是服务端自己的叶子证书, // 客户端 pin 的也正是它(见 client/TlsChannel.cpp 的 VerifyServerCert)。 DWORD derLen = 0; if (!CryptStringToBinaryA(pem.c_str(), (DWORD)pem.size(), CRYPT_STRING_BASE64HEADER, NULL, &derLen, NULL, NULL) || derLen == 0) return false; std::vector der(derLen); if (!CryptStringToBinaryA(pem.c_str(), (DWORD)pem.size(), CRYPT_STRING_BASE64HEADER, der.data(), &derLen, NULL, NULL)) return false; std::string thumb("?"), expiry; PCCERT_CONTEXT cert = CertCreateCertificateContext(X509_ASN_ENCODING, der.data(), derLen); if (cert) { BYTE hash[20] = {}; DWORD cbHash = sizeof(hash); if (CertGetCertificateContextProperty(cert, CERT_SHA1_HASH_PROP_ID, hash, &cbHash) && cbHash >= 6) { static const char kHex[] = "0123456789abcdef"; thumb.clear(); for (int i = 0; i < 6; ++i) { thumb += kHex[hash[i] >> 4]; thumb += kHex[hash[i] & 0x0F]; } } FILETIME utc = cert->pCertInfo->NotAfter, local = {}; SYSTEMTIME st = {}; if (FileTimeToLocalFileTime(&utc, &local) && FileTimeToSystemTime(&local, &st)) { char buf[16]; sprintf_s(buf, "%04u-%02u-%02u", st.wYear, st.wMonth, st.wDay); expiry = buf; } CertFreeCertificateContext(cert); } out = (ServerTlsIdentity::IsBuiltin() ? "builtin " : "custom ") + expiry + " sha1:" + thumb; return true; }