AI CodeOps

SLSA nedir? Build köken bilgisi ve seviyeler açıklaması

Son güncelleme

SLSA açıklaması: build track seviyeleri, bir köken bilgisi onay belgesinin neleri kaydettiği, dağıtmadan önce nasıl doğrulanacağı ve SLSA'nın sizi nelere karşı korumadığı.

SLSA (Supply-chain Levels for Software Artifacts, "salsa" diye okunur), build bütünlüğü için bir OpenSSF çerçevesidir. Bir yapıtın beklediğiniz kaynaktan, beklediğiniz build süreciyle ve yol boyunca kurcalanmadan build edildiğine dair güvence seviyeleri tanımlar. Dayandığı kanıt köken bilgisidir (provenance): daha yüksek seviyelerde build platformu tarafından imzalanan ve hangi yapıtın hangi kaynaktan, hangi builder tarafından ve hangi parametrelerle build edildiğini söyleyen bir beyan. Kullananlar bu beyanı dağıtmadan önce doğrular.

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

SLSA'nın ele aldığı sorun

Kod incelemesi kaynağı korur. Dağıttığınız yapıt incelenen kaynaktan build edilmediyse hiçbir işe yaramaz. İncelenmiş bir commit ile çalışan bir servis arasında bir build vardır: bir CI işi, script'leri, runner'ı, kimlik bilgileri, bağımlılıkları ve yayımladığı kayıt defteri. Bunlardan herhangi birini denetleyen bir saldırgan, kimsenin incelemediği bir şeyi yayına çıkarabilir.

Bu varsayımsal değildir. 2020'deki SolarWinds saldırısında kötü amaçlı kod build sırasında eklendi; bu yüzden yayına çıkan ürün kaynaktan farklıydı. SLSA'nın build gereksinimleri bu tür bir saldırıyı yapmayı zor, tespit etmeyi kolay hâle getirmeyi amaçlar.

SLSA build seviyeleri

SLSA 1.0 sürümü gereksinimlerini track'ler hâlinde düzenledi. Build track'in dört seviyesi vardır:

SeviyeGereksinimNeye karşı korur
Build L0YokHiçbir şeye; başlangıç noktası
Build L1Yapıtın nasıl build edildiğini gösteren köken bilgisi vardırResmî repoda olmayan bir commit'ten build etmek gibi sürüm hatalarına; build'leri incelenebilir kılar
Build L2Build'ler, köken bilgisini üreten ve imzalayan barındırılan bir build platformunda çalışırBuild'den sonra yapıtın veya köken bilgisinin kurcalanmasına
Build L3Build platformu sıkılaştırılmıştır: build'ler birbirinden yalıtılmıştır ve imzalama anahtarları sizin tanımladığınız build adımlarının erişiminde değildirEle geçirilmiş bir build adımı veya işi tarafından yapılanlar dahil, build sırasında kurcalamaya

Seviyeler birikimlidir. 1. seviye çoğunlukla köken bilgisine sahip olmakla ilgilidir. 2. seviye, onu sahtelemenin build platformunu ele geçirmeyi gerektirmesini sağlar. 3. seviye, tek bir build'i ele geçirmenin başka bir build için köken bilgisi sahtelemeye yetmemesini sağlar.

Spesifikasyon gelişmeye devam ediyor: güncel sürüm olan 1.2, kaynak kontrolüne ilişkin gereksinimler içeren bir Source track ekliyor. Neyin kesinleştiği için SLSA sitesindeki güncel sürümü kontrol edin.

Köken bilgisi neleri içerir

SLSA köken bilgisi genellikle bir in-toto onay belgesidir (attestation): bir veya daha fazla yapıt hakkında imzalı bir beyan. Beyan yapıtları digest değerleriyle adlandırır ve yüklemi (predicate) onların nasıl build edildiğini tarif eder. Kısaltılmış bir örnek:

{
  "_type": "https://in-toto.io/Statement/v1",
  "subject": [{ "name": "checkout-2.4.0.tar.gz", "digest": { "sha256": "…" } }],
  "predicateType": "https://slsa.dev/provenance/v1",
  "predicate": {
    "buildDefinition": {
      "buildType": "https://ci.example.com/workflow/v1",
      "externalParameters": { "repository": "https://git.example.com/acme/checkout", "ref": "refs/tags/v2.4.0" },
      "resolvedDependencies": [
        { "uri": "git+https://git.example.com/acme/checkout@refs/tags/v2.4.0", "digest": { "gitCommit": "…" } }
      ]
    },
    "runDetails": {
      "builder": { "id": "https://ci.example.com/hosted-runner" },
      "metadata": { "invocationId": "…" }
    }
  }
}

En önemli kısımlar:

  • subject: özetiyle (hash) tanımlanan yapıt. Farklı bir özete dair köken bilgisi sizin dosyanız hakkında hiçbir şey söylemez.
  • buildDefinition: kaynak repo, ref ve çözümlenen tam commit dahil, neyin ve nasıl build edildiği.
  • runDetails.builder.id: onu hangi build platformunun ürettiği. Doğrulama bunu güvendiğiniz builder'ların bir listesine karşı kontrol eder.

Beyan, genellikle bir DSSE zarfı içinde ve çoğu zaman imzayı uzun ömürlü bir anahtara değil, build iş akışının kimliğine bağlayan Sigstore ile imzalanır.

Köken bilgisini doğrulamak

Köken bilgisi ancak biri yapıt kullanılmadan önce onu kontrol ederse işe yarar. Doğrulama şunları sorar:

  1. İmza geçerli mi ve güvendiğiniz bir builder'dan mı geliyor?
  2. Subject digest değeri, dağıtmak veya yüklemek üzere olduğunuz yapıtla eşleşiyor mu?
  3. Kaynak beklediğiniz gibi mi: doğru repo ve sürüm çıkardığınız bir tag veya branch mi?
  4. Build parametreleri beklendiği gibi mi, beklenmeyen girdiler yok mu?

Bunun için SLSA projesinin doğrulayıcısı ve Sigstore'un araçları gibi araçlar vardır ve bazı ekosistemler bunu yerleşik olarak sunar. Örneğin npm, desteklenen CI sağlayıcılarından köken bilgisiyle paket yayımlayabilir ve kayıt defterleri bunu gösterebilir. Doğrulama için en değerli yer, dağıtım kapısının bir parçası olarak dağıtımdan önceki son adımdır.

SLSA'nın kapsamadıkları

SLSA build seviyeleri build'in bütünlüğüyle ilgilidir. Size şunları söylemezler:

  • kaynak kodun güvenlik açıklarından veya hatalardan arınmış olup olmadığı;
  • kötü amaçlı kodun erişimi olan biri tarafından incelenip merge edilip edilmediği;
  • kendi köken bilgilerini yayımlamadıkça bağımlılıklarınızın benzer özenle build edilip edilmediği;
  • yapıtın içinde hangi bileşenlerin bulunduğu. Bunun için SBOM vardır.

SLSA, SBOM'lar ve SSDF

BoyutSLSA köken bilgisiSBOMNIST SSDF (SP 800-218)
YanıtladığıBu yapıt nasıl ve nerede build edildi?Bu yapıtın içinde ne var?Bu kuruluş yazılımı güvenli şekilde geliştiriyor mu?
BiçimYapıt başına imzalı onay belgesiYapıt başına envanter belgesiBir uygulamalar kümesi; kuruluşlar onlara uyduklarını beyan eder
ÜretenBuild platformuİdeal olarak build içinde bir SBOM üreticisiKuruluşun süreçleri
Kontrol edenDağıtım veya yükleme öncesi doğrulayıcılarGüvenlik açığı ve lisans araçlarıMüşteriler, denetçiler ve satın alma birimleri

Birbirlerini tamamlarlar. Olgun bir sürüm üçünü de taşıyabilir: bir SBOM, imzalı köken bilgisi ve SSDF uygulamalarına uyduğunu beyan edebilen bir kuruluş.

Build pipeline'ları ve yapay zekâ ajanları

Build tanımları koddur. Bir yapay zekâ ajanının düzenlediği bir CI iş akışı dosyası, yapıtların nasıl build edildiğini, build'in hangi secret'ları kullanabileceğini ve nereye yayımladığını değiştirebilir. Build ve pipeline tanımlarındaki değişiklikleri hassas olarak ele alın: bunlar için özel bir inceleme isteyin ve kod yazan ajanları build kimlik bilgilerinden uzak tutun. Köken bilgisi olaydan sonra yardımcı olur, çünkü bir yapıtı hangi iş akışının build ettiğini kaydeder; böylece değiştirilmiş bir iş akışı köken bilgisi doğrulanırken ortaya çıkar.

Başlarken

  1. Sürüm yollarınızın envanterini çıkarın. Bir yapıtın canlı ortama veya bir kayıt defterine ulaştığı, bir dizüstü bilgisayardan yapılan manuel sürümler dahil her yolu listeleyin. Köken bilgisi yalnızca onu üreten yollar için yardımcı olur.
  2. Sürümleri yalnızca CI'da build edin. Bir geliştirici makinesinde build edilen bir yapıtın güvenilir köken bilgisi yoktur. Tüm sürüm build'lerini barındırılan bir CI hizmetine taşımak tek başına en büyük adımdır.
  3. Köken bilgisi üretimini açın. Birçok CI hizmeti ve paket kayıt defteri sizin için köken bilgisi üretip yayımlayabilir. Bu sizi 1. seviyeye ve çoğu zaman 2. seviyeye taşır.
  4. Dağıtmadan önce doğrulayın. Dağıtım pipeline'ına imzayı, builder'ı, kaynak repoyu ve yapıt digest değerini kontrol eden ve bunlardan herhangi biri eşleşmediğinde hata durumunda kapalı kalan bir doğrulama adımı ekleyin.
  5. Build'i sıkılaştırın. Build'leri yalıtın, imzalama materyalini build adımlarından uzak tutun ve build tanımlarını kimin değiştirebileceğini sınırlayın. 3. seviyeye giden yol budur.

AI CodeOps'un SLSA ile ilişkisi

AI CodeOps yapıtlarınızı build etmez veya SLSA köken bilgisi üretmez; build'i sizin kendi CI'ınız yapar ve köken bilgisi orada üretilir. AI CodeOps build'den önceki adımları kapsar: bir değişikliğin nasıl yazıldığı, incelendiği ve onaylandığı.

  • Build tanımlarını politikayla koruyun. .github/** veya .forgejo/** gibi yollarda kararı ask olan bir diff.apply kuralı, bu dosyalardaki bir değişiklik pull request'e dönüşmeden önce onaylanmış bir inceleme gerektirir. Bir deny kuralı onu engeller.
  • Kimlik bilgilerini ajanların erişiminden uzak tutun. Çalışma alanı secret'ları build işlerine ortam değişkenleri olarak ulaşır ve build günlüklerinden çıkarılır; yapay zekâ ajanları onları asla almaz.
  • Her değişikliğin nasıl yapıldığını kaydedin. Her değişiklik imzalı bir kanıt paketi olarak indirilebilir: görev, modeller, adımlar, bulgular, testler, onaylar ve teslimat; Ed25519 ile imzalanmış ve çevrimdışı doğrulanabilir. Bir değişikliğin yazılması için, köken bilgisinin build için oynadığı role benzer bir rol oynar.

Yol kuralları için Onaylar ve politikalar, genel bakış için Güvenlik ve SBOM takibi sayfasına bakın.

Sık sorulan sorular

SLSA nasıl okunur?

Salsa sözcüğü gibi. Harfler Supply-chain Levels for Software Artifacts ifadesinin kısaltmasıdır.

SLSA ile SBOM arasındaki fark nedir?

Bir SBOM bir yapıtın içinde ne olduğunu listeler. SLSA köken bilgisi ise yapıtın nasıl, hangi kaynaktan ve hangi build platformu tarafından build edildiğini kaydeder. Farklı soruları yanıtlarlar ve çoğu zaman birlikte kullanılırlar.

SLSA 3. seviye yazılımımın güvenli olduğu anlamına mı gelir?

Hayır. Build platformunun build'i kurcalamayı veya köken bilgisini sahtelemeyi zorlaştırdığı anlamına gelir. Güvenlik açıkları, incelenip merge edilmiş kötü amaçlı kod veya bağımlılıklarınızın güvenliği hakkında hiçbir şey söylemez.

SLSA 3. seviyeye ulaşmam gerekir mi?

1. seviyeyle, yani her sürüm için köken bilgisiyle başlayın ve 2. seviye için köken bilgisini imzalayan barındırılan bir build platformuna geçin. Birçok barındırılan CI hizmeti, kendi platformunuzu kurmadan 2. veya 3. seviyeyi pratik hâle getirir.