返回资讯中心
外部精选
软件工程
#开发者实时流

LogRaker 为 swift-nio-ssh 分支增加 RSA 密钥支持

来源标题:Adding RSA Support to swift-nio-ssh

LogRaker 通过内置 swift-nio-ssh 分支补上了该库缺失的 RSA 支持。上游只支持 ed25519 等现代算法,而 Amazon EC2 在 2021 年前签发的密钥对均为 PKCS#1 RSA,客户端无法回避。由于 NIOSSHPrivateKey 的密钥存储为 internal 枚举且无公开扩展点,添加算法必须直接修改模块源码。

Hacker News 最新moonlighter2026/11/12 · 5 天前14 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

LogRaker 通过 swift-nio-ssh 与 SSH 交互,这个库很好,但有一个缺口:它不支持 RSA。这是有意为之。上游只支持现代原语,对于新部署来说,较新的 ed25519 格式是更好的默认选择。

但这也并非总是你能决定的。Amazon EC2 发放的是 PKCS#1 RSA .pem 密钥对,直到 2021 年才加入 ed25519 密钥对。任何早于此的密钥对都是 RSA,它们打开的实例仍在运行,而客户端这边对此毫无商量余地。一个日志查看器如果不能用 ~/.ssh/ 里的密钥,那就没什么用。

所以 LogRaker 引入了一个 fork。以下是实际需要做的事情。

显而易见的做法是从模块外部添加密钥类型。但不行。NIOSSHPrivateKey 把密钥存储在一个 internal 枚举里:

extension NIOSSHPrivateKey { internal enum BackingKey { case ed25519(Curve25519.Signing.PrivateKey) case ecdsaP256(P256.Signing.PrivateKey) // ...

backingKey 是 internal 的,逐成员初始化器 init(backingKey:) 是 private 的,而唯一的 public 初始化器是每个支持的算法各一个。没有协议可以遵循,也没有 case 可以添加。添加一个算法意味着修改模块,也就意味着一个新的 fork。

最终涉及八个文件:Package.swift 用来从 swift-crypto 的 CryptoExtras 产品中引入 _RSA.Signing(它不在 Crypto 里),Sources/NIOSSH/ 下的五个源文件,以及一个必须修改的上游测试,因为它把 ssh-rsa 用作无人识别的算法示例。

即使你从不碰 nio-ssh,这部分也值得一读。一个 publickey 用户认证请求携带一个公钥 blob 和一个算法名。对于 ed25519 和 ECDSA 曲线,这两个字符串完全相同,所以上游把密钥自己的标签写进算法名字段,根本不需要考虑这件事:

writtenBytes += self.writeSSHString(key.keyPrefix)

RSA 是唯一一个两者不同的算法。密钥 blob 仍然标记为 ssh-rsa,但算法名必须指明签名算法:rsa-sha2-256 或 rsa-sha2-512,来自 RFC 8332。裸的 ssh-rsa 名称意味着使用 SHA-1 的 RSA,OpenSSH 8.8 在 2021 年默认禁用了它。把这个名字提供给任何当前的服务器,都会被直接拒绝,无论你的密钥有多好。

所以 fork 在 keyPrefix 旁边添加了 signatureAlgorithmName:

internal var signatureAlgorithmName: String.UTF8View { switch self.backingKey { case .rsa: return Self.rsaSHA512SignatureAlgorithm case .ed25519, .ecdsaP256, .ecdsaP384, .ecdsaP521, .certified: return self.keyPrefix

微妙之处不在于这个属性本身,而在于算法名被写入两个地方,而且它们必须逐字节一致:

一个是你的声明,另一个是你的签名。如果两者出现分歧,你发送的每个字节单独来看都是格式良好的,密钥是正确的,签名是有效的 RSA 签名,但服务器仍然会拒绝它。没有任何错误消息会指向这个不匹配,因为从服务器的角度来看,它与错误的密钥无法区分。这就是那种通过写出两个缓冲区并对比它们才能发现的 bug。

现在有一个测试把两者固定在一起,这样下一个触碰任一写入点的人会得到一个失败,而不是一个谜团。

这个 fork 总是提供 rsa-sha2-512 而不进行协商。这听起来很偷懒,实际上是不得已而为之:nio-ssh 不解析 SSH_MSG_EXT_INFO,所以 server-sig-algs 列表永远不会到达任何可以据此行动的代码。没有什么可以协商的。

无论如何,这是一个安全的默认值。rsa-sha2-512 自 OpenSSH 7.2(2016 年)以来就被接受。日志查看器现实中连接的任何东西都比那更新。

一个容易忽略的相关细节:fork 的已知算法列表必须同时包含密钥标签和两个签名算法名,因为该列表会与传入的用户认证请求和 PK_OK 回复中的算法名字段进行比对。一个密钥标签,多个合法名称。

一个 vendored fork 会悄悄腐烂。有三件事让这个 fork 保持可读:

每一处编辑都有标记。每个 hunk 都带有一个 LOGRAKER FORK: 注释,所以与上游的整个 diff 就是一次 grep:

grep -rn "LOGRAKER FORK" Sources/ Tests/ Package.swift

这也是 rebase 检查清单:拉取上游,rebase 到新 tag,标记会告诉你哪些冲突是你的。

有一个测试是承重的。序列化测试将生成的公钥 blob 与 ssh-keygen -y 为同一密钥打印的内容逐字节比较。手写的 SSH 线格式正是那种看似合理的错误能通过审查的地方,而 OpenSSH 是唯一有发言权的。

安全公告不会主动找上你。这是 vendoring 的真正代价,与 RSA 无关。一个本地的 SwiftPM 包永远不会报告新版本,所以没有任何工具会告诉你上游发布了修复。你必须自己去查看:

gh api repos/apple/swift-nio-ssh/security-advisories
--jq '.[] | "(.severity) (.ghsa_id) (.summary)"'

把它放在你真正会去运行的地方。

如果有选择的话,大概不会。Fork 一个安全相关的库意味着你永远拥有它的上游修复,而对这个 fork 的诚实总结是“我们添加了一个其作者选择不包含的算法”。

但约束是真实的:密钥存在,它们是 RSA,它们打开人们需要监控的机器。这个 fork 针对上游 0.15.0 修改了八个文件,每处编辑都有标记,并且可以在 nio-ssh 自己添加 RSA 支持的那天被删除。

这个 fork 是公开的,位于 lograker/swift-nio-ssh,与上游一样采用 Apache 2.0。在依赖它之前请阅读其 README:它的存在是为了服务一个应用,它被固定在 0.15.0,而且没有人审计过它。

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →