
Git diff for SBOMs—CycloneDX, SPDX और Syft दस्तावेज़ों की तुलना करें, छेड़छाड़ का पता लगाएँ और CI को गेट करें।
आपके SBOM के लिए git diff। दो Software Bills 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 से कैसे अलग है, यह जानने के लिए Manifest diff vs. SBOM diff vs. integrity drift देखें।
जनरेटर SBOM बनाते हैं और स्कैनर CVE खोजते हैं। sbomlyze आपको बताता है कि दो SBOM के बीच क्या बदला और क्या उस पर भरोसा करना चाहिए। इसे अपने जनरेटर के बाद चलाएँ:
syft image:tag -o cyclonedx-json | sbomlyze - --complianceबिना किसी अस्थायी फ़ाइल के जनरेट किए गए SBOM का विश्लेषण और स्कोरिंग करता है। ड्रिफ्ट को वर्गीकृत करने और अपनी पाइपलाइन को गेट करने के लिए इसकी तुलना किसी बेसलाइन से करें।
चेक-इन किए गए या अलग से जनरेट किए गए SBOM की उसके git बेसलाइन से तुलना करने के लिए [SBOMlyze Diff from GitHub Marketplace][marketplace] जोड़ें। नीचे दिया गया अपरिवर्तनीय SHA प्रकाशित v0.5.1 Action है:
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
Action डिफ़ॉल्ट रूप से एक Job Summary लिखता है और नीति लागू कर सकता है, integrity drift की रिपोर्ट कर सकता है, SARIF अपलोड कर सकता है, या एकल pull-request टिप्पणी बनाए रख सकता है। inputs, outputs, permissions, और सुरक्षा मार्गदर्शन के लिए पूर्ण Action संदर्भ देखें। एक पास होने वाले dependency update और एक अवरुद्ध same-version hash परिवर्तन के लिए, सार्वजनिक workflow runs और SARIF साक्ष्य के साथ, लाइव प्रदर्शन रिपॉज़िटरी देखें।
format-विशिष्ट dogfood के लिए, सार्वजनिक Go + SPDX, Node + CycloneDX, या container उदाहरण का उपयोग करें। प्रत्येक में पाँच पुनरुत्पादनीय समीक्षा परिदृश्य हैं। 10-मिनट बीटा गाइड चार केंद्रित सक्रियण और सिग्नल गुणवत्ता प्रश्न एकत्र करता है।
उत्पन्न SBOMs को commit करने की आवश्यकता नहीं है: baseline: workflow-artifact एक सफल default-branch run से सबसे हाल का मिलान करने वाला artifact प्राप्त करता है। एक pinned Syft companion workflow generation और baseline publication दिखाता है जबकि SBOMlyze समीक्षा और नीति के लिए जिम्मेदार बना रहता है।
कई टूल SBOMs उत्पन्न करते हैं। कुछ ही उनकी तुलना करते हैं, और उससे भी कम बताते हैं कि कोई परिवर्तन नियमित है या supply-chain red flag। sbomlyze उस अंतराल को भरता है।
| क्षमता | sbomlyze | cyclonedx-cli | sbomqs | syft / trivy |
|---|---|---|---|---|
| SBOM-to-SBOM diff | ✅ | basic | ❌ | ❌ |
| Integrity / tamper drift (hash बिना version के बदला) | ✅ | ❌ | ❌ | ❌ |
| Dependency-graph diff + transitive depth risk | ✅ | ❌ | ❌ | ❌ |
| NTIA / CISA / BSI compliance scoring | ✅ | ❌ | ✅ | ❌ |
| Format conversion (Syft / CycloneDX / SPDX) | ✅ | ✅ | ❌ | partial |
| TUI + Web UI explorers | ✅ | ❌ | ❌ | ❌ |
| Policy gate + SARIF / JUnit / Markdown / HTML / Patch | ✅ | partial | partial | partial |
brew install rezmoss/sbomlyze/sbomlyze
इंस्टॉलर स्क्रिप्ट आपके OS/आर्किटेक्चर के लिए सही बाइनरी डाउनलोड करती है:
# 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 इंस्टॉल होता है, तो यह रिलीज़ की बिल्ड प्रोवेनेंस भी सत्यापित करता है और यदि वह सत्यापन सफल नहीं होता है तो विफल-बंद (fail closed) हो जाता है।
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
Unsigned apt, rpm, और apk रिपॉज़िटरी निर्देशों को हटा दिया गया है जब तक कि रिपॉज़िटरी पैकेज-मैनेजर-मूल हस्ताक्षर सत्यापन का समर्थन न करें।
macOS उपयोगकर्ता: डाउनलोड करने के बाद quarantine फ़्लैग हटाएँ:
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
# Compare two SBOMs (the headline use case)
sbomlyze before.json after.json
# Analyze a single SBOM
sbomlyze image.json
# Read an SBOM from standard input
syft image:tag -o cyclonedx-json | sbomlyze -
# Use standard input on either side of a diff
syft image:tag -o cyclonedx-json | sbomlyze baseline.json -