İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

Aggrega Plugin güven kaydı şeması

Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.

Şema kimliği: https://aggrega.ai/schemas/plugins-trust-v1beta1.schema.json

Kabul ya da ret kararı döndüren her bağlama için güvenilen eklenti kimliğinin makine tarafından üretilmiş kaydı: ir-verdict ya da render-verdict rolündeki bir plugins.governance bağlaması ve her plugins.linter bağlaması. Kilit dosyasının yanında plugins-trust.yaml konumunda bulunur ve onunla birlikte commit edilir, çünkü sürüm denetimi dışında tutulan bir kaydı kimse inceleyemez ve hiçbir şey onunla karşılaştırılamaz. aggrega pull tarafından yazılır; bu komut, bu bağlamalardan birini ilk kez çözdüğünde dosyayı oluşturur ve her bağlamayı çözdükçe bağlama başına bir kayıt ekler. Yapılandırılmış bağlamaların yalnızca bir kısmı için kayıt taşıyan bir dosya, bozulmuş değil geçerli bir ara durumdadır. aggrega build, aggrega lint --release ve aggrega validate --release tarafından ve aggrega serve ile aggrega mcp üzerinden erişilen aynı işlemler tarafından okunur; her biri, bu bağlamalardan herhangi biri çalışmadan önce çalışma alanı yapılandırmasını kayda göre denetler. İki uyuşmazlık farklı nedenlerle reddedilir: çözülen yapıt özeti kendisi için kaydedilen özetle aynı olmayan bir eklenti çalıştırılmaz, reddedilir, çünkü çalışacak eklenti kaydın incelendiği eklenti değildir; yapılandırılmış hiçbir karar bağlamasının karşılamadığı bir kayıt girdisi ise çalışmayı durdurur, çünkü bir kapıyı kaldırmak işlenmiş çıktının hiçbir baytını değiştirmez; dolayısıyla incelenmiş bir kapı olmadan üretilen çıktı, o kapının onayladığı çıktıdan ayırt edilemez. Bir derleme, sürüm kapsamlı bir lint ve sürüm kapsamlı bir doğrulama da (komut satırından, aggrega serve üzerinden ya da aggrega mcp üzerinden) içerik önbelleğinden okudukları bu eklentilerin her birini, yüklerken kaydının taşıdığı signature değerine göre denetler; tıpkı bir derlemenin her kilit dosyası girdisini o girdinin taşıdığı değere göre denetlemesi gibi: aşağıdaki signature bölümüne bakın. Ters yön, yani kaydın henüz içermediği yapılandırılmış bir bağlama, az önce açıklanan ara durumdur ve iki karşılaştırmadan hiçbiri onu reddetmez; bulunmayan bir kayıt ise hiç girdi içermez, dolayısıyla hiçbir şeyi sabitlemez ve iki karşılaştırmadan hiçbiri onun yüzünden bir şeyi reddetmez; imza gereksinimi, aşağıda signature bölümünün açıkladığı gibi, eksik bir girdinin kaçamadığı tek denetimdir. Bir girdi kayıttan yalnızca açık bir yükseltmeyle çıkar: bir eklentiyi adlandıran aggrega pull --upgrade, artık hiçbir karar bağlaması o eklentiyi adlandırmıyorsa eklentinin girdisini kaldırır; yalın bir aggrega pull --upgrade ise bu türden her girdiyi kaldırır. Düz bir aggrega pull ne bir girdinin kimliğini yeniden çözer ne de girdiyi kaldırır; böylece hiçbir şeyin karşılamadığı bir girdi nedeniyle oluşan durdurma, bir sonraki çalışmayla değil, bilinçli olarak belirtilerek giderilir. Son girdisi kaldırılan bir kayıt silinmez, boşaltılır ve boşaltılmış bir kayıt geçerlidir: hiçbir şey içermez, dolayısıyla hiçbir şeyi sabitlemez ve iki karşılaştırmadan hiçbiri onun yüzünden bir şeyi reddetmez; tıpkı bulunmayan bir kayıtta olduğu gibi. Her kayıt eklentinin kendi kimlik koordinatıyla adreslenir ve seçilen sürümü ve yapıt özetini alan olarak taşır; dolayısıyla bir sürüm değişikliği, yeni bir adres altında yeni bir kayıt değil, var olan bir kaydın bir alanındaki değişikliktir; yeniden sürümlenmiş bir eklentiyi dosyada ve farkında ilk kez kaydedilen bir eklentiden ayırt edilebilir kılan da budur. Bu kimliğin yanı sıra bir kayıt, adlandırdığı yapıt hakkında, her biri yalnızca doğrulandığında kaydedilen iki olgu taşır: bir yayıncının ona eklediği kullanımdan kaldırma işareti (bulunduğunda ve imzası doğrulandığında) ve aggrega pull komutunun eklentinin kendi imzasını doğruladığında kaydettiği doğrulanmış imza olgusu; bu, bir kilit dosyası girdisinin taşıdığı olgunun aynısıdır ve aynı anahtar altındadır. Her biri ikinci bir kimlik değil, kaydedilen yapıt hakkında bir olgudur; sıradan bir pull işleminin, kaydın denetlendiği kimliği bozmadan bunlardan birini kaydetmesinin nedeni budur. Dosya bunların ötesinde hiçbir şey kaydetmez: dosyanın kendisi üzerinde imza yoktur, kural girdileri yoktur, çözümleme kökeni yoktur (kayıt defteri ana makinesi yoktur, dosyayı yazan makinedeki yol yoktur) ve saat okuması yoktur; dolayısıyla aynı çözümleme, nerede ve ne zaman çalışırsa çalışsın aynı baytları üretir. Bir plugins.governance karar bağlamasının harici kural dosyaları, kilit dosyasının verdict_inputs alanında özet olarak kaydedilir; bir plugins.linter bağlamasının kural girdileri ise iki dosyanın hiçbirine kaydedilmez. Bir derlemenin bayt bayt yeniden ürettiği her şey bunun yerine kilit dosyasında sabitlenir; bir karar bağlaması işlenmiş çıktının hiçbir kısmını biçimlendirmez; kimliğinin orada değil burada kaydedilmesinin nedeni budur. Şema evrimi disiplini: yeni bir üst düzey bölüm eklemek SemVer-MINOR’dır (ekleyici); var olan bir bölümün içine yeni bir alan eklemek SemVer-MINOR’dır; bir anahtarı kaldırmak ya da bir kısıtlamayı sıkılaştırmak SemVer-MAJOR’dır.

Üst düzey tür: object

Özellikler

ÖzellikTürZorunluAçıklama
pluginsobject[]hayırKarar döndüren bir ek için güvenilen her plugin başına bir kayıt; plugin’in kimlik koordinatıyla adreslenir. Aynı anda iki karar rolüne eklenmiş bir plugin (hem ir-verdict hem render-verdict rolüne bağlanmış aynı yönetişim plugin’i) tek bir kayıt oluşturur, çünkü kaydedilen özne ek değil plugin’in kimliğidir: iki ek aynı yapıtı okur. Kayıtlar artan koordinat sırasıyla yazılır. Varsayılan: []
versionconst 1evetGüven kaydı şema sürümü: 1. Şemadaki bir SemVer-MAJOR değişiklik bunu artırır. Sabit: 1

Ek özelliklere izin verilmez.

plugins-trust.plugins[]

ÖzellikTürZorunluAçıklama
deprecationobjecthayırdigest alanının adlandırdığı yapıt üzerinde imzalı, güvenilir bir işaretçi bulunduğunda kaydedilen, doğrulanmış geriye dönük kullanımdan kaldırma işaretçisi. İşaretçi, kullanımdan kaldırdığı yapıtın imzalı bir OCI referrer’ıdır ve yapıt yeniden yayımlanmadan yayımdan sonra eklenir; böylece burada zaten kayıtlı bir plugin sonradan kullanımdan kaldırılabilir. Geri çekme kademesi olan retracted önem düzeyinde bu, yapıtın yalnızca önerilmemesi değil, seçimden dışlanması anlamına gelir. Bu, ikinci bir kimlik değil, bu kaydın zaten adreslediği yapıta ilişkin bir olgudur; aggrega pull komutunun resolved_version ve digest alanlarına dokunmadan bir işaretçi ekleyebilmesini sağlayan da budur: onu kaydetmek hiçbir şeyi benimsemez. Yalnızca çözümlenen özet zaten kayıtlı özete eşit olduğunda kaydedilir; farklı baytlar bildiren bir çözümleme bir kimlik değişikliğidir, bu kaydın kendi kuralına tabidir ve çalıştırma bunu istemedikçe reddedilir. Kaydedilmiş bir işaretçiyi hiçbir şey temizlemez; işaretçi yalnızca onu taşıyan kayıtla birlikte, o kaydı değiştiren ya da kaldıran açık yükseltmede ayrılır. aggrega build, aggrega lint --release ve aggrega validate --release ile aggrega serve ve aggrega mcp üzerinden erişilen aynı işlemler böyle bir işaretçi taşıyan plugin’i adlandırır, çünkü aksi hâlde kullanımdan kaldırılmış bir geçit hiçbir şey söylenmeden getirilir, önbelleğe alınır ve çalıştırılır; bir derlemenin bunun üzerine durup durmayacağına ya da yalnızca uyarılacağına çalışma alanının build.halt_on_deprecated_severity ayarı karar verir.
pluginstringevetPlugin’in kimlik koordinatı: soket kesimi ile yalın adının bir eğik çizgiyle birleştirilmesi, örneğin governance/aggrega-security-baseline. Yalın ad yalnızca kendi soketi içinde benzersizdir; bu yüzden farklı soketlerdeki aynı adlı iki plugin’i ayırt eden soket kesimidir. Koordinat bilerek sürüm taşımaz; bir sürüm değişikliğini ilgisiz bir kayıt olarak değil, aşağıdaki resolved_version alanında bir düzenleme olarak görünür kılan budur.
resolved_versionstringevetKayıt yazıldığında bu plugin için seçilen somut sürüm (örn. 1.2.3). Tek bir yol kesimi olarak kaydedilir; bu yüzden /, \ ve .. içermez. Desen: ^([^/\\.]|\.[^/\\.])*\.?$.
digeststringevetÇözümlenen plugin yapıtının içerik özeti; sha256: ardından 64 küçük harfli onaltılık karakter biçiminde, yani içerik adresinin karşılaştırıldığı her yerde yazıldığı biçimde. Desen: ^sha256:[a-f0-9]{64}$.
signatureVerifiedSignaturehayıraggrega pull, digest alanının adlandırdığı yapıt için bu plugin’in kendi imzasını çözümleyen kayıt defterinin güven ilkesine göre doğruladığında kaydedilen doğrulanmış imza olgusu. Bir pull, bu eklerden biri için çözümlediği her plugin’in imzasını her çalıştırmada doğrular ve bulduğunu buraya kaydeder: kaydın tuttuğunu değiştirir, hiçbir imza doğrulamadığı yerde ise kaldırır; bunu kaydın bağlı olduğu kimliği bozmadan yapar. Bir derleme, sürüm kapsamlı bir lint ya da sürüm kapsamlı bir doğrulama plugin’i çalıştırmadan önce bu olgunun adlandırdığı önbellekteki imza paketi yeniden özetlenir ve blob eksikse ya da farklıysa çalıştırma durur; içerik önbelleğinden okunan bir plugin için de çalıştırma imzanın hangi yapıt için yapıldığını o paketten okur ve okuduğu plugin’den farklı bir yapıt için yapılmışsa durur; böylece başka bir plugin’in girdisinden kopyalanmış bir signature, imzalama gereksinimi ne derse desin reddedilir. Orada hiçbir imza doğrulanmaz; bu yüzden önbelleğe elle yazılmış, bu plugin’in kendi yapıtı için düzenlenmiş bir paket, bir pull’un doğruladığından ayırt edilmez. Çalışma alanının güven yapılandırması içerik önbelleğinden okunan bir plugin için imza gerektirdiğinde (bu, aggrega pull komutunun plugin’i doğrularken uyguladığı gereksinimdir; dolayısıyla bir pull’un hiçbir şey kaydetmemesine izin veren atlamalar ve advisory kayıt defteri çalıştırmanın da devam etmesine izin verir) onun için hiçbir signature taşımayan ya da onun için hiç girdisi olmayan bir kayıt, plugin’i ve imzayı gerektiren ayarları adlandırarak çalıştırmayı durdurur. Bir katalog dizininden ya da derleyici ikili dosyasının içindeki kopyadan okunan bir plugin bu gereksinime asla tabi tutulmaz.

Ek özelliklere izin verilmez.

plugins-trust.plugins[].deprecation

digest alanının adlandırdığı yapıt üzerinde imzalı, güvenilir bir işaretçi bulunduğunda kaydedilen, doğrulanmış geriye dönük kullanımdan kaldırma işaretçisi. İşaretçi, kullanımdan kaldırdığı yapıtın imzalı bir OCI referrer’ıdır ve yapıt yeniden yayımlanmadan yayımdan sonra eklenir; böylece burada zaten kayıtlı bir plugin sonradan kullanımdan kaldırılabilir. Geri çekme kademesi olan retracted önem düzeyinde bu, yapıtın yalnızca önerilmemesi değil, seçimden dışlanması anlamına gelir. Bu, ikinci bir kimlik değil, bu kaydın zaten adreslediği yapıta ilişkin bir olgudur; aggrega pull komutunun resolved_version ve digest alanlarına dokunmadan bir işaretçi ekleyebilmesini sağlayan da budur: onu kaydetmek hiçbir şeyi benimsemez. Yalnızca çözümlenen özet zaten kayıtlı özete eşit olduğunda kaydedilir; farklı baytlar bildiren bir çözümleme bir kimlik değişikliğidir, bu kaydın kendi kuralına tabidir ve çalıştırma bunu istemedikçe reddedilir. Kaydedilmiş bir işaretçiyi hiçbir şey temizlemez; işaretçi yalnızca onu taşıyan kayıtla birlikte, o kaydı değiştiren ya da kaldıran açık yükseltmede ayrılır. aggrega build, aggrega lint --release ve aggrega validate --release ile aggrega serve ve aggrega mcp üzerinden erişilen aynı işlemler böyle bir işaretçi taşıyan plugin’i adlandırır, çünkü aksi hâlde kullanımdan kaldırılmış bir geçit hiçbir şey söylenmeden getirilir, önbelleğe alınır ve çalıştırılır; bir derlemenin bunun üzerine durup durmayacağına ya da yalnızca uyarılacağına çalışma alanının build.halt_on_deprecated_severity ayarı karar verir.

ÖzellikTürZorunluAçıklama
messagestringevetİşaretçinin taşıdığı, insan tarafından okunabilir kullanımdan kaldırma iletisi; genellikle bir geçiş yönlendirmesi. İşaretçi ayrı bir ileti taşımadığında bunun yerine nedeni buraya kaydedilir; böylece bildirilen cümle hiçbir zaman boş olmaz.
severitystring (enum)evetİşaretçi önem düzeyi; sıralama warning < error < retracted şeklindedir. Bu önem düzeyi yapılandırılmış durma eşiğine ulaştığında ya da onu aştığında derleme durur, aksi hâlde uyarılır; bu, diğer her kullanımdan kaldırma raporunun okuduğu aynı kural ve aynı ayardır. retracted geri çekme kademesidir: bu önem düzeyindeki bir yapıt seçimden dışlanır, iki uyarı niteliğindeki önem düzeyi ise onu seçilebilir bırakır. İzin verilen değerler: "warning", "error", "retracted"

Ek özelliklere izin verilmez.

Tanımlar

VerifiedSignature

Bir pull işleminin, bir artifact’in imzasını çözümleyen registry’nin güven politikasına göre doğruladığında kaydettiği doğrulanmış imza bilgisi. Her iki kaydın da bunun için kullandığı tek yapıdır — lockfile, her girdisinde, ve bu kayıt, her plugin için — böylece doğrulanmış bir imza her iki dosyada da aynı biçimde okunur. Doğrulama modunu, eşleşen anahtarsız kimliği/yayıncıyı (anahtarsız olduğunda) ya da sabitlenmiş anahtarın parmak izini (anahtarlı olduğunda) ve pull işleminin önbelleğe aldığı imza paketinin içerik adresli özetini kaydeder.

ÖzellikTürZorunluAçıklama
bundle_digeststringevetÖnbelleğe alınmış imza paketi blob’unun SHA-256 özeti; sha256: ve ardından gelen 64 küçük harfli onaltılık karakter biçimindedir. Önbellek blob’unu adlandırır, bu nedenle bir yol oluşturur ve /, \ ya da .. içermez — ki sha256: biçimi bunları zaten dışlar — ve bir build’in, sürüm kapsamlı bir lint’in ve sürüm kapsamlı bir doğrulamanın o blob’u yeniden özetleyip karşılaştırdığı değerdir. Desen: ^sha256:[a-f0-9]{64}$.
identitystringhayırİmzanın doğrulanmış imzalayanı: anahtarsız bir imza için imzalama sertifikasının öznesi, anahtarlı bir imza için ise keyed:sha256: ve ardından sabitlenmiş genel anahtarın PEM metninin SHA-256 değeri.
issuerstringhayırAnahtarsız bir imza için doğrulanmış OIDC yayıncısı. Anahtarlı bir imza için boştur.
modestring (enum)evetİmzayı kabul eden doğrulama kipi. İzin verilen değerler: "keyless", "keyed"

Ek özelliklere izin verilmez.