
Git diff para SBOMs—compare documentos CycloneDX, SPDX e Syft, detecte adulterações e sirva como gate de CI.
git diff para o seu SBOM. Compare dois Software Bills of Materials e veja o que mudou entre builds, versões e releases.
O sbomlyze compara hashes de componentes, não apenas strings de versão. Quando um atacante troca um pacote sem alterar sua versão, o sbomlyze sinaliza. Geradores e scanners de vulnerabilidade não detectam isso.
[![CI][ci-img]][ci] [![GitHub Marketplace][marketplace-img]][marketplace] [![GitHub Release][release-img]][release] [![Go Report Card][go-report-img]][go-report] [![OpenSSF Scorecard][scorecard-img]][scorecard] [![OpenSSF Best Practices][best-practices-img]][best-practices] [![License: Apache-2.0][license-img]][license] [![Downloads][download-img]][download]
Veja por que este sinal é diferente de um diff de manifesto ou de um diff comum de componentes em Manifest diff vs. SBOM diff vs. integrity drift.
Geradores produzem SBOMs e scanners encontram CVEs. O sbomlyze informa o que mudou entre dois SBOMs e se você deve confiar nisso. Execute-o após o seu gerador:
syft image:tag -o cyclonedx-json | sbomlyze - --complianceanalisa e pontua o SBOM gerado sem arquivo temporário. Compare-o com uma baseline para classificar o drift e controlar o seu pipeline.
Adicione o [SBOMlyze Diff do GitHub Marketplace][marketplace] para comparar um SBOM versionado
ou gerado separadamente com sua baseline do git. O SHA imutável abaixo é
a Action v0.5.1 publicada:
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
fetch-depth: 0
- uses: rezmoss/sbomlyze@31503690611fda8ebba4ed2bd186eda000442594 # v0.5.1
with:
sbom-path: build/sbom.cdx.json
A Action grava um Job Summary por padrão e pode impor política, relatar desvio de integridade, enviar SARIF ou manter um único comentário de pull request. Consulte a referência completa da Action para entradas, saídas, permissões e orientações de segurança. Consulte o repositório de demonstração ao vivo para uma atualização de dependência aprovada e uma alteração de hash na mesma versão bloqueada, com execuções de workflow públicas e evidências SARIF.
Para dogfood específico de formato, use o exemplo público Go + SPDX, Node + CycloneDX ou container. Cada um contém cinco cenários de revisão reproduzíveis. O guia beta de 10 minutos reúne quatro perguntas focadas sobre ativação e qualidade de sinal.
SBOMs gerados não precisam ser commitados: baseline: workflow-artifact
recupera o artefato correspondente mais recente de uma execução bem-sucedida do branch padrão.
Um workflow complementar Syft fixado
mostra a geração e a publicação de baseline enquanto o SBOMlyze permanece responsável
pela revisão e política.
Muitas ferramentas geram SBOMs. Poucas os comparam, e menos ainda informam se uma mudança é rotineira ou um alerta vermelho da cadeia de suprimentos. O sbomlyze preenche essa lacuna.
| Capacidade | sbomlyze | cyclonedx-cli | sbomqs | syft / trivy |
|---|---|---|---|---|
| diff SBOM-to-SBOM | ✅ | básico | ❌ | ❌ |
| Desvio de integridade / adulteração (hash alterado sem versão) | ✅ | ❌ | ❌ | ❌ |
| Diff do grafo de dependências + risco de profundidade transitiva | ✅ | ❌ | ❌ | ❌ |
| Pontuação de conformidade NTIA / CISA / BSI | ✅ | ❌ | ✅ | ❌ |
| Conversão de formato (Syft / CycloneDX / SPDX) | ✅ | ✅ | ❌ | parcial |
| Exploradores TUI + Web UI | ✅ | ❌ | ❌ | ❌ |
| Gate de política + SARIF / JUnit / Markdown / HTML / Patch | ✅ | parcial | parcial | parcial |
brew install rezmoss/sbomlyze/sbomlyze
O script de instalação baixa o binário correto para o seu SO/arquitetura:
# Install to ./bin
curl -sSfL https://raw.githubusercontent.com/rezmoss/sbomlyze/main/install.sh | sh
# Install to /usr/local/bin (requires sudo)
curl -sSfL https://raw.githubusercontent.com/rezmoss/sbomlyze/main/install.sh | sudo sh -s -- -b /usr/local/bin
# Install specific version
curl -sSfL https://raw.githubusercontent.com/rezmoss/sbomlyze/main/install.sh | sh -s -- -v 0.4.0
Opções do instalador:
| Opção | Descrição |
|---|---|
-b <dir> | Diretório de instalação (padrão: ./bin) |
-d | Ativar saída de depuração |
-v <ver> | Instalar versão específica (padrão: mais recente) |
O instalador sempre verifica o checksum da release. Quando um GitHub CLI compatível está instalado, ele também verifica a proveniência de build da release e falha de forma segura se essa verificação não for bem-sucedida.
go install github.com/rezmoss/sbomlyze/cmd/sbomlyze@latest
Baixe o binário mais recente em GitHub Releases.
A partir da v0.3.7, os arquivos de lançamento são publicados com atestações de artefatos do GitHub. Verifique um download de forma independente com:
gh attestation verify ./sbomlyze_0.4.0_Linux_x86_64.tar.gz \
--repo rezmoss/sbomlyze \
--signer-workflow rezmoss/sbomlyze/.github/workflows/release.yml
As instruções para repositórios apt, rpm e apk não assinados foram removidas até que os repositórios suportem verificação de assinatura nativa do gerenciador de pacotes.
Usuários de macOS: Remova o sinalizador de quarentena após o download:
xattr -d com.apple.quarantine ./sbomlyze
chmod +x ./sbomlyze
git clone https://github.com/rezmoss/sbomlyze.git
cd sbomlyze
go build -o sbomlyze ./cmd/sbomlyze