Table of Contents

身份与安全档

分册导航:net.md | net-topology.md | net-transport.md | [net-raft.md](raft 接入) | net-identity-security.md | net-p2p.md | net-observability.md | 运行拓扑与一致性 | 传输配置与调参 | raft 共识接入 | 身份与安全档 | P2P 会员与 gossip 广播 | 可观测与故障注入

7. 身份与机制挂载

  • IIdentitySource(端口——本层零 IO):跨重启稳定身份。ClusterBuilder.Create(source) 启动时解析;持久化形态(如 TierFsIdentityStore)在组装层实现端口。
  • INodeMechanism(机制挂载端口——零特权):任何协议机制与内建机制同一挂载路径:
await ClusterBuilder.Create(nodeId)
    .WithMechanism(new MyFsmMechanism())     // 你的状态机复制机制
    .WithP2P(seed: bootstrapNode)            // 内建 HyParView(对等发现——P2P 扩展方法)
    .StartAsync(ct);

机制生命周期随 NodeEndpoint 释放(endpoint.Mechanisms 可枚举已挂载件)。

7.1 QUIC 介质(TLS1.3 原生)

var transport = new QuicTransport(nodeId, TransportOptions.Default(
    new IPEndPoint(IPAddress.Loopback, 4433), peers));   // MsQuic 不可用 = 构造 fail-fast
transport.Start();
  • 三形态映射:请求回调 = 短命双向 stream(stream 即关联);流式会话 = 双向长命 stream (QUIC 流控 = 背压天然);数据报 = 单向短命 stream(send-and-forget——.NET 8 无 QUIC datagram API,语义为"单流失败即丢",非 UDP 级无序尽力)。
  • TLS1.3 原生:运行时自签证书(内网模式——加密+完整性免费);身份经应用层握手交换 (ClusterTag 校验错集群 fail-fast);SAN nid 绑定随 mTLS 体系集成。
  • 运行依赖:MsQuic(Windows 11/Server 2022+ 内置;Linux 须 libmsquic)—— QuicCertificates.IsSupported 装配前探测。
  • at-least-once(RequestOptions.Retry):CorrId 贯穿 + 应答端去重窗口缓存重放。

10. 安全档(加密与认证)

档 何时用 装配
明文(缺省) 可信域内网 零配置
KeyPair(推荐) 无证书体系的内生集群(WireGuard 式) .WithKeyPair(SecurityOptions.KeyPairPinned(ownKey, new PinnedTrustStore(peers, peerKeys)))
mTLS CA/合规场景(短期证书+轮换) .WithMutualTls(cert, caCollection)(证书 SAN 含 nid:<hex32> 条目)
// KeyPair 档:每节点静态密钥对 + 对端公钥钉扎表(信任强度 = mTLS)
using var own = NodeKeyPair.Generate();   // 持久化:ExportPrivateKey → 安全存储 → FromPrivateKey
var security = SecurityOptions.KeyPairPinned(own,
    new PinnedTrustStore([peerA, peerB], [peerAKey.PublicKey.ToArray(), peerBKey.PublicKey.ToArray()]));
await using var endpoint = await ClusterBuilder.Create(nodeId)
    .WithKeyPair(security)                // 此后全帧 AEAD 加密+认证(MAC-only 粒度可选)
    /* ... */
    .StartAsync(ct);
  • 防降级 fail-closed:本端安全档与对端不匹配立即断连——永不静默降级明文(含 KeyPair↔mTLS 互遇)。
  • TOFU 形态:SecurityOptions.KeyPairTofu(own, trust) 首连学习对端公钥(SSH known_hosts 式——首连有中间人窗口,半可信内网用);持久化实现 ITrustAnchorStore 归组装层。
  • UDP 承载:KeyPair 档数据报带认证标签(会话派生——篡改丢弃);mTLS 档 UDP 不带标签(见 §UDP 加密场景)——自动回落 TCP 未实施。