
颁发与 OpenID Connect 身份绑定的短期代码签名证书的证书颁发机构,支持可验证的软件供应链签名。
一个免费使用的代码签名 CA
Fulcio 是一个免费使用的证书颁发机构,用于为 OpenID Connect (OIDC) 身份(例如电子邮件地址)颁发代码签名证书。
Fulcio 仅颁发有效期为 10 分钟的短期证书。
Fulcio 已正式可用(General Availability),提供 99.5 的可用性 SLO,并遵循 semver 规则以保证 API 稳定性。
有关 Fulcio 公共实例的正常运行时间数据,请参阅 https://status.sigstore.dev。
Fulcio 的证书链可通过 TrustBundle API 获取,例如公共实例的证书链
(https://fulcio.sigstore.dev)。要验证公共实例,
你必须使用 Sigstore 的 TUF 根(来自
sigstore/root-signing 仓库)来验证该证书链。
为此,请安装并使用 go-tuf 的 CLI 工具:
$ go install github.com/theupdateframework/go-tuf/v2/examples/cli/tuf-client@latest
然后,获取 Sigstore 的受信任根密钥。由于存在向后不兼容的变更,你将使用 Sigstore TUF 根的第 10 次迭代来启动信任根。
curl -o root.json https://raw.githubusercontent.com/sigstore/root-signing/main/metadata/root_history/10.root.json
使用先前获取的根证书和远程仓库 https://tuf-repo-cdn.sigstore.dev 初始化 TUF 客户端,
并获取当前的 Fulcio 根证书 fulcio_v1.crt.pem 和中间证书 fulcio_intermediate_v1.crt.pem。
$ 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 fulcio_v1.crt.pem
$ cat tuf_download/fulcio_v1.crt.pem
-----BEGIN CERTIFICATE-----
MIIB9zCCAXygAwIBAgIUALZNAPFdxHPwjeDloDwyYChAO/4wCgYIKoZIzj0EAwMw
KjEVMBMGA1UEChMMc2lnc3RvcmUuZGV2MREwDwYDVQQDEwhzaWdzdG9yZTAeFw0y
MTEwMDcxMzU2NTlaFw0zMTEwMDUxMzU2NThaMCoxFTATBgNVBAoTDHNpZ3N0b3Jl
LmRldjERMA8GA1UEAxMIc2lnc3RvcmUwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAT7
XeFT4rb3PQGwS4IajtLk3/OlnpgangaBclYpsYBr5i+4ynB07ceb3LP0OIOZdxex
X69c5iVuyJRQ+Hz05yi+UF3uBWAlHpiS5sh0+H2GHE7SXrk1EC5m1Tr19L9gg92j
YzBhMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBRY
wB5fkUWlZql6zJChkyLQKsXF+jAfBgNVHSMEGDAWgBRYwB5fkUWlZql6zJChkyLQ
KsXF+jAKBggqhkjOPQQDAwNpADBmAjEAj1nHeXZp+13NWBNa+EDsDP8G1WWg1tCM
WP/WHPqpaVo0jhsweNFZgSs0eE7wYI4qAjEA2WB9ot98sIkoF3vZYdd3/VtWB5b9
TNMea7Ix/stJ5TfcLLeABLE4BNJOsQ4vnBHJ
-----END CERTIFICATE-----
$ tuf-client get --url https://tuf-repo-cdn.sigstore.dev -t https://tuf-repo-cdn.sigstore.dev/targets fulcio_intermediate_v1.crt.pem
$ cat tuf_download/fulcio_intermediate_v1.crt.pem
-----BEGIN CERTIFICATE-----
MIICGjCCAaGgAwIBAgIUALnViVfnU0brJasmRkHrn/UnfaQwCgYIKoZIzj0EAwMw
KjEVMBMGA1UEChMMc2lnc3RvcmUuZGV2MREwDwYDVQQDEwhzaWdzdG9yZTAeFw0y
MjA0MTMyMDA2MTVaFw0zMTEwMDUxMzU2NThaMDcxFTATBgNVBAoTDHNpZ3N0b3Jl
LmRldjEeMBwGA1UEAxMVc2lnc3RvcmUtaW50ZXJtZWRpYXRlMHYwEAYHKoZIzj0C
AQYFK4EEACIDYgAE8RVS/ysH+NOvuDZyPIZtilgUF9NlarYpAd9HP1vBBH1U5CV7
7LSS7s0ZiH4nE7Hv7ptS6LvvR/STk798LVgMzLlJ4HeIfF3tHSaexLcYpSASr1kS
0N/RgBJz/9jWCiXno3sweTAOBgNVHQ8BAf8EBAMCAQYwEwYDVR0lBAwwCgYIKwYB
BQUHAwMwEgYDVR0TAQH/BAgwBgEB/wIBADAdBgNVHQ4EFgQU39Ppz1YkEZb5qNjp
KFWixi4YZD8wHwYDVR0jBBgwFoAUWMAeX5FFpWapesyQoZMi0CrFxfowCgYIKoZI
zj0EAwMDZwAwZAIwPCsQK4DYiZYDPIaDi5HFKnfxXx6ASSVmERfsynYBiX2X6SJR
nZU84/9DZdnFvvxmAjBOt6QpBlc4J/0DxvkTCqpclvziL6BCCPnjdlIB3Pu3BxsP
mygUY7Ii2zbdCdliiow=
-----END CERTIFICATE-----
Certificate Maker 是一个用于创建 符合 Fulcio 规范的证书链 的工具。它支持:
有关详细的使用说明和示例,请参阅 Certificate Maker 文档。
从 Fulcio v1.10.0 开始,发布二进制文件和容器镜像可以使用 GitHub Artifact Attestations(gh CLI)或 Sigstore 的发布产物签名密钥(artifact.pub 配合 cosign)进行验证。
在以下命令中,请将 <version>(例如 v1.10.0)、<os>(linux 或 darwin)和 <arch>(amd64 或 arm64)替换为您要验证的发布版本和平台。
gh CLI)验证发布二进制文件:
curl -sSfLO "https://github.com/sigstore/fulcio/releases/download/<version>/fulcio-<os>-<arch>"
gh attestation verify "fulcio-<os>-<arch>" \
--repo sigstore/fulcio \
--signer-workflow sigstore/fulcio/.github/workflows/release.yml
验证容器镜像:
gh attestation verify "oci://ghcr.io/sigstore/fulcio:<version>" \
--repo sigstore/fulcio \
--signer-workflow sigstore/fulcio/.github/workflows/build_container.yml \
--bundle-from-oci
cosign)使用 TUF 客户端获取 artifact.pub(或从 sigstore/root-signing 获取):
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
验证发布版二进制文件(v1.8.2+):
curl -sSfLO "https://github.com/sigstore/fulcio/releases/download/<version>/fulcio-<os>-<arch>"
curl -sSfLO "https://github.com/sigstore/fulcio/releases/download/<version>/fulcio-<os>-<arch>.sigstore.json"
cosign verify-blob \
--key artifact.pub \
--bundle "fulcio-<os>-<arch>.sigstore.json" \
"fulcio-<os>-<arch>"
验证容器镜像:
cosign verify \
--key artifact.pub \
-a "GIT_VERSION=<version>" \
"ghcr.io/sigstore/fulcio:<version>"
API 定义在此处。该 API 可通过 HTTP 或 gRPC 访问。
Fulcio 会将签发的证书发布到证书透明度日志(CT log)。
该日志托管在 https://ctfe.sigstore.dev/test。每年,日志都会更新为新的日志 ID,例如 https://ctfe.sigstore.dev/2022。
该日志提供的 API 记录在 RFC 6962 中。
我们鼓励审计人员监控此日志,以检查其完整性和特定身份。例如,审计人员可以监控为某些电子邮件地址签发证书的情况,从而检测配置错误或用户身份可能遭到泄露的情况。
请按照 sigstore 的安全流程报告任何漏洞。
Fulcio 是作为 sigstore 项目的一部分开发的。
我们还使用 slack 频道! 如需了解有关 Slack 和其他沟通渠道的更多信息,请查看社区仓库
除本 README 文件外,docs 文件夹还包含以下附加文档:
如果你要对上述任何主题进行更改,请确保同时编辑上面列出的相应文件。