
Rekór——希腊语意为“记录”
Rekor 的目标是提供一个不可篡改、防篡改的元数据账本,这些元数据由软件项目的供应链生成。 Rekor 将使软件维护者和构建系统能够将签名的元数据记录到不可变的记录中。 其他方随后可以查询这些元数据,以便就对象的生命周期做出关于信任和不可否认性的明智决策。更多详情请访问 sigstore 网站。
Rekor 项目提供了一个基于 RESTful API 的服务器用于验证,以及一个用于存储的透明日志。 提供了一个 CLI 应用程序,用于创建和验证条目、查询透明日志以获取包含证明、 对透明日志进行完整性验证,或通过公钥或工件检索条目。
Rekor 履行 sigstore 软件签名基础设施中的签名透明性职责。 不过,Rekor 可以独立运行,并且被设计为可扩展以适配不同的清单模式和 PKI 工具。
官方文档。
Rekor v1 处于维护模式。
我们正在积极开发新版本的 Rekor,旨在易于维护且运营成本更低。 基于证书透明性生态系统的积极开发,Rekor v2 将由 基于瓦片的日志 提供支持,并使用 Trillian 的现代化版本 Trillian-Tessera。
在 rekor-tiles 仓库中关注其进展,并在 提案 和 设计文档 中了解更多关于 Rekor v2 的信息。 随着我们接近 V2 版本发布,我们计划将 rekor-tiles 代码库合并到此仓库中。
Rekor 已通过 1.0.0 版本正式全面可用,并遵循 semver 规则 以保证 API 稳定性。 这意味着生产工作负载可以依赖 Rekor 公共实例,该实例拥有 7×24 小时待命轮值支持,并为以下 API 端点提供 99.5% 的可用性 SLO:
/api/v1/log/api/v1/log/publicKey/api/v1/log/proof/api/v1/log/entries/api/v1/log/entries/retrieve有关 Rekor 公共实例的正常运行时间数据,请参见 https://status.sigstore.dev。
有关公共实例的更多详情,请访问 docs.sigstore.dev。
上传到公共实例的证明大小限制为 100KB。如果您需要上传更大的文件,请运行您自己的 Rekor 实例。您可以在 安装 文档中找到相关说明。
有关如何安装 rekor CLI 以及设置/运行 rekor 服务器的详细信息,请参见 安装 页面。
有关将所有支持的类型上传签名到 rekor 的示例,请参见 类型文档。
从 Rekor v1.6.0 开始,可以使用 GitHub Artifact Attestations(gh CLI)或 Sigstore 的发布产物签名密钥(artifact.pub 配合 cosign)来验证发布二进制文件和容器镜像。
在以下命令中,请将 <version>(例如 v1.6.0)、<binary>(rekor-cli 或 rekor-server)、<os>(linux 或 darwin)以及 <arch>(amd64 或 arm64)替换为您要验证的发布版本、二进制文件和平台。
gh CLI)验证发布二进制文件:
curl -sSfLO "https://github.com/sigstore/rekor/releases/download/<version>/<binary>-<os>-<arch>"
gh attestation verify "<binary>-<os>-<arch>" \
--repo sigstore/rekor \
--signer-workflow sigstore/rekor/.github/workflows/release.yml
验证容器镜像:
gh attestation verify "oci://ghcr.io/sigstore/rekor/<binary>:<version>" \
--repo sigstore/rekor \
--signer-workflow sigstore/rekor/.github/workflows/build_container.yml \
--bundle-from-oci
cosign)从 sigstore/root-signing 获取 artifact.pub,或使用 go-tuf 的命令行工具获取:
go install github.com/theupdateframework/go-tuf/v2/examples/cli/tuf-client@latest
curl -sSfLo root.json https://raw.githubusercontent.com/sigstore/root-signing/main/metadata/root_history/10.root.json
tuf-client init --url https://tuf-repo-cdn.sigstore.dev -f root.json
tuf-client get --url https://tuf-repo-cdn.sigstore.dev -t https://tuf-repo-cdn.sigstore.dev/targets artifact.pub
cp tuf_download/artifact.pub ./artifact.pub
验证发布二进制文件:
curl -sSfLO "https://github.com/sigstore/rekor/releases/download/<version>/<binary>-<os>-<arch>"
curl -sSfLO "https://github.com/sigstore/rekor/releases/download/<version>/<binary>-<os>-<arch>.sigstore.json"
cosign verify-blob \
--key artifact.pub \
--bundle "<binary>-<os>-<arch>.sigstore.json" \
"<binary>-<os>-<arch>"
验证容器镜像:
cosign verify \
--key artifact.pub \
-a "GIT_VERSION=<version>" \
"ghcr.io/sigstore/rekor/<binary>:<version>"
Rekor 允许自定义清单(在此称为类型),类型自定义的说明见此处。
如果你有兴趣与 Rekor 集成,我们提供了一个 OpenAPI swagger 编辑器
如果你发现任何安全问题,请参阅 sigstore 的安全流程
我们欢迎任何人的贡献,尤其希望听到 Rekor 用户的声音。
除本 README 文件外,此文件夹还包含以下附加文档: