
Rekór - ギリシャ語で「記録」
Rekorの目標は、ソフトウェアプロジェクトのサプライチェーン内で生成されるメタデータについて、不変で改ざん耐性のある台帳を提供することです。 Rekorにより、ソフトウェアのメンテナーやビルドシステムは、署名済みメタデータを不変の記録として記録できるようになります。 その後、他の関係者はそのメタデータを照会して、オブジェクトのライフサイクルに対する信頼と否認防止について情報に基づいた意思決定を行うことができます。詳細はsigstoreのウェブサイトをご覧ください。
Rekorプロジェクトは、検証のためのRESTful APIベースのサーバーと、保存のための透明性ログを提供します。 CLIアプリケーションは、エントリの作成と検証、包含証明のための透明性ログの照会、 透明性ログの完全性検証、または公開鍵やアーティファクトによるエントリの取得に利用できます。
Rekorは、sigstoreのソフトウェア署名インフラストラクチャにおける署名の透明性の役割を果たします。 ただし、Rekorは単独で実行でき、さまざまなマニフェストスキーマやPKIツールとの連携に対応できるよう 拡張可能に設計されています。
Rekor v1はメンテナンスモードです。
私たちは、保守が容易で運用コストの低い新しいバージョンのRekorを積極的に開発しています。 Certificate Transparencyエコシステムにおける活発な開発を基盤として、Rekor v2は タイルベースのログに支えられ、Trillianの現代化されたバージョンである Trillian-Tesseraを使用します。
進捗はrekor-tilesリポジトリで追跡でき、Rekor v2の詳細は 提案書 および設計ドキュメントで確認できます。 V2リリースが近づくにつれ、rekor-tilesのコードベースをこのリポジトリに統合する予定です。
Rekorは1.0.0リリースで正式に一般提供(Generally Available)となり、APIの安定性についてsemverのルールに従います。 これにより、本番ワークロードはRekorのパブリックインスタンスに依存でき、24時間365日のオンコール体制でサポートされ、以下のAPIエンドポイントに対して99.5%の可用性SLOを提供します:
/api/v1/log/api/v1/log/publicKey/api/v1/log/proof/api/v1/log/entries/api/v1/log/entries/retrieveRekorパブリックインスタンスの稼働状況データについては、https://status.sigstore.devをご覧ください。
パブリックインスタンスの詳細はdocs.sigstore.devで確認できます。
パブリックインスタンスへのアップロードにおけるアテステーションのサイズ制限は100KBです。より大きなファイルをアップロードする必要がある場合は、独自のRekorインスタンスを実行してください。その手順についてはインストールドキュメントをご覧ください。
rekor CLIのインストール方法や、rekorサーバーのセットアップ・実行方法の詳細については、インストールページをご覧ください。
サポートされているすべての種類の署名をrekorにアップロードする例については、種類のドキュメントをご覧ください。
Rekor v1.6.0 以降、リリースバイナリとコンテナイメージは、GitHub Artifact Attestations(gh CLI)または Sigstore のリリースアーティファクト署名キー(cosign と artifact.pub)のいずれかを使用して検証できます。
以下のコマンドでは、<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 から、または go-tuf の CLI ツールを使用して artifact.pub を取得します:
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 ファイルに加えて、このフォルダには以下の追加ドキュメントが含まれています: