AI CodeOps

SBOM nedir? İçeriği, türleri ve nasıl kullanılır

Son güncelleme

Yazılım malzeme listesi ayrıntılı olarak: içinde neler olduğu, bileşen tanımlayıcıları, tasarımdan çalışma zamanına SBOM türleri, nasıl üretileceği ve VEX'in nereye oturduğu.

Yazılım malzeme listesi (SBOM), bir yazılımı oluşturan bileşenlerin makine tarafından okunabilir bir envanteridir: her kütüphane, paket veya modül; sürümü, tedarikçisi, tanımlayıcıları, lisansı ve diğerleriyle ilişkileriyle birlikte. Fiziksel bir ürün için bir üreticinin malzeme listesi gibi, ürünü sökmeden içinde ne olduğunu yanıtlamanızı sağlar. Değeri onunla yaptıklarınızdan gelir: bir güvenlik açığı duyurulduğunda etkilenen yazılımı dakikalar içinde bulmak, her değişiklikte lisansları kontrol etmek ve müşterilere ve denetçilere neyi yayına aldığınızı göstermek.

Bu sayfa, Yazılım tedarik zinciri güvenliği nedir? rehberinin SBOM bölümünü daha ayrıntılı ele alır.

Bir SBOM'da neler bulunur

2021'de ABD National Telecommunications and Information Administration (NTIA), SBOM için asgari unsurları yayımladı. Bunlar üç gruba ayrılır.

Her bileşen için veri alanları: tedarikçi adı, bileşen adı, sürüm, diğer benzersiz tanımlayıcılar, bağımlılık ilişkisi, SBOM verisinin yazarı ve bir zaman damgası.

Otomasyon desteği: SBOM, araçların üretip kullanabileceği makine tarafından okunabilir bir biçimdedir. NTIA; SPDX, CycloneDX ve SWID etiketlerini adlandırdı.

Uygulamalar ve süreçler: bir SBOM'un ne zaman üretileceği (her yeni build veya sürümde), ne kadar derine indiği (en azından üst düzey bileşenler, geçişli olanları bulmaya yetecek ayrıntıyla), bağımlılık ağacının eksik olduğu yerlerde "bilinen bilinmeyenlerin" nasıl kaydedileceği, nasıl dağıtıldığı ve kimin erişebileceği ve hataların nasıl düzeltileceği.

Çoğu üretici asgarinin ötesine geçer: lisans verileri, dosya özetleri, SBOM'u üreten araç ve bazen güvenlik açığı referansları.

Bileşen tanımlayıcıları

Bir SBOM ancak tanımlayıcıları kadar faydalıdır. "openssl, sürüm 3" ifadesini herhangi bir şeyle eşleştirmek zordur; kesin bir tanımlayıcı ise güvenlik açığı veritabanları ve lisans listeleriyle otomatik olarak eşleştirilebilir.

  • Paket URL'si (purl). Bir paketi kendi ekosistemi içinde adlandıran bir dize; örneğin pkg:npm/[email protected] veya pkg:pypi/[email protected]. Açık kaynak araçlar tarafından yaygın olarak kullanılır.
  • CPE (Common Platform Enumeration). ABD National Vulnerability Database'in bir güvenlik açığının hangi ürünleri etkilediğini belirtmek için kullandığı bir adlandırma şeması.
  • Özetler (hash). Dosyaların veya paketlerin kriptografik özetleri; adından bağımsız olarak tam bir yapıtı tanımlar.

purl'ü ve özeti olan bir bileşen güvenilir şekilde eşleştirilebilir. Yalnızca adı ve sürümü olan bir bileşen çoğu zaman eşleştirilemez.

Bir SBOM neye benzer

Tek bir uygulamaya ve tek bir bağımlılığa kısaltılmış, JSON biçiminde en küçük bir CycloneDX SBOM'u:

{
  "bomFormat": "CycloneDX",
  "specVersion": "1.5",
  "version": 1,
  "metadata": {
    "timestamp": "2026-10-21T09:30:00Z",
    "component": { "type": "application", "name": "checkout", "version": "2.4.0", "bom-ref": "checkout" }
  },
  "components": [
    {
      "type": "library",
      "bom-ref": "pkg:npm/[email protected]",
      "name": "lodash",
      "version": "4.17.21",
      "purl": "pkg:npm/[email protected]",
      "licenses": [{ "license": { "id": "MIT" } }]
    }
  ],
  "dependencies": [{ "ref": "checkout", "dependsOn": ["pkg:npm/[email protected]"] }]
}

metadata bloğu, SBOM'un neyle ilgili olduğunu ve ne zaman oluşturulduğunu tarif eder. components içindeki her girdi, tanımlayıcıları ve lisansıyla bir bileşendir. dependencies bloğu hangi bileşenin hangisine bağımlı olduğunu kaydeder; böylece ağaç yeniden oluşturulabilir. SPDX aynı bilgiyi farklı bir yapı ve adlarla kaydeder. İki biçimin karşılaştırması için bkz. CycloneDX ve SPDX.

SBOM türleri: yaşam döngüsünün hangi noktasında oluşturulduğu

Bir tasarım belgesinden oluşturulan bir SBOM, çalışan bir container'dan oluşturulandan farklı bir şey söyler. CISA'nın 2023 tarihli Types of Software Bill of Material (SBOM) Documents belgesi altı tür sayar:

TürNeyden oluşturulurSize ne söyler
Tasarım (Design)Yazılım var olmadan önceki planlar veya gereksinimlerNeyin dahil edilmesinin amaçlandığı
Kaynak (Source)Kaynak repo ve manifest'leriKodun neye bağımlı olduğunu beyan ettiği
BuildÇözümlenmiş bağımlılıklardan build süreciBelirli bir build'e neyin girdiği
Analiz (Analyzed)Bir imaj gibi derlenmiş bir yapıtın incelenmesiBir tarayıcının yapıtta ne bulduğu
Dağıtılmış (Deployed)Bir ortamda kurulu hâliyle yazılımYapılandırma dahil, çalıştığı yerde neyin bulunduğu
Çalışma zamanı (Runtime)Çalışan sistemin gözlemlenmesiGerçekte neyin yüklendiği ve çalıştırıldığı

Güvenlik açığına müdahale ve lisans kontrolleri için en faydalı başlangıç noktası genellikle bir build SBOM'udur: gerçekten yayına aldığınız bir yapıt için, geçişli bağımlılıklar dahil çözümlenmiş sürümleri yansıtır.

SBOM'lar nasıl üretilir

SBOM'lar elle yazılmaz, araçlarla üretilir. Üreticiler lockfile'ları ve manifest'leri okur, derlenmiş yapıtları veya container imajlarını inceler ya da build'in kendisine bağlanır. Açık kaynak örnekleri arasında Syft, Trivy ve cdxgen bulunur ve birçok build ekosisteminin kendi eklentileri vardır.

Güvenebileceğiniz bir SBOM elde etmek için:

  • Onu CI'da, build'den üretin. Bu, onu bir yapıta ve bir commit'e bağlar ve insanların unuttuğu adımı ortadan kaldırır.
  • Çözümlenmiş sürümleri kullanın. Sürüm aralıkları içeren bir manifest neye izin verildiğini söyler; bir lockfile veya derlenmiş yapıt ise neyin kullanıldığını söyler.
  • Geçişli bağımlılıkları dahil edin ve ağacın eksik olduğu yerleri kaydedin.
  • Onu bir özetle birlikte sürümle saklayın; böylece belirli bir zamanda çalışan şeyin SBOM'una ulaşabilirsiniz.
  • Kontrol edin. Birkaç SBOM açın ve bileşenlerin, sürümlerin ve lisansların doğru göründüğünü teyit edin. Yanlış dizin için yapılandırılmış bir üretici geçerli ama neredeyse boş bir SBOM üretir.

Bir SBOM'u kullanmak

  • Güvenlik açığına müdahale. Bileşen tanımlayıcılarını güvenlik bildirimleriyle eşleştirin. Yeni bir güvenlik açığı duyurulduğunda her repo yerine sakladığınız SBOM'larda arama yapın.
  • Lisans uyumluluğu. Bileşenler genelindeki lisansları toplayın ve yalnızca yayında değil, her değişiklikte politikanızla karşılaştırın.
  • Envanter ve kullanım ömrü sonu takibi. Bakımı yapılmayan veya destek tarihi geçmiş bileşenleri bulun.
  • Müşteri ve düzenleyici talepleri. ABD'de 14028 sayılı Başkanlık Kararnamesi SBOM'ları federal yazılım alımlarına taşıdı. AB'de Siber Dayanıklılık Yasası, dijital unsurlu ürün üreticilerinin teknik dokümantasyonlarının parçası olarak en azından üst düzey bağımlılıkları kapsayan bir SBOM hazırlamasını gerektirir.

SBOM'lar ve VEX

Bir SBOM neyin bulunduğunu söyler. Onu güvenlik bildirimleriyle eşleştiren bir güvenlik açığı tarayıcısı, güvenlik açığı içeren kodun hiç çağrılmadığı bileşenler dahil, bilinen bir güvenlik açığı olan her bileşeni işaretler. VEX (Vulnerability Exploitability eXchange), tedarikçinin her duruma dair değerlendirmesini not affected, affected, fixed ve under investigation gibi durumlarla ve "not affected" için, örneğin güvenlik açığı içeren kodun bulunmadığı veya ulaşılamadığı gibi bir gerekçeyle kaydeder.

VEX; CycloneDX ile, CSAF biçiminde veya OpenVEX belgeleri olarak yayımlanabilir. Bir SBOM ve VEX beyanları birlikte, bir müşterinin hangi tarayıcı sonuçlarının eylem gerektirdiğini ayırt etmesini sağlar.

AI CodeOps bunu nasıl yapar

AI CodeOps, SBOM'ları proje başına CycloneDX veya SPDX biçiminde izler. Onları üretmez: SBOM'u her zamanki aracınızla oluşturur, dosyayı build yapıtlarınızla birlikte tutar ve biçimi, commit'i, özeti, indirme bağlantısı, bileşen sayısı ve lisans özetiyle bir anlık görüntü kaydedersiniz. Açık betada bir anlık görüntü, giriş yapılmış bir oturumdan /api/sbom uç noktasına gönderilen bir istekle kaydedilir; CI'dan bir API anahtarıyla kayıt henüz kullanılamaz.

CI'ınızın çağırdığı yayın kontrolü, projenin en son SBOM'u izin vermediğiniz bir lisans içerdiğinde bir değişikliği reddedebilir ve bir lisans kuralı ayarlıyken projenin SBOM'u yoksa onu reddeder. SBOM'lar Secure → Security altında ve her projenin sayfasında görünür.

Ayrıntılar için Güvenlik ve SBOM sayfasına, SBOM sözlük maddesine ve bir CycloneDX JSON dosyasını yüklemeden tarayıcınızda açan ücretsiz SBOM görüntüleyicisine bakın.

Sık sorulan sorular

SBOM ile lockfile arasındaki fark nedir?

Bir lockfile, build'ler tekrarlanabilir olsun diye tek bir paket yöneticisi için bağımlılık sürümlerini sabitler. Bir SBOM ise yayına çıkan yazılımın tüm bileşenlerini tanımlayıcılar, lisanslar ve ilişkilerle birlikte standart bir biçimde tarif eder; böylece başka araçlar ve başka kuruluşlar onu okuyabilir.

Bir SBOM geçişli bağımlılıkları içerir mi?

İyi bir SBOM içerir. Bileşenlerin çoğu bağımlılıklarınızın bağımlılıklarından gelir ve birçok güvenlik açığı orada bulunur. Üreticinizin ayarlarını kontrol edin ve derinlik eksik olduğunda bunu kaydedin.

Ne sıklıkla SBOM üretmeliyim?

En azından her sürüm için ve ideal olarak dağıtılabilecek her build için. Bir SBOM yazılımın tek bir sürümünü tarif eder; bu yüzden farklı bağımlılıklara sahip yeni bir build yeni bir SBOM gerektirir.

SBOM'ları müşterilerle paylaşmalı mıyım?

Birçok müşteri ve düzenleyici artık onları istiyor. Bir SBOM tam olarak hangi bileşenleri ve sürümleri çalıştırdığınızı gösterdiği için, onları kimin ve nasıl alabileceğine karar verin.

VEX nedir?

Vulnerability Exploitability eXchange, bilinen bir güvenlik açığının bir ürünü gerçekten etkileyip etkilemediğine dair, not affected, affected, fixed veya under investigation gibi bir durum içeren bir beyandır. Tarayıcılardan gelen gürültüyü azaltmak için bir SBOM ile birlikte dolaşır.