
Transparenzlog für Software-Lieferketten
Rekór – griechisch für „Record“ (Aufzeichnung)
Die Ziele von Rekor sind, ein unveränderliches, manipulationssicheres Ledger von Metadaten bereitzustellen, die innerhalb der Lieferkette eines Softwareprojekts erzeugt werden. Rekor ermöglicht es Software-Maintainern und Build-Systemen, signierte Metadaten in einem unveränderlichen Datensatz zu erfassen. Andere Parteien können diese Metadaten dann abfragen, um fundierte Entscheidungen über Vertrauen und Nichtabstreitbarkeit des Lebenszyklus eines Objekts treffen zu können. Weitere Details finden Sie auf der sigstore-Website.
Das Rekor-Projekt stellt einen RESTful-API-basierten Server zur Validierung und ein Transparenz-Log zur Speicherung bereit. Eine CLI-Anwendung ist verfügbar, um Einträge zu erstellen und zu verifizieren, das Transparenz-Log auf Einschlussnachweise abzufragen, die Integrität des Transparenz-Logs zu verifizieren oder Einträge entweder über den öffentlichen Schlüssel oder das Artefakt abzurufen.
Rekor erfüllt die Rolle der Signaturtransparenz in der Software-Signierungsinfrastruktur von sigstore. Rekor kann jedoch eigenständig betrieben werden und ist darauf ausgelegt, sich für die Arbeit mit verschiedenen Manifest-Schemas und PKI-Tools erweitern zu lassen.
Rekor v1 befindet sich im Wartungsmodus.
Wir entwickeln aktiv eine neue Version von Rekor, die einfach zu warten und kostengünstiger zu betreiben sein soll. Aufbauend auf der aktiven Entwicklung im Certificate-Transparency-Ökosystem wird Rekor v2 auf einem tile-basierten Log basieren und eine modernisierte Version von Trillian verwenden, Trillian-Tessera.
Verfolgen Sie den Fortschritt im rekor-tiles-Repo und erfahren Sie mehr über Rekor v2 im Proposal und im Design-Dokument. Wenn wir uns einer V2-Version nähern, planen wir, die rekor-tiles-Codebasis in dieses Repository zu integrieren.
Rekor ist offiziell Generally Available mit einem 1.0.0-Release und folgt den Semver-Regeln für API-Stabilität. Das bedeutet, dass Produktions-Workloads sich auf die öffentliche Rekor-Instanz verlassen können, die durch eine 24/7-Bereitschaftsrotation unterstützt wird und ein Verfügbarkeits-SLO von 99,5 % für die folgenden API-Endpunkte bietet:
/api/v1/log/api/v1/log/publicKey/api/v1/log/proof/api/v1/log/entries/api/v1/log/entries/retrieveUptime-Daten zur öffentlichen Rekor-Instanz finden Sie unter https://status.sigstore.dev.
Weitere Details zur öffentlichen Instanz finden Sie unter docs.sigstore.dev.
Das Größenlimit für Attestierungen bei Uploads zur öffentlichen Instanz beträgt 100KB. Wenn Sie größere Dateien hochladen müssen, betreiben Sie bitte Ihre eigene Rekor-Instanz. Anleitungen dazu finden Sie in der Installationsdokumentation.
Details zur Installation der rekor-CLI sowie zur Einrichtung und zum Betrieb des rekor-Servers finden Sie auf der Installationsseite.
Beispiele für das Hochladen von Signaturen aller unterstützten Typen zu rekor finden Sie in der Typendokumentation.
Beginnend mit Rekor v1.6.0 können Release-Binärdateien und Container-Images entweder über GitHub Artifact Attestations (gh CLI) oder über den Release-Artefakt-Signaturschlüssel von Sigstore (artifact.pub mit cosign) verifiziert werden.
Ersetzen Sie in den folgenden Befehlen <version> (z. B. v1.6.0), <binary> (rekor-cli oder rekor-server), <os> (linux oder darwin) und <arch> (amd64 oder arm64) durch die Release-Version, die Binärdatei und die Plattform, die Sie verifizieren.
gh CLI)Verifizieren einer Release-Binärdatei:
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
Verify a container image:
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)Rufen Sie artifact.pub aus sigstore/root-signing oder über die CLI-Tools von go-tuf ab:
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
Verify a release binary:
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>"
Verify a container image:
cosign verify \
--key artifact.pub \
-a "GIT_VERSION=<version>" \
"ghcr.io/sigstore/rekor/<binary>:<version>"
Rekor ermöglicht benutzerdefinierte Manifeste (die als Typen bezeichnet werden), die Typanpassung wird hier beschrieben.
Wenn Sie an einer Integration mit Rekor interessiert sind, steht Ihnen ein OpenAPI-Swagger-Editor zur Verfügung.
Sollten Sie Sicherheitsprobleme entdecken, lesen Sie bitte den Sicherheitsprozess von sigstore.
Wir freuen uns über Beiträge von allen und sind besonders daran interessiert, von Rekor-Nutzern zu hören.
Neben dieser README-Datei enthält dieser Ordner die folgende zusätzliche Dokumentation: