Voltar às atualizações
New releaseAug 4, 2026

sbomlyze v0.3.6

Git diff para SBOMs—compare documentos CycloneDX, SPDX e Syft, detecte adulterações e sirva como gate de CI.

Compartilhar

sbomlyze

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]

SBOMlyze bloqueia uma alteração de hash na mesma versão em um pull request real

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 - --compliance analisa e pontua o SBOM gerado sem arquivo temporário. Compare-o com uma baseline para classificar o drift e controlar o seu pipeline.

Início rápido com GitHub Action

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.

Por que sbomlyze?

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.

Capacidadesbomlyzecyclonedx-clisbomqssyft / 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✅parcialparcialparcial

Recursos

  • Diff de SBOM: Compare dois SBOMs e veja componentes adicionados, removidos e alterados rapidamente
  • Classificação de desvio: Distinga desvio de versão de desvio de integridade (um hash alterado sem mudança de versão, sinalizando adulteração) e desvio de metadados
  • Pontuação de conformidade: Pontue qualquer SBOM em relação aos elementos mínimos NTIA, CISA 2025 e BSI TR-03183
  • Diff do grafo de dependências: Acompanhe dependências transitivas e profundidade da cadeia de suprimentos
  • Suporte a múltiplos formatos: Syft, CycloneDX, SPDX (JSON)
  • Conversão de formato: Converta entre os formatos CycloneDX, SPDX e Syft
  • Correspondência de identidade robusta: precedência PURL → CPE → BOM-ref → namespace/name
  • Modo de estatísticas: Analise SBOMs individuais para métricas de licença, dependência e integridade
  • Modo TUI interativo: Explore SBOMs com navegação por teclado e busca
  • Modo Web UI: Explorador de SBOM baseado em navegador com upload por arrastar e soltar
  • Motor de políticas: Imponha regras de desvio, licença e pontuação de conformidade em pipelines de CI
  • GitHub Marketplace Action: Bloqueie pull requests com base em desvio de SBOM com Job Summary, SARIF e saída opcional de comentário
  • Detecção de duplicatas e colisões: Encontre múltiplas versões do mesmo pacote e correspondências de identidade ambíguas
  • Múltiplos formatos de saída: Texto, JSON, SARIF, JUnit XML, Markdown, HTML, JSON Patch
  • Parsing tolerante: Continue em caso de erros com avisos estruturados

Instalação

Homebrew (macOS/Linux)

brew install rezmoss/sbomlyze/sbomlyze

Script de Instalação

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çãoDescrição
-b <dir>Diretório de instalação (padrão: ./bin)
-dAtivar 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

go install github.com/rezmoss/sbomlyze/cmd/sbomlyze@latest

A partir do Binário de Lançamento

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

Compilar a partir do código-fonte

git clone https://github.com/rezmoss/sbomlyze.git
cd sbomlyze
go build -o sbomlyze ./cmd/sbomlyze

Categorias