下载脚本,保存要检查的文件(例如用 curl),然后可以在断网的电脑上运行。公钥写在脚本里,也在 /.well-known/kolaboro-keys.json 中;请比对一次两者。
两个版本执行相同的检查,给出相同的答案。退出码 0 表示全部通过。
下载
- /open/kolaboro_offline_verify.py Python 3.8+, stdlib only
- /open/kolaboro-offline-verify.mjs Node 18+, no packages
使用方法
快照链:重新计算每日哈希链的每个链头,以及您保存的每个副本的 SHA-256(.gz 副本会被解压)。
curl -O https://kolaboro.com/data/snapshots/index.json
curl -O https://kolaboro.com/data/snapshots/2026-11-17/named.json.gz
python3 kolaboro_offline_verify.py chain index.json named.json.gz项目证书:规范化 JSON、事实哈希和 Ed25519 签名。
curl -o cert.json https://kolaboro.com/api/v1/projects/amani-melasti/certificate
python3 kolaboro_offline_verify.py cert cert.json任何已签名的 API 响应:保存响应正文和 x-kolaboro-signature 头。
curl -s -D h.txt -o body.json https://kolaboro.com/api/v1/snapshots
node kolaboro-offline-verify.mjs sig body.json "$(grep -i '^x-kolaboro-signature:' h.txt | cut -d' ' -f2 | tr -d '\r')"构建证明:网站所提供的提交和数据的签名记录。
curl -o prov.json https://kolaboro.com/api/v1/provenance
python3 kolaboro_offline_verify.py provenance prov.json自检:内置测试向量,其中包括一个必须失败的签名。
python3 kolaboro_offline_verify.py selftest检查内容
- 每个链头是“kolaboro-snapshot-v1|日期|/data/named.json|sha256|字节数|上一个链头”的 SHA-256,从“genesis”开始;任何位置改动一个字节都会破坏之后的所有链头。
- 保存的副本与当天的 SHA-256 和大小一致。
- Ed25519 签名的对象是“kolaboro-sig-v1\n”加上原始字节的十六进制 SHA-256(RFC 8032;Python 文件自带实现,Node 使用内置 crypto)。
- 证书和证明:键排序、无空格,然后用相同的签名规则;证书还要检查事实的哈希。
/data/snapshots/ · /verify/ · kolaboro-keys.json