
Journal de transparence de la chaîne d'approvisionnement logicielle
Rekór - en grec « Record » (enregistrement)
Les objectifs de Rekor sont de fournir un registre immuable et résistant à la falsification des métadonnées générées au sein de la chaîne d'approvisionnement d'un projet logiciel. Rekor permettra aux mainteneurs de logiciels et aux systèmes de build d'enregistrer des métadonnées signées dans un registre immuable. D'autres parties peuvent ensuite interroger ces métadonnées afin de prendre des décisions éclairées sur la confiance et la non-répudiation du cycle de vie d'un objet. Pour plus de détails, consultez le site web de sigstore.
Le projet Rekor fournit un serveur basé sur une API RESTful pour la validation et un journal de transparence pour le stockage. Une application CLI est disponible pour créer et vérifier des entrées, interroger le journal de transparence pour obtenir une preuve d'inclusion, vérifier l'intégrité du journal de transparence ou récupérer des entrées par clé publique ou par artefact.
Rekor remplit le rôle de transparence des signatures de l'infrastructure de signature logicielle de sigstore. Cependant, Rekor peut être exécuté de manière autonome et est conçu pour être extensible afin de fonctionner avec différents schémas de manifeste et outils PKI.
Rekor v1 est en mode maintenance.
Nous développons activement une nouvelle version de Rekor conçue pour être facile à maintenir et moins coûteuse à exploiter. S'appuyant sur le développement actif de l'écosystème Certificate Transparency, Rekor v2 sera adossé à un journal basé sur des tuiles et utilisera une version modernisée de Trillian, Trillian-Tessera.
Suivez son avancement sur le dépôt rekor-tiles, et apprenez-en plus sur Rekor v2 dans la proposition et le document de conception. À l'approche d'une version V2, nous prévoyons de fusionner la base de code rekor-tiles dans ce dépôt.
Rekor est officiellement Generally Available avec une version 1.0.0, et suit les règles semver pour la stabilité de l'API. Cela signifie que les charges de travail de production peuvent s'appuyer sur l'instance publique de Rekor, qui dispose d'une rotation d'astreinte 24/7 et offre un SLO de disponibilité de 99,5 % pour les points de terminaison d'API suivants :
/api/v1/log/api/v1/log/publicKey/api/v1/log/proof/api/v1/log/entries/api/v1/log/entries/retrievePour les données de disponibilité de l'instance publique de Rekor, consultez https://status.sigstore.dev.
Plus de détails sur l'instance publique sont disponibles sur docs.sigstore.dev.
La limite de taille des attestations pour les téléversements vers l'instance publique est de 100 Ko. Si vous devez téléverser des fichiers plus volumineux, veuillez exécuter votre propre instance de Rekor. Vous trouverez les instructions pour ce faire dans la documentation d'installation.
Veuillez consulter la page d'installation pour plus de détails sur l'installation du CLI rekor et la configuration / l'exécution du serveur rekor
Pour des exemples de téléversement de signatures pour tous les types pris en charge vers rekor, consultez la documentation des types.
À partir de Rekor v1.6.0, les binaires de version et les images de conteneur peuvent être vérifiés à l'aide des attestations d'artefacts GitHub (gh CLI) ou de la clé de signature des artefacts de version de Sigstore (artifact.pub avec cosign).
Dans les commandes ci-dessous, remplacez <version> (par exemple, v1.6.0), <binary> (rekor-cli ou rekor-server), <os> (linux ou darwin) et <arch> (amd64 ou arm64) par la version de publication, le binaire et la plateforme que vous vérifiez.
gh CLI)Vérifier un binaire de version :
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
Vérifier une image de conteneur :
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)Récupérez artifact.pub depuis sigstore/root-signing ou à l'aide des outils CLI de 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
Vérifier un binaire de release :
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>"
Vérifier une image de conteneur :
cosign verify \
--key artifact.pub \
-a "GIT_VERSION=<version>" \
"ghcr.io/sigstore/rekor/<binary>:<version>"
Rekor permet des manifestes personnalisés (qu'il nomme types), la personnalisation des types est décrite ici.
Si vous souhaitez intégrer Rekor, nous disposons d'un éditeur OpenAPI swagger
Si vous découvrez un problème de sécurité, veuillez vous référer au processus de sécurité de sigstore.
Nous accueillons les contributions de toute personne et sommes particulièrement intéressés par les retours des utilisateurs de Rekor.
En plus de ce fichier README, ce dossier contient la documentation complémentaire suivante :