
Registro de transparencia de la cadena de suministro de software
Rekór - Griego para "Registro"
Los objetivos de Rekor son proporcionar un libro mayor inmutable y resistente a la manipulación de los metadatos generados dentro de la cadena de suministro de un proyecto de software. Rekor permitirá a los mantenedores de software y a los sistemas de compilación registrar metadatos firmados en un registro inmutable. Otras partes pueden entonces consultar dichos metadatos para tomar decisiones informadas sobre la confianza y la no repudiación del ciclo de vida de un objeto. Para más detalles, visite el sitio web de sigstore.
El proyecto Rekor proporciona un servidor basado en API RESTful para la validación y un registro de transparencia para el almacenamiento. Hay disponible una aplicación CLI para crear y verificar entradas, consultar el registro de transparencia para obtener pruebas de inclusión, verificación de integridad del registro de transparencia o recuperación de entradas mediante clave pública o artefacto.
Rekor cumple el rol de transparencia de firmas de la infraestructura de firma de software de sigstore. Sin embargo, Rekor puede ejecutarse de forma independiente y está diseñado para ser extensible al trabajo con diferentes esquemas de manifiestos y herramientas de PKI.
Rekor v1 está en modo de mantenimiento.
Estamos desarrollando activamente una nueva versión de Rekor diseñada para ser fácil de mantener y más económica de operar. Basándose en el desarrollo activo en el ecosistema de Certificate Transparency, Rekor v2 estará respaldado por un registro basado en mosaicos y utilizará una versión modernizada de Trillian, Trillian-Tessera.
Siga su progreso en el repositorio rekor-tiles, y obtenga más información sobre Rekor v2 en la propuesta y el documento de diseño. A medida que nos acerquemos a una versión V2, planeamos fusionar el código base de rekor-tiles en este repositorio.
Rekor está oficialmente disponible de forma general con una versión 1.0.0, y sigue las reglas de semver para la estabilidad de la API. Esto significa que las cargas de trabajo de producción pueden confiar en la instancia pública de Rekor, que cuenta con una rotación de guardia 24/7 que la respalda y ofrece un SLO de disponibilidad del 99,5% para los siguientes endpoints de la API:
/api/v1/log/api/v1/log/publicKey/api/v1/log/proof/api/v1/log/entries/api/v1/log/entries/retrievePara datos de tiempo de actividad de la instancia pública de Rekor, consulte https://status.sigstore.dev.
Puede encontrar más detalles sobre la instancia pública en docs.sigstore.dev.
El límite de tamaño de atestación para las cargas a la instancia pública es de 100KB. Si necesita cargar archivos más grandes, ejecute su propia instancia de Rekor. Puede encontrar instrucciones para hacerlo en la documentación de instalación.
Consulte la página de instalación para obtener detalles sobre cómo instalar la CLI de rekor y configurar / ejecutar el servidor de rekor
Para ver ejemplos de carga de firmas para todos los tipos admitidos en rekor, consulte la documentación de tipos.
A partir de Rekor v1.6.0, los binarios de lanzamiento y las imágenes de contenedor se pueden verificar usando las Atestaciones de Artefactos de GitHub (CLI gh) o la clave de firma de artefactos de lanzamiento de Sigstore (artifact.pub con cosign).
En los comandos a continuación, reemplace <version> (p. ej., v1.6.0), <binary> (rekor-cli o rekor-server), <os> (linux o darwin) y <arch> (amd64 o arm64) con la versión de lanzamiento, el binario y la plataforma que está verificando.
gh)Verificar un binario de lanzamiento:
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
Verificar una imagen de contenedor:
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)Obtenga artifact.pub desde sigstore/root-signing o utilizando las herramientas 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
Verificar un binario 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>"
Verificar una imagen de contenedor:
cosign verify \
--key artifact.pub \
-a "GIT_VERSION=<version>" \
"ghcr.io/sigstore/rekor/<binary>:<version>"
Rekor permite manifiestos personalizados (a los que denomina tipos); la personalización de tipos se describe aquí.
Si te interesa la integración con Rekor, disponemos de un editor OpenAPI swagger
Si descubres algún problema de seguridad, consulta el proceso de seguridad de sigstore.
Damos la bienvenida a las contribuciones de cualquier persona y estamos especialmente interesados en conocer la opinión de los usuarios de Rekor.
Además de este archivo README, esta carpeta contiene la siguiente documentación adicional: