
Registro de Transparência da Cadeia de Suprimentos de Software
Rekór - Grego para "Registro"
Os objetivos do Rekor são fornecer um registro imutável e resistente a adulterações de metadados gerados dentro da cadeia de suprimentos de um projeto de software. O Rekor permitirá que mantenedores de software e sistemas de build registrem metadados assinados em um registro imutável. Outras partes podem então consultar esses metadados para tomar decisões informadas sobre confiança e não repúdio do ciclo de vida de um objeto. Para mais detalhes, visite o site do sigstore.
O projeto Rekor fornece um servidor baseado em API RESTful para validação e um log de transparência para armazenamento. Uma aplicação CLI está disponível para criar e verificar entradas, consultar o log de transparência para prova de inclusão, verificação de integridade do log de transparência ou recuperação de entradas por chave pública ou artefato.
O Rekor cumpre o papel de transparência de assinaturas da infraestrutura de assinatura de software do sigstore. No entanto, o Rekor pode ser executado de forma independente e foi projetado para ser extensível ao trabalhar com diferentes esquemas de manifesto e ferramentas de PKI.
O Rekor v1 está em modo de manutenção.
Estamos desenvolvendo ativamente uma nova versão do Rekor projetada para ser fácil de manter e mais barata de operar. Baseando-se no desenvolvimento ativo no ecossistema de Certificate Transparency, o Rekor v2 será suportado por um log baseado em tiles e usará uma versão modernizada do Trillian, o Trillian-Tessera.
Acompanhe seu progresso no repositório rekor-tiles e saiba mais sobre o Rekor v2 na proposta e no documento de design. À medida que nos aproximamos do lançamento da V2, planejamos mesclar o código do rekor-tiles neste repositório.
O Rekor está oficialmente Generally Available com um lançamento 1.0.0 e segue as regras do semver para estabilidade da API. Isso significa que cargas de trabalho em produção podem contar com a instância pública do Rekor, que possui uma rotação de plantão 24/7 que a suporta e oferece um SLO de disponibilidade de 99,5% para os seguintes endpoints de API:
/api/v1/log/api/v1/log/publicKey/api/v1/log/proof/api/v1/log/entries/api/v1/log/entries/retrievePara dados de uptime da instância pública do Rekor, consulte https://status.sigstore.dev.
Mais detalhes sobre a instância pública podem ser encontrados em docs.sigstore.dev.
O limite de tamanho de atestação para uploads na instância pública é de 100KB. Se você precisar enviar arquivos maiores, execute sua própria instância do Rekor. Você pode encontrar instruções para isso na documentação de instalação.
Consulte a página de instalação para detalhes sobre como instalar a CLI do rekor e configurar / executar o servidor rekor
Para exemplos de upload de assinaturas para todos os tipos suportados no rekor, consulte a documentação de tipos.
A partir do Rekor v1.6.0, os binários de lançamento e as imagens de contêiner podem ser verificados usando GitHub Artifact Attestations (gh CLI) ou a chave de assinatura de artefatos de lançamento do Sigstore (artifact.pub com cosign).
Nos comandos abaixo, substitua <version> (por exemplo, v1.6.0), <binary> (rekor-cli ou rekor-server), <os> (linux ou darwin) e <arch> (amd64 ou arm64) pela versão de lançamento, binário e plataforma que você está verificando.
gh CLI)Verifique um binário de lançamento:
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
Verifique uma imagem de contêiner:
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)Recupere artifact.pub de sigstore/root-signing ou usando as ferramentas CLI do 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
Verifique um binário 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>"
Verifique uma imagem de contêiner:
cosign verify \
--key artifact.pub \
-a "GIT_VERSION=<version>" \
"ghcr.io/sigstore/rekor/<binary>:<version>"
O Rekor permite manifestos personalizados (que ele denomina tipos), a personalização de tipos está descrita aqui.
Se você tiver interesse em integrar com o Rekor, temos um editor OpenAPI swagger
Caso você descubra algum problema de segurança, consulte o processo de segurança do sigstore
Acolhemos contribuições de qualquer pessoa e temos especial interesse em ouvir os usuários do Rekor.
Além deste arquivo README, esta pasta contém a documentação adicional: