
OpenID Connect アイデンティティに紐付けられた短命のコード署名証明書を発行する認証局。検証可能なソフトウェアサプライチェーン署名を実現します。
コード署名のための無料で使える CA
Fulcio は、メールアドレスなどの OpenID Connect (OIDC) アイデンティティに対してコード署名証明書を発行する、無料で使える認証局です。
Fulcio は 10 分間有効な短命証明書のみを発行します。
Fulcio は一般提供 (General Availability) 段階にあり、99.5 の可用性 SLO を提供しており、API の安定性については semver ルールに従っています。
Fulcio パブリックインスタンスの稼働状況データについては、https://status.sigstore.dev を参照してください。
Fulcio の証明書チェーンは TrustBundle API から取得できます。たとえばパブリックインスタンスの場合 (https://fulcio.sigstore.dev) です。パブリックインスタンスを検証するには、sigstore/root-signing リポジトリにある Sigstore の TUF ルートを使用してチェーンを検証する必要があります。
これを行うには、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
TUFクライアントを、先に取得したルートとリモートリポジトリ https://tuf-repo-cdn.sigstore.dev で初期化し、
現在の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 のリリースアーティファクト署名キー (cosign を使用した artifact.pub) のいずれかを使用して検証できます。
以下のコマンドでは、<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は発行した証明書をCertificate Transparencyログ(CTログ)に公開します。ログはhttps://ctfe.sigstore.dev/testでホストされています。毎年、ログは新しいログIDに更新されます。例えばhttps://ctfe.sigstore.dev/2022です。
このログはRFC 6962で文書化されたAPIを提供します。
監査者がこのログを監視して、整合性と特定のIDの両方を確認することを推奨します。例えば、監査者は特定のメールアドレスに対して証明書が発行された時点を監視でき、これにより設定ミスやユーザーIDの潜在的な侵害を検出できます。
脆弱性を発見した場合は、sigstoreのセキュリティプロセスに従って報告してください。
Fulcioはsigstoreプロジェクトの一環として開発されています。
また、Slackチャンネルも利用しています! Slackやその他のコミュニケーションチャンネルの詳細については、コミュニティリポジトリをご確認ください。
このREADMEファイルに加えて、docsフォルダには追加のドキュメントが含まれています:
これらの項目のいずれかに変更を加える場合は、上記の該当するファイルも必ず編集してください。