AI CodeOps

Python servisi: SBOM ve lisans kapısı

Son güncelleme

Dependency Refresh ile bir Python servisinin bağımlılıklarını copyleft lisanslar için denetleyin, bir CycloneDX SBOM kaydedin ve CI'ın GPL kodu içeren yayınları reddetmesini sağlayın.

Bu şablonu kullan

Lisans sorunlarını yayından önce düzeltmek, bir müşterinin denetiminden sonra düzeltmekten daha ucuzdur. Bu şablonda ajanlar copyleft bağımlılıkları bulup değiştirir, ardından CI'ınıza projenin SBOM'una karşı kesin bir kontrol verilir.

Hangi ajanlar çalışır

  1. Audit, Dependency Auditor tarafından: pyproject.toml dosyasını ve README'yi okur; lisans çakışmaları, bilinen güvenlik açıkları (canlı bir veritabanından değil, modelin bilgisinden) veya bakımı yapılmayan paketleri, her biri için bir yükseltme yoluyla birlikte listeler.
  2. Upgrade, Migration Specialist tarafından: geri alma notlarıyla birlikte değiştirme veya kaldırma planı.
  3. Test, Tester tarafından: yazılmış değişikliğin ve kaydedilen test çalıştırmasının hiçbir şeyin bozulmadığını gösterip göstermediği ve hangi senaryoların hâlâ eksik olduğu.
  4. Verify secure, Security Auditor tarafından: yazılmış değişikliği kontrol eder.

Değişiklik Upgrade adımından sonra yazılır ve testleriniz onun üzerinde çalışır. Test ve Verify secure bundan sonra çalışır; dolayısıyla gerçek diff'i ve onun test sonucunu okurlar.

Ajan yalnızca doğrudan bağımlılıkları okur. poetry.lock gibi lockfile'lar dahil edilmez; bu yüzden geçişli bağımlılıkların lisansları onun için çoğunlukla görünmezdir. SBOM kontrolünün kapsadığı kısım budur.

Test paketiniz çevrimdışı bir sandbox içinde çalışır. Son adımdan sonra değişiklik, denetim bağlam olarak alınarak bir bulgu incelemesinden (bağımlılık bulguları çalıştırma sayfasında görünür) ve bir insan onayından geçer.

SBOM'u kaydedin

AI CodeOps SBOM üretmez. Build araçlarınızla bir CycloneDX veya SPDX dosyası oluşturun, ardından onu giriş yapılmış bir oturumdan /api/sbom üzerinden projeye kaydedin; açık betada bir yükleme formu veya API anahtarıyla kayıt yoktur. Secure → Security altındaki lisans özeti, bulduğu lisans dizelerini birebir gösterir. Bağımlılık değişikliği merge edildikten sonra yeni bir SBOM kaydedin, çünkü kapı projenin en son SBOM'unu okur.

Yayınları lisanslara göre kapıdan geçirin

curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $WORKSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"pullRequestURL\":\"$PR_URL\",\"disallowedLicenses\":[\"GPL-3.0-only\",\"GPL-3.0-or-later\",\"AGPL-3.0-only\",\"AGPL-3.0-or-later\"]}" \
  | jq -e '.allowed == true'

Eşleştirme birebirdir ve büyük/küçük harfe duyarlı değildir; dolayısıyla GPL-3.0, GPL-3.0-only ile eşleşmez. Her tanımlayıcıyı SBOM'unuzun lisans özetinde göründüğü gibi listeleyin. Bir eşleşme, licenseViolations alanıyla birlikte ret döndürür. Bkz. güvenlik ve SBOM.

Bağımlılık denetimi değil güvenlik denetimi gerektiren kod değişiklikleri için kimlik doğrulama değişikliği şablonunu kullanın.

Sık sorulan sorular

SBOM'u AI CodeOps mu üretir?

Hayır. Onu her zamanki aracınızla, örneğin build'inizdeki bir CycloneDX üreticisiyle oluşturun ve projeye kaydedin. AI CodeOps onu izler ve lisansları ona göre kontrol eder.

Hiç lisans ihlali yokken yayınım neden reddedildi?

disallowedLicenses ayarlandığında SBOM'u olmayan bir proje kontrol edilemez; bu yüzden reddedilir ve licenseEvidenceMissing içinde listelenir.

Lisans denetimi hukuki tavsiye midir?

Hayır. Ajanın lisans notları adayları bulmanıza yardımcı olur. Neyi yayına alabileceğinize hukuk ekibiniz karar verir.