
Журнал прозрачности цепочки поставок программного обеспечения
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 официально имеет статус Generally Available с выпуском 1.0.0 и следует правилам semver для стабильности API. Это означает, что производственные нагрузки могут полагаться на публичный экземпляр Rekor, который поддерживается круглосуточной дежурной сменой и предлагает SLO доступности 99,5% для следующих конечных точек API:
/api/v1/log/api/v1/log/publicKey/api/v1/log/proof/api/v1/log/entries/api/v1/log/entries/retrieveДанные о времени безотказной работы публичного экземпляра Rekor см. на https://status.sigstore.dev.
Более подробную информацию о публичном экземпляре можно найти на docs.sigstore.dev.
Ограничение размера аттестации для загрузки в публичный экземпляр составляет 100KB. Если вам нужно загружать файлы большего размера, запустите собственный экземпляр Rekor. Инструкции по этому можно найти в документации по установке.
Подробности о том, как установить CLI rekor и настроить / запустить сервер rekor, см. на странице установки.
Примеры загрузки подписей для всех поддерживаемых типов в rekor см. в документации по типам.
Начиная с Rekor v1.6.0, релизные бинарные файлы и образы контейнеров можно проверять с помощью GitHub Artifact Attestations (gh CLI) или ключа подписи релизных артефактов Sigstore (artifact.pub с cosign).
В приведённых ниже командах замените <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)Получите artifact.pub из sigstore/root-signing или с помощью CLI-инструментов 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
Проверка релизного бинарного файла:
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, в этой папке содержится дополнительная документация: