
Git diff для SBOM — сравнивайте документы CycloneDX, SPDX и Syft, обнаруживайте подделку и контролируйте CI.
git diff для вашего SBOM. Сравните два Software Bill of Materials и увидите, что изменилось между сборками, версиями и релизами.
sbomlyze сравнивает хеши компонентов, а не только строки версий. Когда злоумышленник подменяет пакет, не меняя его версию, sbomlyze это обнаруживает. Генераторы и сканеры уязвимостей этого не замечают.
[![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]
Узнайте, чем этот сигнал отличается от diff манифеста или обычного diff компонентов, в разделе Manifest diff vs. SBOM diff vs. integrity drift.
Генераторы создают SBOM, а сканеры находят CVE. sbomlyze сообщает, что изменилось между двумя SBOM и можно ли этому доверять. Запускайте его после вашего генератора:
syft image:tag -o cyclonedx-json | sbomlyze - --complianceанализирует и оценивает сгенерированный SBOM без временного файла. Сравните его с базовым уровнем, чтобы классифицировать дрейф и настроить контроль в вашем конвейере.
Добавьте [SBOMlyze Diff из GitHub Marketplace][marketplace], чтобы сравнить SBOM, хранящийся в репозитории
или сгенерированный отдельно, с его git-базой. Неизменяемый SHA ниже —
это опубликованный Action v0.5.1:
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
Действие по умолчанию записывает сводку задания и может применять политику, сообщать о дрейфе целостности, загружать SARIF или поддерживать единый комментарий к pull-запросу. См. полный справочник по Action для входных и выходных данных, разрешений и рекомендаций по безопасности. См. репозиторий с живой демонстрацией для проходящего обновления зависимости и заблокированного изменения хеша при той же версии, с публичными запусками workflow и доказательствами SARIF.
Для dogfooding по конкретным форматам используйте публичные примеры Go + SPDX, Node + CycloneDX или container. Каждый содержит пять воспроизводимых сценариев проверки. 10-минутное руководство по бета-версии собирает четыре сфокусированных вопроса об активации и качестве сигналов.
Сгенерированные SBOM не нужно коммитить: baseline: workflow-artifact
извлекает самый последний подходящий артефакт из успешного запуска в ветке по умолчанию.
Закреплённый сопутствующий workflow Syft
показывает генерацию и публикацию базовой линии, при этом SBOMlyze остаётся ответственным
за проверку и политику.
Многие инструменты генерируют SBOM. Немногие их сравнивают, и ещё меньше сообщают, является ли изменение рутинным или сигналом риска в цепочке поставок. sbomlyze заполняет этот пробел.
| Возможность | sbomlyze | cyclonedx-cli | sbomqs | syft / trivy |
|---|---|---|---|---|
| Diff SBOM-to-SBOM | ✅ | базовый | ❌ | ❌ |
| Дрейф целостности / подмены (хеш изменён без версии) | ✅ | ❌ | ❌ | ❌ |
| Diff графа зависимостей + риск транзитивной глубины | ✅ | ❌ | ❌ | ❌ |
| Оценка соответствия NTIA / CISA / BSI | ✅ | ❌ | ✅ | ❌ |
| Конвертация форматов (Syft / CycloneDX / SPDX) | ✅ | ✅ | ❌ | частично |
| Проводники TUI + Web UI | ✅ | ❌ | ❌ | ❌ |
| Политический шлюз + SARIF / JUnit / Markdown / HTML / Patch | ✅ | частично | частично | частично |
brew install rezmoss/sbomlyze/sbomlyze
Скрипт установки загружает правильный бинарный файл для вашей ОС/архитектуры:
# 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
Параметры установщика:
| Параметр | Описание |
|---|---|
-b <dir> | Каталог установки (по умолчанию: ./bin) |
-d | Включить отладочный вывод |
-v <ver> | Установить конкретную версию (по умолчанию: последняя) |
Установщик всегда проверяет контрольную сумму релиза. Если установлен совместимый GitHub CLI, он также проверяет происхождение сборки релиза и завершается с ошибкой, если эта проверка не удалась.
go install github.com/rezmoss/sbomlyze/cmd/sbomlyze@latest
Скачайте последний бинарный файл со страницы GitHub Releases.
Начиная с v0.3.7, релизные архивы публикуются с аттестациями артефактов GitHub. Проверьте загрузку независимо с помощью:
gh attestation verify ./sbomlyze_0.4.0_Linux_x86_64.tar.gz \
--repo rezmoss/sbomlyze \
--signer-workflow rezmoss/sbomlyze/.github/workflows/release.yml
Инструкции для неподписанных репозиториев apt, rpm и apk были удалены до тех пор, пока репозитории не будут поддерживать проверку подписей, встроенную в менеджеры пакетов.
Пользователям macOS: Удалите флаг карантина после загрузки:
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