身份与安全档
分册导航: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 未实施。