P2P 与分布式存储 / 系统课时

Noise 与 TLS 如何认证远端

Noise 与 TLS 如何认证远端

TCP 连接建立后,节点仍无法确认对方是否拥有目标 Peer ID 对应的私钥。本课拆解 libp2p 中 Noise 与 TLS 1.3 的密钥协商和身份认证机制,并通过本地实验验证:连接地址正确但远端身份不匹配时,安全握手必须失败。

学习目标

  • 解释 Noise 与 TLS 1.3 如何建立加密会话,并把远端公钥绑定到 Peer ID。
  • 区分握手密钥、节点身份密钥以及远端身份检查的职责。
  • 使用 go-libp2p 分别完成正常连接和错误 Peer ID 连接实验。

安全握手位于连接建立的哪个阶段

对于使用 TCP 的 libp2p 节点,TCP 三次握手只能证明双方建立了网络连接,不能证明远端身份。libp2p 还需要通过安全协议协商、加密握手和流复用器协商,才能提供可供应用协议使用的连接。

典型连接过程如下:

  1. 建立 TCP 连接,得到尚未加密的底层连接。
  2. 通过 multistream-select 协商共同支持的安全协议,例如 /noise 或 /tls/1.0.0。
  3. 进行密码学握手,验证身份密钥与会话握手材料的绑定关系,并建立加密密钥。
  4. 发起方检查认证得到的远端 Peer ID 是否等于预期 Peer ID。
  5. 安全握手成功后,建立流复用能力,例如使用 yamux,随后创建应用数据流。

Noise 与 TLS 1.3 的安全握手、身份绑定和失败分支时序

如果双方没有共同支持的安全协议,连接会在安全协议协商阶段失败;如果安全协议一致但身份不匹配,则会在认证阶段失败。这两种错误不能混为一谈。

Noise 与 TLS 如何把公钥绑定到 Peer ID

Noise 和 TLS 都能提供加密、完整性保护和远端身份认证,但它们证明身份的方式不同。

对比项 Noise libp2p TLS 1.3
安全协议 ID /noise /tls/1.0.0
握手机制 Noise XX TLS 1.3
密钥协商 X25519 Diffie-Hellman TLS 1.3 支持的密钥交换机制
身份证明 身份私钥签名 Noise 静态公钥 身份私钥签名证书相关公钥材料
身份载体 加密握手载荷中的身份公钥与签名 X.509 证书扩展中的身份公钥与签名
远端检查 验证签名并推导、比较 Peer ID 验证证书扩展中的身份签名并推导、比较 Peer ID

Noise 的身份认证链

libp2p Noise 使用 Noise_XX_25519_ChaChaPoly_SHA256 协议组合。XX 握手交换临时密钥和 Noise 静态公钥,完成 Diffie-Hellman 运算并派生加密会话所需的对称密钥。

Noise 静态密钥与 libp2p 节点身份密钥是两套不同的密钥。节点使用自己的 libp2p 身份私钥,对带有固定协议前缀的 Noise 静态公钥数据签名,再将身份公钥和签名放入握手载荷。接收方验证签名,确认 Noise 静态公钥确实得到了该身份密钥的授权。

接收方还需要从身份公钥推导 Peer ID,并与预期远端身份比较。签名有效但 Peer ID 不符合预期,同样必须拒绝连接。

Noise XX 使用三条握手消息。完成握手后,双方分别得到用于发送和接收的加密状态。应用数据使用协商出的会话密钥加密,不直接使用节点长期身份私钥加密。

TLS 1.3 的身份认证链

libp2p TLS 1.3 不依赖普通 HTTPS 的域名认证模式。节点通过证书扩展承载自己的 libp2p 身份公钥,并使用身份私钥签名证明它与证书密钥的绑定关系。

接收方需要验证 TLS 握手中的证书、签名以及 libp2p 身份扩展,再从身份公钥推导 Peer ID。发起方还要将结果与预期连接目标比较。

因此,一个自签名证书并不必然意味着 libp2p 身份认证失败。它的信任依据是有效的身份密钥证明及预期 Peer ID 检查,而不是普通网站的公共 CA 证书链。

本机验证两种安全协议和错误身份

使用两个真实节点 A、B,再生成一个不属于 B 的 Peer ID。A 首先以错误 Peer ID 连接 B 的真实监听地址,检查连接是否被拒绝;随后用 B 的真实 Peer ID 再连接一次,验证正常路径。

本例采用 go-libp2p v0.50.0,需要 Go 1.26 或兼容的自动工具链环境。实验仅监听 127.0.0.1,不需要公网 IP 或 NAT 穿透。

准备步骤:

  1. 创建空目录,执行 go mod init p2p-auth-lab 初始化 Go 模块。
  2. 执行 go get github.com/libp2p/go-libp2p@v0.50.0 安装指定版本依赖。
  3. 新建 main.go,写入下方完整代码。
  4. 执行 go run main.go,观察四条验证结果。
go
package main

import (
    "context"
    "fmt"
    "log"
    "time"

    libp2p "github.com/libp2p/go-libp2p"
    "github.com/libp2p/go-libp2p/core/crypto"
    "github.com/libp2p/go-libp2p/core/host"
    "github.com/libp2p/go-libp2p/core/peer"
    "github.com/libp2p/go-libp2p/p2p/security/noise"
    libp2ptls "github.com/libp2p/go-libp2p/p2p/security/tls"
)

func check(name string, security libp2p.Option) error {
    create := func() (host.Host, error) {
        // 仅开放本机TCP监听,并为本次实验指定安全协议。
        return libp2p.New(
            libp2p.ListenAddrStrings("/ip4/127.0.0.1/tcp/0"),
            security,
        )
    }

    client, err := create()
    if err != nil {
        return err
    }
    defer client.Close()

    server, err := create()
    if err != nil {
        return err
    }
    defer server.Close()

    // 生成与服务端身份无关的第三方Peer ID。
    wrongKey, _, err := crypto.GenerateKeyPair(crypto.Ed25519, -1)
    if err != nil {
        return err
    }
    wrongID, err := peer.IDFromPublicKey(wrongKey.GetPublic())
    if err != nil {
        return err
    }

    ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
    defer cancel()

    // 地址属于B,但声明的预期身份属于第三方。
    err = client.Connect(ctx, peer.AddrInfo{
        ID:    wrongID,
        Addrs: server.Addrs(),
    })
    if err == nil {
        return fmt.Errorf("%s: 错误身份被接受", name)
    }
    if len(client.Network().ConnsToPeer(wrongID)) != 0 {
        return fmt.Errorf("%s: 错误身份仍有活跃连接", name)
    }
    fmt.Printf("%s 错误身份:已拒绝\n", name)

    // 使用相同地址与服务端真实Peer ID重新连接。
    err = client.Connect(ctx, peer.AddrInfo{
        ID:    server.ID(),
        Addrs: server.Addrs(),
    })
    if err != nil {
        return fmt.Errorf("%s 正常连接失败: %w", name, err)
    }
    if len(client.Network().ConnsToPeer(server.ID())) == 0 {
        return fmt.Errorf("%s: 正确身份无活跃连接", name)
    }
    fmt.Printf("%s 正确身份:已连接\n", name)
    return nil
}

func main() {
    suites := []struct {
        name     string
        security libp2p.Option
    }{
        {"Noise", libp2p.Security(noise.ID, noise.New)},
        {"TLS 1.3", libp2p.Security(libp2ptls.ID, libp2ptls.New)},
    }

    for _, suite := range suites {
        if err := check(suite.name, suite.security); err != nil {
            log.Fatal(err)
        }
    }
}

预期输出:

text
Noise 错误身份:已拒绝
Noise 正确身份:已连接
TLS 1.3 错误身份:已拒绝
TLS 1.3 正确身份:已连接

运行时会随机生成节点身份,系统也会分配实际 TCP 监听端口,因此每次运行的 Peer ID 和端口都可能不同。本例只输出固定的验证状态,未假定动态 ID、端口或底层错误字符串。

两种安全协议分别创建独立节点,避免已有连接复用影响结果。错误测试使用 B 的真实地址,排除了地址故意不存在这一干扰因素;同时确认错误身份没有活跃连接,正常身份存在活跃连接。

根据失败位置区分身份错误与网络错误

仅凭 Connect 返回错误,不能断言一定发生了身份不匹配。实际排查时,应按照连接建立顺序区分故障层。

可观察现象 优先检查 处理方式
TCP 连接被拒绝或超时 监听地址、端口、防火墙 确认服务端在正确地址监听且可达
安全协议协商失败 两端是否有共同的 /noise 或 /tls/1.0.0 对齐至少一种安全协议
密钥或签名认证失败 身份密钥、握手签名或证书身份扩展 检查密钥是否被错误替换、加载或签名
远端 Peer ID 不匹配 预期 Peer ID 与握手认证出的 Peer ID 修正发现记录或连接目标,不能绕过校验
安全握手成功但应用请求被拒绝 应用协议与访问控制规则 检查业务授权,而非关闭加密

本地实验中,如果错误 Peer ID 测试意外返回成功,应首先检查是否禁用了远端身份验证,或者是否误用了没有预期身份约束的拨号路径。Noise 的 DisablePeerIDCheck 等绕过身份检查的选项不应被当作解决身份不匹配问题的办法。

还需要检查实际拨号使用的身份来源。对于已知节点,应从经过验证的配置或可信发现记录中获取预期 Peer ID,不能把握手后收到的任意身份直接当作原本想连接的目标。

生产环境应妥善持久化节点身份私钥。若每次重启都重新生成身份密钥,Peer ID 也会随之改变,依赖旧 Peer ID 的节点可能持续连接失败。此时应确认密钥加载过程及节点身份迁移方案,而不是关闭身份认证。

可进一步核对 libp2p Noise 协议规范 和 libp2p TLS 握手规范。二者使用不同的身份绑定机制,但必须达到相同的安全结果:握手认证出的公钥与目标 Peer ID 一致后,才允许在加密连接上承载应用通信。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Noise 与 TLS 如何认证远端

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通