relsign

package
v2.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 4, 2026 License: Apache-2.0 Imports: 9 Imported by: 0

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

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

func FormatPublicKey(pub ed25519.PublicKey) string

FormatPublicKey 把公钥写成 rmpub1:<64 位十六进制>。

func KeyID

func KeyID(pub ed25519.PublicKey) string

KeyID 是公钥的短标识(公钥 SHA-256 的前 8 个字节,16 位小写十六进制),写在签名里, 让验证方能在信任名单里直接选出对应的公钥——这也是将来轮换密钥(内置主钥与备用钥)时的依据。

func Message

func Message(version, platform, sha256hex string) ([]byte, error)

Message 是被签名的消息:带域分隔前缀的四行文本。三个字段必须符合各自的写法(不允许换行或空白混进去)。

func ParsePublicKey

func ParsePublicKey(s string) (ed25519.PublicKey, error)

ParsePublicKey 解析公钥文本:rmpub1:<64 位十六进制>,也接受不带前缀的 64 位十六进制。

func Sign

func Sign(priv ed25519.PrivateKey, version, platform, sha256hex string) (string, error)

Sign 用私钥给(版本、平台、内容的 SHA-256)签名,返回 rmsig1:<密钥标识>:<base64url 签名>。

func ValidSignatureText

func ValidSignatureText(text string) bool

ValidSignatureText 只检查签名文本的写法(不验签):Hub 用它在转交之前挡掉明显不合规的内容, 它没有任何公钥,也不应该有。

func Verify

func Verify(trusted []ed25519.PublicKey, signature, version, platform, sha256hex string) error

Verify 用可信公钥名单验证签名。名单为空返回 ErrNoKeys;签名文本不合规返回 ErrBadFormat; 签名所用密钥不在名单里返回 ErrUnknownKey;与(版本、平台、内容)对不上返回 ErrBadSignature。 长度不对的公钥会被忽略(不会让验证崩溃);它们不计入「名单非空」。

Types

This section is empty.

Directories

Path Synopsis
Package trust 是编进 Agent 程序的「发布公钥」——静默自动升级的信任根(方案见文档库 design/agent-auto-upgrade.md B.3 与 C 层)。
Package trust 是编进 Agent 程序的「发布公钥」——静默自动升级的信任根(方案见文档库 design/agent-auto-upgrade.md B.3 与 C 层)。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL