Documentation
¶
Overview ¶
Package relsign 是 Agent 发布产物的独立签名(方案见文档库 design/agent-auto-upgrade.md B.3)。
它存在的原因:Agent 的「静默自动升级」是无人值守的,只靠 Hub 给出的 SHA-256 不够——Hub 被攻破时, 攻击者能同时换掉二进制与它的哈希。所以发布流程用一把只在发布时才用到的私钥给每个 Agent 程序签名, Agent 用主机信任的公钥验签:验不过就既不运行也不安装下载到的程序。
签名绑定的是「版本 + 平台 + 程序内容的 SHA-256」,而不是某个文件名:
- 拿旧版本的签名去配新版本号,消息里的版本对不上,验签失败;
- 把别的平台的程序当作本平台的,消息里的平台对不上,验签失败;
- 程序被改动一个字节,SHA-256 变了,验签失败。
只用标准库的 ed25519,没有新依赖;这个包只包含验证与签名的原语,密钥文件的保管与读写属于签名工具。
Index ¶
- Constants
- Variables
- func FormatPublicKey(pub ed25519.PublicKey) string
- func KeyID(pub ed25519.PublicKey) string
- func Message(version, platform, sha256hex string) ([]byte, error)
- func ParsePublicKey(s string) (ed25519.PublicKey, error)
- func Sign(priv ed25519.PrivateKey, version, platform, sha256hex string) (string, error)
- func ValidSignatureText(text string) bool
- func Verify(trusted []ed25519.PublicKey, signature, version, platform, sha256hex string) error
Constants ¶
View Source
const ( // SignatureScheme 是签名文本的前缀,兼作格式版本:以后要改消息格式就换一个前缀,旧的验证方一律拒绝新格式。 SignatureScheme = "rmsig1" // PublicKeyScheme 是公钥文本的前缀。 PublicKeyScheme = "rmpub1" // MaxSignatureLen 是签名文本的长度上限(实际为 6+1+16+1+86=110 个字符),Hub 与 Agent 都按它限长。 MaxSignatureLen = 128 )
Variables ¶
View Source
var ( // ErrNoKeys 表示可信公钥名单是空的:此时任何签名都不可能验过。 ErrNoKeys = errors.New("没有可信的发布公钥") // ErrBadFormat 表示签名文本、版本、平台或 SHA-256 的写法不合规。 ErrBadFormat = errors.New("签名格式不对") // ErrUnknownKey 表示签名所用的密钥不在可信名单里。 ErrUnknownKey = errors.New("签名所用的密钥不在可信名单里") // ErrBadSignature 表示签名与(版本、平台、内容)不匹配。 ErrBadSignature = errors.New("签名与程序不匹配") )
Functions ¶
func FormatPublicKey ¶
FormatPublicKey 把公钥写成 rmpub1:<64 位十六进制>。
func KeyID ¶
KeyID 是公钥的短标识(公钥 SHA-256 的前 8 个字节,16 位小写十六进制),写在签名里, 让验证方能在信任名单里直接选出对应的公钥——这也是将来轮换密钥(内置主钥与备用钥)时的依据。
func ParsePublicKey ¶
ParsePublicKey 解析公钥文本:rmpub1:<64 位十六进制>,也接受不带前缀的 64 位十六进制。
func Sign ¶
func Sign(priv ed25519.PrivateKey, version, platform, sha256hex string) (string, error)
Sign 用私钥给(版本、平台、内容的 SHA-256)签名,返回 rmsig1:<密钥标识>:<base64url 签名>。
func ValidSignatureText ¶
ValidSignatureText 只检查签名文本的写法(不验签):Hub 用它在转交之前挡掉明显不合规的内容, 它没有任何公钥,也不应该有。
Types ¶
This section is empty.
Click to show internal directories.
Click to hide internal directories.