CycloneDX SBOM standardı
Son güncelleme
CycloneDX, malzeme listeleri için OWASP standardıdır ve ECMA-424 olarak da yayımlanmıştır. Bir CycloneDX dosyasının neleri içerdiği ve AI CodeOps'un onları nasıl kaydedip okuduğu.
CycloneDX, OWASP topluluğunda oluşturulmuş ve Ecma International tarafından ECMA-424 olarak da yayımlanmış, malzeme listeleri için açık bir standarttır. Bir CycloneDX belgesi, bir yazılımdaki bileşenleri sürümleri, tanımlayıcıları, lisansları ve ilişkileriyle birlikte JSON, XML veya Protocol Buffers biçiminde listeler.
Nedir
CycloneDX bir yazılım malzeme listesi (SBOM) biçimi olarak başlamış ve hizmetler için SaaSBOM, donanım için HBOM gibi başka envanterleri de kapsayacak şekilde genişlemiştir. Güvenlik açığı bilgisi de taşıyabilir; bu da onu VEX (bilinen bir güvenlik açığının bir ürünü gerçekten etkileyip etkilemediğine dair beyanlar) için kullanılabilir kılar.
En küçük CycloneDX JSON SBOM'u şöyle görünür:
{
"bomFormat": "CycloneDX",
"specVersion": "1.5",
"metadata": { "component": { "name": "checkout", "version": "2.4.0" } },
"components": [
{
"type": "library",
"name": "express",
"version": "4.19.2",
"purl": "pkg:npm/[email protected]",
"licenses": [{ "license": { "id": "MIT" } }]
}
]
}
bomFormat ve specVersion belgeyi tanımlar. Her bileşenin bir tipi, bir adı ve sürümü, genellikle de bir paket URL'si (purl) ve SPDX lisans listesinden lisans kimlikleri vardır.
Neden önemlidir
Standart bir biçim, build aracınızın yazdığı SBOM'un güvenlik açığı tarayıcınız, lisans denetleyiciniz ve müşterilerinizin araçları tarafından dönüştürme gerekmeden okunabilmesi demektir. Yaygın ekosistemlerdeki SBOM üreticilerinin çoğu CycloneDX yazabilir.
AI CodeOps'ta
AI CodeOps, CycloneDX'i iki yerde kullanır.
SBOM kayıtları. Bir projenin SBOM'unu kaydettiğinizde format değeri cyclonedx (veya spdx), formatVersion değeri ise belgenin specVersion değeridir. Ayrıca, dosyanın licenses girdilerinden oluşturduğunuz, lisans başına bileşen sayısını veren bir licenseSummary gönderirsiniz:
{ "format": "cyclonedx", "formatVersion": "1.5", "licenseSummary": { "MIT": 301, "Apache-2.0": 74 } }
Yayın kontrolünün lisans politikası bu özeti okur. AI CodeOps kayıt sırasında dosyayı ayrıştırmaz; bu yüzden özeti, SHA-256 değerini kaydettiğiniz dosyanın aynısından oluşturun. İsteğin tamamı Güvenlik ve SBOM sayfasındadır.
SBOM görüntüleyicisi. Ücretsiz SBOM görüntüleyicisi, bir CycloneDX JSON dosyasını tarayıcınızda açar. "bomFormat": "CycloneDX" değerini kontrol eder; spesifikasyon sürümünü, metadata.component alanındaki konuyu ve bileşen sayısını gösterir ve her bileşeni (iç içe olanlar dahil) sürümü, tipi, lisansları ve purl değeriyle listeler. Listeyi metne göre filtreleyebilirsiniz. SPDX dosyaları görüntüleyicide henüz desteklenmez.
İlgili terimler
- SBOM: CycloneDX'in tanımladığı envanter.
- Yazılım bileşen analizi (SCA): CycloneDX dosyalarını genellikle yazan araçlar.
- Lisans politikası: bir CycloneDX dosyasının listelediği lisanslara karşı kontrol edilen kurallar.
Sık sorulan sorular
CycloneDX, SPDX'ten daha mı iyidir?
Genel olarak hiçbiri daha iyi değildir. İkisi de bileşenleri ve lisansları tanımlar. CycloneDX güvenlik kullanım senaryolarından, SPDX ise lisans uyumluluğundan doğmuştur. AI CodeOps ikisini de kaydeder.
AI CodeOps SBOM görüntüleyicisi dosyamı yükler mi?
Hayır. CycloneDX JSON dosyasını tarayıcınızda ayrıştırır ve hiçbir yere göndermez.
Bir SBOM kaydettiğimde AI CodeOps CycloneDX dosyasını okur mu?
Hayır. Gönderdiğiniz değerleri, bir SHA-256 özetini ve dosyaya bir bağlantıyı saklar. Lisans özeti sizden gelir.