Schemat pliku blokady Aggrega dla encji Release
Dokumentacja wygenerowana automatycznie. Nie należy jej edytować ręcznie — należy ją wygenerować ponownie z opublikowanego JSON Schema.
Identyfikator schematu: https://aggrega.ai/schemas/lockfile-v1beta1.schema.json
Generowany maszynowo plik blokady, który przypina każdy URI rozwiązany z encji Release, aby przyszłe kompilacje były deterministyczne. Znajduje się w <release-stem>.lock obok <release-stem>.yaml; tworzy go aggrega pull --release <release>, a odczytuje aggrega build --release <release>. Dwa kształty pochodzenia zapisują dwie odrębne relacje w grafie zależności: referenced_from (lista ciągów) występuje w entities jako ścieżki miejsc autorskich zapisane z kropkami, które rejestrują, w którym miejscu encji Release / Aggregate / Manifest / .aggrega-config.yaml dany URI został wciągnięty, oraz w plugins jako odwołanie do każdej encji Plugin, przez którą osiągnięto artefakt; consumers (lista rekordów {consumer_uri, fragments}) występuje w schema_libraries, mapping_libraries, workload_libraries i artifact_libraries, aby zapisać, która encja katalogu odwołuje się do których fragmentów <entry-name> biblioteki — ustrukturyzowany kształt pozwala prześledzić różnice wskazujące konsumentów, na których wpływa podbicie wersji biblioteki, bez ponownego rozwiązywania encji Release. Zasady ewolucji schematu: dodanie nowej sekcji najwyższego poziomu to zmiana SemVer-MINOR (addytywna); dodanie nowego pola w istniejącej sekcji to zmiana SemVer-MINOR; usunięcie klucza lub zaostrzenie ograniczenia to zmiana SemVer-MAJOR.
Typ najwyższego poziomu: object
Właściwości
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
entities | object[] | nie | Encje katalogu osiągalne z tej encji Release: Component, Feature, Recipe, FeatureRecipe, Plugin, Aggregate, własne encje Aggregate i Manifest tej encji Release oraz encja Manifest, którą ta encja Manifest rozszerza. Każdy wpis jest identyfikowany przez swój kind wraz z kanonicznym URI, więc dwie encje różnych rodzajów o tej samej nazwie — na przykład encje Aggregate i Manifest, obie o nazwie imported/flow — to dwa wpisy, z których każdy jest sprawdzany względem własnego skrótu (digest). Każdy rejestruje rozwiązaną wersję, skrót (digest) tego, co niesie encja, oraz miejsca pochodzenia w źródłach (referenced_from), które wciągnęły URI do domknięcia zależności encji Release. Plik lockfile, którego wpisy nie zawierają żadnego kind, jest nieaktualny: aggrega pull --release <release> zapisuje go ponownie. Domyślnie: [] |
external_inputs | ExternalInput[] | nie | Zdalne dane wejściowe przypięte w adresowanym treścią magazynie wejść w chwili pobrania — treść, którą renderowanie pluginu dostawcy pobiera spoza przestrzeni roboczej, np. zdalne dokumenty schematów lub niezvendorowane zależności chartów. Każdy wpis przypina jeden URL do skrótu identyfikującego jego bajty w magazynie. Build serwuje przypięte wejścia z magazynu i odczytuje tę sekcję bez dostępu do sieci. Domyślnie: [] |
generated_at | string | tak | Znacznik czasu RFC 3339 pobrania, które utworzyło ten plik blokady; wzorzec wymusza ten kształt wartości przy wczytywaniu pliku blokady. Pochodzenie diagnostyczne — rejestruje rzeczywisty moment rozwiązania. Celowo zmienia się między pobraniami; nie wchodzi w gwarancję identyczności bajtowej pliku blokady. Wzorzec: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$. |
mapping_libraries | LibraryEntry[] | nie | Wpisy MappingLibrary, do których domknięcie zależności encji Release dociera przez miejsca valuesMapping: { $import: ... } w encjach Recipe / FeatureRecipe. Lista consumers każdego wpisu rejestruje, która encja katalogu odwołuje się do których fragmentów <entry-name> biblioteki — ustrukturyzowany zapis, dzięki któremu różnice wpływu podbicia wersji biblioteki dają się prześledzić bez ponownego rozwiązywania encji Release. Domyślnie: [] |
mutators | object[] | nie | Rozwiązane podłączenia nadzoru w roli transformacji, w kolejności zapisu. Plugin w roli transformacji (label-transform, który przepisuje etykiety węzłów, lub annotation-transform, który wstrzykuje adnotacje przed rozwinięciem) kształtuje bajty wyniku renderowania, więc zbiór podłączeń — uporządkowana lista oraz dla każdego podłączenia rola, współrzędne pluginu i funkcja eksportowana — jest wejściem determinującym bajty i jest tu przypięty. Build odczytuje tę sekcję — nigdy .aggrega-config.yaml — aby odtworzyć zbiór, kolejność, rolę i funkcję eksportowaną, dzięki czemu wynik buildu nie zależy od zmiany plugins.governance dokonanej po pobraniu (przyjmowanej dopiero przy następnym pobraniu). Kolejność jest ZNACZĄCA: każdy wykonawca transformacji stosuje podłączenia swojej roli w kolejności listy, więc w odróżnieniu od sekcji plugins / providers sortowanych według URI ta lista nigdy nie jest przestawiana. Skrót treści pluginu NIE jest tu powielany: ma jedno źródło w sekcjach plugins i entities, na które ten zapis wskazuje przez tożsamość. Domyślnie: [] |
plugins | object[] | nie | Wtyczki Wasm, których bajty kształtują wyrenderowane wyjście, każda przypięta skrótem treści swojego .wasm: wtyczka governance dołączona w roli transformacji (label-transform, annotation-transform) w .aggrega-config.yaml plugins.governance oraz wszelkie osadzone URI wtyczek z przywoływanych encji Recipes / FeatureRecipes / Providers. Wtyczka governance dołączona w roli werdyktu (ir-verdict, render-verdict) i dołączenie plugins.linter zwracają werdykt i nie kształtują żadnych bajtów wyjściowych, więc żadne z nich nie jest przypinane: żadne nie pojawia się tutaj ani w entities, a pliki reguł odczytywane przez dołączenie werdyktu są zapisywane w verdict_inputs. Domyślnie: [] |
providers | object[] | nie | Rozwiązane wybory dostawcy dla poszczególnych możliwości. Każdy wpis przypina jedną możliwość (np. helm) do pozbawionej skrótu tożsamości OCI pluginu renderującego dostawcy, który ją renderuje, rozwiązanej przy pobraniu z listy plugins.providers w .aggrega-config.yaml (gdy możliwość obsługuje niejednoznacznie wiele pluginów) lub z jedynego obsługującego pluginu (gdy jest jednoznaczna). Build odczytuje tę sekcję — nigdy .aggrega-config.yaml — aby wybrać dostawcę, dzięki czemu wynik buildu nie zależy od zmian konfiguracji przestrzeni roboczej dokonanych po pobraniu. Skrót treści pluginu NIE jest tu powielany: ma jedno źródło w sekcjach plugins i entities, na które ten zapis wskazuje przez tożsamość. Współistnienie wersji jest zachowane: ten zapis wybiera repozytorium pluginu dla każdej możliwości; konkretne wersje znajdują się w entities (jeden wpis na każdą rozwiązaną wersję pluginu), a przypięcie wersji spec.capability w każdej encji Recipe wybiera spośród nich przy renderowaniu. Domyślnie: [] |
release | string | tak | Ścieżka do encji Release, której odpowiada ten plik blokady, rozwiązywana względem katalogu samego pliku blokady (np. ./release-prod.yaml). Konwencja nazewnictwa dla każdej encji Release umieszcza <release-stem>.lock obok <release-stem>.yaml; ścieżka względna sprawia, że plik blokady sam się opisuje, bez zależnych od maszyny ścieżek bezwzględnych. To pole wskazuje encję Release; to, co encja Release zawierała w chwili rozwiązania, jest zapisane w release_documents. |
release_documents | object[] | nie | Pliki encji Release odczytane przez rozwiązywanie, każdy zapisany za pomocą skrótu treści jego bajtów: najpierw encja Release, do której należy ten plik blokady, potem każda encja Release, którą ona rozszerza, w kolejności przechodzenia łańcucha extends. Wszystko, o co prosi encja Release, jest rozwiązywane z tego, co ona zawiera, więc encja Release edytowana po pobraniu przestaje pasować do zapisanego skrótu, a build — lub aggrega pull --verify — zatrzymuje się, wskazując plik, z aggrega pull --release <release> jako środkiem naprawczym, zanim cokolwiek zostanie wyrenderowane. Skrót obejmuje bajty w niezmienionej postaci, bez żadnej normalizacji, zgodnie z tą samą zasadą co przypięcia encji Aggregate i Manifest: edycja komentarza lub białych znaków liczy się jako zmiana. Plik blokady bez tej sekcji nie zapisuje żadnego pliku encji Release, a build oparty na takim pliku zgłasza encję Release jako niezapisaną. Plik importowany przez encję Release za pomocą parameters nie jest tu zapisywany. |
schema_libraries | LibraryEntry[] | nie | Wpisy SchemaLibrary, do których domknięcie zależności encji Release dociera przez miejsca $ref i $import: w treści schema: / usesSchema: / featuresSchema: encji. Lista consumers każdego wpisu rejestruje, która encja katalogu odwołuje się do których fragmentów <entry-name> biblioteki — ustrukturyzowany zapis, dzięki któremu różnice wpływu podbicia wersji biblioteki dają się prześledzić bez ponownego rozwiązywania encji Release. Domyślnie: [] |
source_artifacts | SourceArtifactEntry[] | nie | Artefakty źródłowe pobrane z pól spec.source encji Recipe / FeatureRecipe w chwili pobrania. Każdy wpis identyfikuje unikatową tożsamość {kind, url, chart, pinned_version} wraz ze skrótem treści, typem nośnika i ustrukturyzowanymi wskaźnikami zwrotnymi referenced_by:, wskazującymi każdą encję katalogu, która rozwiązała się do tego artefaktu. url to zapisany URL tożsamości; rozwiązana lokalizacja artefaktu dla źródła helm z katalogu głównego repozytorium jest zapisywana osobno w resolved_url: jako pochodzenie. Wiele encji Recipes przypinających ten sam chart w tej samej wersji scala się w jeden wpis z wieloma zapisami referenced_by:. Wyliczenie kind obejmuje cztery rodzaje źródeł, które się rozwiązują, oraz terraform-module-oci, którego nie obsługuje żaden adapter źródła: encja Recipe lub FeatureRecipe, która go wskazuje, jest odrzucana już przy odczycie, więc żaden pull nie zapisuje wpisu tego rodzaju. Domyślnie: [] |
toolchain | object | nie | Wersje łańcucha narzędzi, który utworzył ten plik blokady: własna wersja kompilatora oraz wersja każdego pluginu podstawowego, który kompilator zawiera. Zapisywane, aby plik blokady pozwalał po fakcie ustalić, który kompilator i które pluginy podstawowe rozwiązały i wyrenderowały build — na to pytanie przypięte sekcje nie zawsze odpowiadają, ponieważ podstawowy plugin dostawcy serwowany z wnętrza pliku binarnego kompilatora pozostaje nieprzypięty i nie ma własnej zapisanej wersji. Tylko wersje: znacznik nigdy nie zapisuje, skąd pochodzą bajty pluginu, więc dwie maszyny, które przypięły to samo domknięcie zależności tym samym kompilatorem, zapisują ten sam znacznik. Nic nie porównuje tej sekcji, nie ostrzega o niej ani nie odmawia buildu z jej powodu, a jej brak w pliku blokady przechodzi bez komunikatu: łańcuch narzędzi nie należy do domknięcia zależności przypinanego przez plik blokady. Z tego samego powodu sekcja jest pomijana w porównaniu identyczności bajtowej między dwoma pobraniami tych samych wejść, na tych samych zasadach co generated_at. |
verdict_inputs | object[] | nie | Zewnętrzne dane wejściowe reguł, które dołączenie governance w roli werdyktu (ir-verdict / render-verdict) odczytuje w czasie kompilacji — plik reguł Kyverno / Rego dostarczony przez with.sources dołączenia. Zapisywane jako skrót treści dla każdego źródła, na potrzeby audytu i widoczności dryfu między kolejnymi pull: skrót, który ukształtował werdykt, można porównywać między pull, więc zmieniony plik reguł ujawnia się jako różnica w lockfile. Ta sekcja to PROWENIENCJA, a nie dane wejściowe builda: w odróżnieniu od mutators.sources nie zawiera content, a build jej NIE odczytuje — plugin werdyktu jest buforowany, a nie przypinany, i odczytuje swoje dane wejściowe reguł na żywo (werdykt nie kształtuje żadnych bajtów wyjściowych, więc nic, co lockfile przypina dla deterministycznego wyniku, go nie obejmuje). Ponieważ plugin werdyktu nie jest przypinany, nie występuje w sekcjach entities / plugins; ten rekord identyfikuje więc dołączenie przez jego autorski URI, samodzielnie, a nie przez wskazanie tych sekcji. Zapisanie skrótu sprawia, że dane wejściowe, które zdecydowały o akceptacji lub odrzuceniu, są audytowalne i odtwarzalne bez przypinania ich do builda. Domyślnie: [] |
version | const 1 | tak | Wersja schematu lockfile: 1. Zmiana schematu typu SemVer-MAJOR ją zwiększa. Stała: 1 |
workload_libraries | LibraryEntry[] | nie | Wpisy WorkloadLibrary, do których domknięcie zależności encji Release dociera przez miejsca workload: { $import: ... } w encji Recipe. Lista consumers każdego wpisu zapisuje, która encja katalogu odwołuje się do których fragmentów <entry-name> biblioteki — ustrukturyzowany rekord, dzięki któremu skutki podbicia wersji biblioteki można prześledzić bez ponownego rozwiązywania encji Release. Domyślnie: [] |
artifact_libraries | LibraryEntry[] | nie | Wpisy ArtifactLibrary, do których domknięcie zależności encji Release dociera przez miejsca artifacts.<name>: { $import: ... } w encjach Recipe / FeatureRecipe. Lista consumers każdego wpisu zapisuje, która encja katalogu odwołuje się do których pakietów <entry-name> biblioteki — ustrukturyzowany rekord, dzięki któremu skutki podbicia wersji biblioteki można prześledzić bez ponownego rozwiązywania encji Release. Domyślnie: [] |
Dodatkowe właściwości są niedozwolone.
lockfile.entities[]
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
kind | string (enum) | tak | Rodzaj encji katalogu, odczytywany z miejsca, w którym encja Release, jej encja Aggregate lub jej encja Manifest ją wskazuje: component i feature dla typu Component lub Feature wskazanego przez encję Aggregate, encję Release lub mapowanie encji Manifest, recipe i feature_recipe dla realizacji wiązanej przez mapowanie encji Manifest, plugin dla encji Plugin, aggregate dla własnej encji Aggregate encji Release i każdej encji Aggregate, którą ona włącza, oraz manifest dla własnej encji Manifest encji Release i encji Manifest, którą ona rozszerza. Razem z uri identyfikuje wpis: kompilacja porównuje każdy wpis z encją tego samego rodzaju i URI, więc edycja dowolnej z dwóch jednoimiennych encji różnych rodzajów zostaje zauważona. Dozwolone wartości: "aggregate", "component", "feature", "feature_recipe", "manifest", "plugin", "recipe" |
uri | string | tak | Kanoniczny URI encji katalogu (np. hub.aggrega.ai/component/core/compute/api-server). |
resolved_version | string | tak | Konkretna wersja wybrana przez resolver w czasie pull — własna wersja encji katalogu (np. 1.2.3) lub wartość pusta dla encji najwyższego poziomu rozwiązanej przez ścieżkę, a nie przez wersję. Zapisywana jako pojedynczy segment ścieżki, ponieważ jeden nazywa, więc nie zawiera /, \ ani ..: wartość tworzy slot pamięci podręcznej, z którego build odczytuje tę encję, a wartość wychodząca poza katalog pamięci podręcznej wskazywałaby lokalizację poza nim. Wzorzec: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | tak | Skrót tego, co zawiera publikacja encji, w postaci sha256:, po którym następują 64 małe znaki szesnastkowe: SHA-256 z dokumentu encji i każdego pliku, który deklaruje obok niego, posortowanych według ścieżki, przy czym każdy wnosi swoją ścieżkę i SHA-256 swoich bajtów. Encja, która nie deklaruje żadnego pliku, liczy się jako jej jedyny dokument. Nic innego do niego nie wchodzi — ani sposób kompresji archiwum, ani znacznik czasu, ani żaden bit uprawnień, łącznie z bitem wykonywania — więc encja zapisuje ten sam skrót niezależnie od tego, czy została odczytana z katalogu, czy pobrana z rejestru, i przy każdym checkoutcie tych samych plików, w każdym systemie. Wzorzec: ^sha256:[a-f0-9]{64}$. |
manifest_digest | string | nie | Skrót manifestu OCI rozwiązanego artefaktu, w postaci sha256:, po którym następują 64 małe znaki szesnastkowe. Podpis zobowiązuje się do tego skrótu, a manifest wskazuje skrót opublikowanych bajtów, względem którego sprawdzane są pobranie i odczyt z pamięci podręcznej, zanim encja zostanie porównana ze swoim digest powyżej. Występuje tylko dla encji rozwiązanej z rejestru. Wzorzec: ^sha256:[a-f0-9]{64}$. |
referenced_from | string[] | nie | Miejsca pochodzenia w plikach autorskich — ścieżki kropkowe w YAML encji Release / Aggregate / Manifest (np. aggregate.spec.components.api.type) zapisujące, dlaczego ten URI znajduje się w domknięciu zależności encji Release. Domyślnie: [] |
signature | VerifiedSignature | nie | Fakt zweryfikowanego podpisu, zapisywany, gdy podpis tej encji został zweryfikowany w czasie pull względem polityki zaufania rejestru, z którego ją rozwiązano. |
deprecation | DeprecationRecord | nie | Zweryfikowany retroaktywny znacznik wycofania, zapisywany, gdy w czasie pull na tym artefakcie wykryto podpisany, zaufany znacznik wycofania. Znacznik to podpisany referrer OCI wycofywanego artefaktu, dołączony po publikacji bez ponownego publikowania artefaktu. Zapisuje ważność i komunikat znacznika oraz zweryfikowanego sygnatariusza, który go utworzył. Build odczytuje ten fakt i egzekwuje politykę wycofań wyłącznie na podstawie lockfile; nigdy ponownie nie wykrywa ani nie weryfikuje znacznika. |
Dodatkowe właściwości są niedozwolone.
lockfile.mutators[]
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
plugin | string | tak | Rozwiązana współrzędna pluginu w roli transformacji — tożsamość <pluginType>/<name> encji Plugin (np. governance/tag-injector). Łączy się przez tożsamość z sekcjami plugins i entities, skąd pochodzą przypięty skrót i zestaw wersji. |
role | string (enum) | tak | Rola transformacji, z którą powiązane jest to dołączenie, zapisana dosłownie z autorskiego wpisu plugins.governance, dzięki czemu build uruchamia dołączenie dokładnie w tej roli, zamiast ją wywnioskować: label-transform przepisuje etykiety węzłów podczas budowy topologii; annotation-transform wstrzykuje adnotacje przed ekspansją, w trakcie rozwiązywania. Dozwolone wartości: "label-transform", "annotation-transform" |
function | string | nie | Nadpisanie eksportu wskazane przez dołączenie. Brak wartości wybiera domyślny eksport roli (mutate dla label-transform, transform_annotations dla annotation-transform). |
settings | object | nie | Obiekt ustawień w dowolnej postaci zadeklarowany przez dołączenie, przypięty w autorskiej postaci i przekazywany pluginowi dosłownie. Build odczytuje ustawienia stąd — nigdy z bieżącej konfiguracji — więc zmiana ustawień po pull nie zmienia wyniku builda. Nieobecny, gdy dołączenie nie deklaruje ustawień. |
sources | object[] | nie | Przypięcia adresowane treścią plików źródłowych zadeklarowanych przez dołączenie, w kolejności nazw bazowych. Build rekonstruuje źródło odczytywane przez plugin z treści zapisanej w każdym przypięciu, a nie przez bieżący odczyt z hosta, więc wynik builda pozostaje niezmienny przy zmianie pliku źródłowego po pull. Nieobecne, gdy dołączenie nie deklaruje źródeł. |
Dodatkowe właściwości są niedozwolone.
lockfile.mutators[].sources[]
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
content | string | tak | Treść pliku źródłowego, przenoszona dosłownie, aby build zrekonstruował dane wejściowe źródła pluginu z lockfile. |
digest | string | tak | Adres treści zapisanej zawartości, w postaci sha256:, po którym następują 64 małe znaki szesnastkowe. Ponowny pull porównuje plik bazowy z tym skrótem, aby wykryć dryf. Wzorzec: ^sha256:[a-f0-9]{64}$. |
path | string | tak | Nazwa bazowa pliku źródłowego — nigdy bezwzględna ścieżka na hoście, dzięki czemu przypięcie jest przenośne i deterministyczne. |
Dodatkowe właściwości są niedozwolone.
lockfile.plugins[]
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
uri | string | tak | Sama tożsamość artefaktu .wasm pluginu Wasm — ścieżka <pluginType>/<name> (np. governance/aggrega-security-baseline). Pierwszy segment to typ pluginu (provider, linter, pipeline-step, governance, cli, parser, importer); kolejny segment to nazwa pluginu. Typ i nazwa razem tworzą tożsamość pluginu — ta sama nazwa pod dwoma typami oznacza dwa pluginy. Fizyczna lokalizacja pobierania jest wyprowadzana z tej tożsamości i skonfigurowanego rejestru i nigdy nie jest zapisywana w pliku lockfile. |
resolved_version | string | tak | Skrót treści, na który został rozwiązany artefakt Wasm, w postaci sha256:, po którym następuje 64 małych znaków szesnastkowych. Artefakt pluginu jest adresowany treścią, a nie nazwany wersją — plik .wasm jest osadzony bezpośrednio w manifeście pluginu i przypięty skrótem swoich bajtów — więc to pole zapisuje ten skrót, który jest też polem digest poniżej. Tworzy ono slot pamięci podręcznej, z którego build odczytuje artefakt, dlatego nie zawiera /, \ ani .., co postać sha256: już wyklucza. Wzorzec: ^sha256:[a-f0-9]{64}$. |
digest | string | tak | Skrót treści rozwiązanego artefaktu Wasm, w postaci sha256:, po którym następuje 64 małych znaków szesnastkowych — w tej postaci adres treści jest zapisywany wszędzie, gdzie jest porównywany. Wzorzec: ^sha256:[a-f0-9]{64}$. |
manifest_digest | string | nie | Skrót manifestu OCI rozwiązanego artefaktu Wasm, w postaci sha256:, po którym następuje 64 małych znaków szesnastkowych. Podpis zobowiązuje się do tego skrótu; skrót treści digest powyżej jest przenośną tożsamością używaną do przypięcia w pamięci podręcznej i kontroli integralności. Obecny tylko dla artefaktu rozwiązanego z rejestru. Wzorzec: ^sha256:[a-f0-9]{64}$. |
referenced_from | string[] | nie | Dlaczego ten artefakt znajduje się w domknięciu zależności encji Release: odwołanie do każdej encji Plugin, przez którą go osiągnięto, w takiej postaci, w jakiej sekcja entities zapisuje tę encję (np. governance/label-injector:1.0.0). Domyślnie: [] |
signature | VerifiedSignature | nie | Fakt zweryfikowanego podpisu zapisywany, gdy podpis tego pluginu został zweryfikowany podczas pull, według tej samej polityki zaufania danego rejestru co encje katalogu. |
deprecation | DeprecationRecord | nie | Zweryfikowany retroaktywny znacznik wycofania, zapisywany, gdy w czasie pull na tym artefakcie wykryto podpisany, zaufany znacznik wycofania. Znacznik to podpisany referrer OCI wycofywanego artefaktu, dołączony po publikacji bez ponownego publikowania artefaktu. Zapisuje ważność i komunikat znacznika oraz zweryfikowanego sygnatariusza, który go utworzył. Build odczytuje ten fakt i egzekwuje politykę wycofań wyłącznie na podstawie lockfile; nigdy ponownie nie wykrywa ani nie weryfikuje znacznika. |
Dodatkowe właściwości są niedozwolone.
lockfile.providers[]
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
capability | string | tak | Możliwość, dla której to powiązanie wybiera dostawcę — sama nazwa możliwości, którą encja Recipe wiąże przez spec.capability (np. helm, compose). |
plugin | string | tak | Sama tożsamość rozwiązanego pluginu renderującego dostawcy (tożsamość encji Plugin, czyli jej metadata.pluginType i metadata.name połączone ukośnikiem, np. provider/helm). Łączy się po tożsamości z sekcjami plugins i entities, aby uzyskać przypięty skrót i zbiór wersji. |
Dodatkowe właściwości są niedozwolone.
lockfile.release_documents[]
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
digest | string | tak | Skrót treści bajtów pliku Release w chwili ich odczytu podczas rozwiązywania, w postaci sha256:, po którym następuje 64 małych znaków szesnastkowych. Wzorzec: ^sha256:[a-f0-9]{64}$. |
path | string | tak | Ścieżka pliku Release względem katalogu zawierającego encję Release, do której należy ten plik lockfile, z ukośnikami (np. release-prod.yaml, ../shared/base-release.yaml) — nigdy bezwzględna ścieżka hosta, dzięki czemu zapis jest przenośny i deterministyczny. |
Dodatkowe właściwości są niedozwolone.
lockfile.toolchain
Wersje łańcucha narzędzi, który utworzył ten plik blokady: własna wersja kompilatora oraz wersja każdego pluginu podstawowego, który kompilator zawiera. Zapisywane, aby plik blokady pozwalał po fakcie ustalić, który kompilator i które pluginy podstawowe rozwiązały i wyrenderowały build — na to pytanie przypięte sekcje nie zawsze odpowiadają, ponieważ podstawowy plugin dostawcy serwowany z wnętrza pliku binarnego kompilatora pozostaje nieprzypięty i nie ma własnej zapisanej wersji. Tylko wersje: znacznik nigdy nie zapisuje, skąd pochodzą bajty pluginu, więc dwie maszyny, które przypięły to samo domknięcie zależności tym samym kompilatorem, zapisują ten sam znacznik. Nic nie porównuje tej sekcji, nie ostrzega o niej ani nie odmawia buildu z jej powodu, a jej brak w pliku blokady przechodzi bez komunikatu: łańcuch narzędzi nie należy do domknięcia zależności przypinanego przez plik blokady. Z tego samego powodu sekcja jest pomijana w porównaniu identyczności bajtowej między dwoma pobraniami tych samych wejść, na tych samych zasadach co generated_at.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
compiler_version | string | tak | Wersja kompilatora, który zapisał ten plik lockfile, w postaci bez „v”, którą podaje każda powierzchnia Aggrega (1.2.0, nie v1.2.0). Build oznaczony wersją zapisuje tę wersję — build wydania z tagiem zapisuje swój tag — a build bez znacznika wersji zapisuje znacznik (devel), aby pliku lockfile utworzonego przez nieoznaczony kompilator nie wziąć za wynik wydania. Zapisywana jako pojedynczy segment ścieżki, więc nie zawiera /, \ ani ... Wzorzec: ^([^/\\.]|\.[^/\\.])*\.?$. |
core_plugins | object[] | tak | Wersja każdego pluginu podstawowego, który zawiera kompilator, po jednym wpisie na plugin, uporządkowane według współrzędnej pluginu. Plugin podstawowy jest publikowany pod tagiem samego kompilatora w tej samej wersji, więc wersje te są takie same niezależnie od tego, czy kompilator dostarczył plugin z siebie, czy pobrał go z rejestru — dzięki temu znacznik nie zawiera szczegółów zależnych od maszyny. Pusta dla buildu, który nie zawiera pluginów podstawowych. Domyślnie: [] |
Dodatkowe właściwości są niedozwolone.
lockfile.toolchain.core_plugins[]
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
plugin | string | tak | Współrzędna pluginu podstawowego — tożsamość <pluginType>/<name> encji Plugin (np. provider/helm), ta sama tożsamość, którą sekcje providers i mutators nazywają plugin. |
version | string | tak | Wersja tego pluginu podstawowego, w postaci bez „v”, którą podaje każda powierzchnia Aggrega. Zapisywana jako pojedynczy segment ścieżki, więc nie zawiera /, \ ani ... Wzorzec: ^([^/\\.]|\.[^/\\.])*\.?$. |
Dodatkowe właściwości są niedozwolone.
lockfile.verdict_inputs[]
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
plugin | string | tak | Napisany przez autora URI pluginu dołączenia werdyktu, tak jak zapisano go w .aggrega-config.yaml plugins.governance (np. governance/aggrega-security-baseline:1.0.0). Wskazuje, do którego dołączenia należą zapisane dane wejściowe reguł; plugin werdyktu jest buforowany, a nie przypinany, więc nie ma wpisu w sekcjach plugins / entities, z którym można by go połączyć. |
role | string (enum) | tak | Rola werdyktu, z którą powiązane jest to dołączenie — ir-verdict (podczas analizy statycznej, na grafie IR) lub render-verdict (podczas renderowania, na wyrenderowanych artefaktach). Rozróżnia ten sam plugin dołączony na obu etapach werdyktu, każdy potencjalnie z własnymi danymi wejściowymi reguł. Dozwolone wartości: "ir-verdict", "render-verdict" |
sources | object[] | nie | Skróty treści zadeklarowanych przez dołączenie plików danych wejściowych reguł, w kolejności nazw bazowych. Nieobecne, gdy dołączenie nie deklaruje źródeł. |
Dodatkowe właściwości są niedozwolone.
lockfile.verdict_inputs[].sources[]
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
digest | string | tak | Adres treści bajtów pliku danych wejściowych reguł w chwili pull, w postaci sha256:, po którym następuje 64 małych znaków szesnastkowych. Ponowny pull oblicza go od nowa, więc zmieniony plik reguł ujawnia się jako różnica w pliku lockfile. Wzorzec: ^sha256:[a-f0-9]{64}$. |
path | string | tak | Nazwa bazowa pliku danych wejściowych reguł — nigdy bezwzględna ścieżka hosta, dzięki czemu zapis jest przenośny i deterministyczny. |
Dodatkowe właściwości są niedozwolone.
Definicje
DeprecationRecord
Zweryfikowany retroaktywny znacznik wycofania, zapisywany, gdy w czasie pull na tym artefakcie wykryto podpisany, zaufany znacznik wycofania. Znacznik to podpisany referrer OCI wycofywanego artefaktu, dołączony po publikacji bez ponownego publikowania artefaktu. Zapisuje ważność i komunikat znacznika oraz zweryfikowanego sygnatariusza, który go utworzył. Build odczytuje ten fakt i egzekwuje politykę wycofań wyłącznie na podstawie lockfile; nigdy ponownie nie wykrywa ani nie weryfikuje znacznika.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
message | string | tak | Czytelny dla człowieka komunikat o wycofaniu niesiony przez znacznik — zazwyczaj wskazówka dotycząca migracji. |
severity | string (enum) | tak | Poziom ważności znacznika, uporządkowany: warning < error < retracted. Kompilacja zostaje zatrzymana, gdy ten poziom osiąga lub przekracza skonfigurowany próg zatrzymania, a w przeciwnym razie emituje ostrzeżenie. Dozwolone wartości: "warning", "error", "retracted" |
signer | VerifiedSignature | nie | Zweryfikowany podpisujący znacznika, zapisany w taki sam sposób jak podpisujący podpisu artefaktu: podmiot/wystawca certyfikatu w trybie bezkluczowym lub odcisk przypiętego klucza w trybie z kluczem. Znacznik jest samodzielnym podpisanym artefaktem, więc jego podpisujący ma ten sam kształt co podpis artefaktu — a bundle_digest wskazuje tu własny pakiet podpisu znacznika, a nie pakiet wycofanego artefaktu. |
Dodatkowe właściwości są niedozwolone.
ExternalInput
Pojedyncze przypięte wejście zewnętrzne: URL, którego zażądało renderowanie, przypięcie SHA-256 wskazujące jego bajty w adresowanym treścią magazynie wejść (sha256/<digest>), rozmiar danych oraz pochodzenie konsumentów, którzy go wymagali. Przypięcie jest rozstrzygające — przypięty URL jest zawsze serwowany z magazynu, a ponowne uzupełnienie magazynu jest weryfikowane względem tego skrótu, zanim bajty trafią do renderowania.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
required_by | string[] | tak | Pochodzenie — miejsca renderowania, które zażądały tego wejścia. Sortowane i deduplikowane przez program zapisujący lockfile. |
sha256 | string | tak | Przypięcie SHA-256 zapisane małymi literami szesnastkowymi. Dla wejścia https jest to skrót bajtów danych; dla wejścia oci — skrót manifestu, na który rozwiązała się referencja. Wskazuje obiekt blob magazynu pod sha256/<digest>. Wzorzec: ^[0-9a-f]{64}$. |
size | integer | tak | Rozmiar przypiętych danych w bajtach. Liczba bajtów nigdy nie jest ujemna. Minimum: 0. |
url | string | tak | URL wejścia w postaci zapisanej w miejscu renderowania — klucz wyszukiwania dopasowujący żądanie w czasie renderowania do jego przypięcia. |
Dodatkowe właściwości są niedozwolone.
LibraryEntry
Wspólny kształt wpisów schema_libraries, mapping_libraries, workload_libraries i artifact_libraries. Lista consumers odwzorowuje relację w grafie katalogu — która encja katalogu odwołuje się do których fragmentów <entry-name> tej biblioteki — co umożliwia ustrukturyzowane porównania wpływu, gdy zmienia się skrót biblioteki. Biblioteka jest artefaktem OCI jak każdy inny, więc zapisuje te same zweryfikowane fakty co encja katalogu: skrót manifestu, którego dotyczy jej podpis, sam zweryfikowany podpis oraz ewentualny zweryfikowany znacznik wsteczny wycofania wykryty podczas pobierania.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
uri | string | tak | Kanoniczny URI encji biblioteki. |
resolved_version | string | tak | Konkretna wersja rozwiązana podczas pobierania (wybór wersji minimalnej w grafie zależności bibliotek) — własna wersja biblioteki. Zapisywana jako pojedynczy segment ścieżki, ponieważ tworzy slot pamięci podręcznej, z którego kompilacja odczytuje bibliotekę, więc nie zawiera /, \ ani ..: wartość wychodząca poza katalog pamięci podręcznej wskazywałaby lokalizację poza nim. Wzorzec: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | tak | Skrót treści rozwiązanego artefaktu biblioteki w postaci sha256:, po którym następuje 64 małych znaków szesnastkowych — forma, w jakiej adres treści jest zapisywany wszędzie tam, gdzie jest porównywany. Wzorzec: ^sha256:[a-f0-9]{64}$. |
manifest_digest | string | nie | Skrót manifestu OCI rozwiązanego artefaktu biblioteki w postaci sha256:, po którym następuje 64 małych znaków szesnastkowych. Podpis dotyczy tego skrótu; powyższy skrót treści digest jest przenośną tożsamością używaną do przypięcia w pamięci podręcznej i kontroli integralności. Obecny tylko dla biblioteki rozwiązanej z rejestru. Wzorzec: ^sha256:[a-f0-9]{64}$. |
signature | VerifiedSignature | nie | Fakt zweryfikowanego podpisu zapisany, gdy podpis tej biblioteki został zweryfikowany podczas pobierania, względem tej samej polityki zaufania dla rejestru co encje katalogu. |
deprecation | DeprecationRecord | nie | Zweryfikowany wsteczny znacznik wycofania wykryty na tej bibliotece podczas pobierania. Kompilacja go zgłasza i — jeśli obszar roboczy skonfigurował próg zatrzymania, który zapisany poziom ważności osiąga — zatrzymuje się, dzięki czemu biblioteka wycofana po przypięciu wersji jest sygnalizowana przy każdej kompilacji, a nie tylko przy wyborze wersji, który jawnie przypięta wersja pomija. |
consumers | object[] | nie | Rekordy określające, która encja katalogu odwołuje się do tej biblioteki i do których fragmentów <entry-name>. Odwzorowują zbieżność: wielu konsumentów na bibliotekę, z których każdy może odwoływać się do wielu fragmentów. Każdy rekord zawiera URI konsumenta oraz zbiór fragmentów, które ten konsument pobiera. Domyślnie: [] |
Dodatkowe właściwości są niedozwolone.
LibraryEntry.consumers[]
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
consumer_uri | string | tak | Kanoniczny URI encji katalogu, która odwołuje się do tej biblioteki: encja Component lub Feature dla biblioteki schematów, encja Recipe lub FeatureRecipe dla biblioteki mapowań, obciążeń lub artefaktów albo inna biblioteka tego samego rodzaju, której wpisy odwołują się do tej. |
fragments | string[] | tak | Zbiór fragmentów <entry-name>, do których ten konsument odwołuje się w bibliotece (np. ["#/schemas/PortSpec", "#/schemas/EndpointSpec"]). Kolejność jest kanonizowana leksykograficznie przez program zapisujący. |
Dodatkowe właściwości są niedozwolone.
SourceArtifactEntry
Pojedyncze przypięcie artefaktu źródłowego: tożsamość {kind, url, chart, module_subdir, pinned_version}, skrót zawartości weryfikujący pobranie, kanoniczny typ nośnika oraz ustrukturyzowane odwołania zwrotne do każdej encji katalogu, która została rozwiązana do tego artefaktu. chart i module_subdir to dwa elementy selektora — każdy z nich wskazuje to, czego nie wskazuje sam URL, dla rodzajów, które tego wymagają.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
kind | enum | tak | Rodzaj źródła. Określa, który adapter rozwiązał artefakt i jakiego typu nośnika się oczekuje. terraform-module-oci należy do zbioru, ale nie obsługuje go żaden adapter źródła: encja Recipe lub FeatureRecipe, która go wskazuje, jest odrzucana już przy odczycie. Dozwolone wartości: "helm-oci-chart", "helm-https-chart", "compose-https-fragment", "git-repository", "terraform-module-oci" |
url | string | tak | Autorski URL — URL tożsamości w postaci zapisanej w spec.source.url encji Recipe. Dla helm-https-chart jest to katalog główny repozytorium (forma repo-root) lub bezpośredni plik .tgz (forma bezpośrednia), dokładnie tak, jak zapisano; build odtwarza ten sam URL offline, więc jest to stabilna tożsamość, według której kluczowane jest przypięcie. Dla git-repository jest to URL repozytorium, które można sklonować. Dla helm-oci-chart jest to odwołanie do rejestru. Dla compose-https-fragment jest to URL HTTPS fragmentu. Rozwiązana lokalizacja artefaktu dla źródła helm w formie repo-root jest zapisywana osobno w resolved_url: jako informacja o pochodzeniu. |
chart | string | nie | Nazwa chartu dla źródła helm w formie repo-root (spec.source.chart encji Recipe), część tożsamości {kind, url, chart, module_subdir, pinned_version}, dzięki czemu dwa charty serwowane z jednego katalogu głównego repozytorium w tej samej wersji są przypinane do odrębnych wpisów. Nieobecna dla bezpośredniego pliku .tgz oraz źródła OCI, compose lub git, z których żadne nie wybiera chartu w obrębie URL. |
module_subdir | string | nie | Katalog w repozytorium pochodzącym z git, który stanowi artefakt (spec.source.module_subdir encji Recipe), część tożsamości {kind, url, chart, module_subdir, pinned_version}, dzięki czemu dwa katalogi jednego repozytorium w tym samym commicie są przypinane do odrębnych wpisów. Nieobecny, gdy artefaktem jest całe repozytorium, oraz dla każdego rodzaju, który dociera do artefaktu przez URL, a nie przez zejście do klonu. |
pinned_version | string | tak | Konkretna wersja przypięta podczas pobierania. Dla rodzajów helm-* jest to wersja chartu. Dla git-repository jest to commit, do którego rozwiązało się autorskie odwołanie (NIE pierwotne odwołanie tag/branch — jest ono zapisywane w requested_ref: w każdym wpisie referenced_by:, ilekroć encja Recipe zawiera spec.source.ref:). Build odnajduje ten wpis na podstawie tego, co zapisano w encji Recipe: autorskiego ref:, jeśli istnieje, dopasowanego do zapisanego requested_ref:, a w przeciwnym razie tej przypiętej wartości — dzięki temu encja Recipe wskazująca tag rozwiązuje się do commitu, przy którym ten tag został przypięty, bez umieszczania commitu w encji Recipe. Zapisywana jako pojedynczy segment ścieżki, ponieważ tworzy slot pamięci podręcznej, z którego build odczytuje artefakt, więc nie zawiera /, \ ani ... Wzorzec: ^([^/\\.]|\.[^/\\.])*\.?$. |
resolved_url | string | nie | Wyłącznie informacja o pochodzeniu: konkretna lokalizacja artefaktu, do której autorski URL rozwiązał się podczas pobierania. Dla źródła helm w formie repo-root jest to bezpośredni URL pliku .tgz, do którego indeks repozytorium rozwiązał chart+wersję; jest zapisywana na potrzeby diagnostyki i NIE jest częścią tożsamości artefaktu. Nieobecna, gdy rozwiązana lokalizacja jest równa autorskiemu URL (bezpośredni plik .tgz, źródło OCI, compose lub git). |
digest | string | tak | Skrót zawartości rozwiązanego archiwum .tar.gz w postaci sha256:, po którym następuje 64 małych znaków szesnastkowych. Weryfikacja podczas budowania odczytuje bajty slotu pamięci podręcznej, ponownie oblicza skrót i porównuje go z tym polem; niezgodność zatrzymuje build ze zgłoszeniem niezgodności skrótu treści. Wzorzec: ^sha256:[a-f0-9]{64}$. |
manifest_digest | string | nie | Skrót manifestu OCI rozwiązanego artefaktu w postaci sha256:, po którym następuje 64 małych znaków szesnastkowych. Manifest jest niezależnym źródłem zaufania, względem którego weryfikowane jest archiwum w pamięci podręcznej; powyższy skrót zawartości digest to przenośna tożsamość używana do przypięcia w pamięci podręcznej i sprawdzenia integralności. Obecny tylko dla źródła dystrybuowanego przez OCI (helm-oci-chart). Wzorzec: ^sha256:[a-f0-9]{64}$. |
mediatype | string | tak | Kanoniczny typ nośnika ogłoszony przez rejestr (lub domyślny dla danego rodzaju w przypadku rodzajów bez metadanych rejestru). Zapisywany na potrzeby diagnostycznej informacji o pochodzeniu. |
referenced_by | SourceArtifactReference[] | tak | Encje katalogu, które zostały rozwiązane do tego artefaktu, posortowane według (uri, field), aby wynik był deterministyczny. Wpis istnieje tylko dlatego, że pobrała go encja Recipe lub FeatureRecipe, więc lista nigdy nie jest pusta. Co najmniej 1 wpis. |
Dodatkowe właściwości są niedozwolone.
SourceArtifactReference
Pojedyncze odwołanie zwrotne encja katalogu → artefakt źródłowy. entity + uri razem identyfikują encję katalogu; field wskazuje ścieżkę po stronie źródła w specyfikacji encji, w której zadeklarowano artefakt. Opcjonalne requested_ref: zachowuje autorskie spec.source.ref: encji Recipe i jest zapisywane, ilekroć encja Recipe je zawiera (tagi/gałęzie git-repository → SHA commitu).
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
entity | enum | tak | Rodzaj encji katalogu, która zawiera to odwołanie zwrotne. Dozwolone wartości: "recipe", "feature_recipe" |
uri | string | tak | Kanoniczny URI encji Recipe lub FeatureRecipe (np. hub.aggrega.ai/recipe/helm/mariadb-bitnami:1.0.0). |
field | string | tak | Ścieżka po stronie źródła w specyfikacji encji, w której zadeklarowano artefakt. Wartością jest spec.source. |
requested_ref | string | nie | Opcjonalne — autorskie spec.source.ref: encji Recipe, zapisywane, ilekroć encja Recipe je zawiera. Dla encji Recipe typu git-repository z ref: v1.0.0 pole to zachowuje "v1.0.0", a pinned_version: przechowuje commit, do którego to odwołanie się rozwiązało. Nieobecne, gdy encja Recipe nie zawiera ref:, co dotyczy każdego rodzaju, którego resolver przypina autorską wersję dosłownie (helm-, compose-). Pełni ono jednocześnie dwie funkcje, a bezwarunkowe zapisywanie go sprawia, że się one nie wykluczają. Build łączy się po nim, aby odnaleźć ten wpis na podstawie encji Recipe wskazującej odwołanie, a nie commit. Z kolei pull, który nie jest aktualizacją, utrzymuje każde zapisane odwołanie przy jego przypiętej wersji: odwołanie, które przesunęło się w zdalnym repozytorium, zatrzymuje uruchomienie, zamiast zostać przyjęte. |
Dodatkowe właściwości są niedozwolone.
VerifiedSignature
Fakt zweryfikowanego podpisu, zapisywany, gdy podpis artefaktu został zweryfikowany w czasie pobierania względem polityki zaufania rejestru, z którego artefakt rozwiązano. Każdy artefakt, który można podpisać — encja katalogu, biblioteka, Wasm plugin — zapisuje go w ten sam sposób, ponieważ wszystkie są weryfikowane jedną ścieżką, a nie osobną dla każdego rodzaju. Zapisuje tryb weryfikacji, dopasowaną tożsamość/wystawcę w trybie bezkluczowym (keyless) oraz adresowany treścią skrót pakietu podpisu w pamięci podręcznej treści. Build nie uruchamia weryfikacji ponownie. Zanim cokolwiek zostanie wyrenderowane, odczytuje ten fakt w każdym wpisie, z którego buduje, w każdej sekcji: ponownie oblicza skrót pakietu z pamięci podręcznej i porównuje wynik z bundle_digest, zatrzymując się, gdy obiektu brakuje lub się różni; a w przypadku wpisu dostarczonego przez pamięć podręczną treści odczytuje z tego pakietu, dla którego artefaktu wykonano podpis, i zatrzymuje się, gdy wykonano go dla innego artefaktu niż ten, który build odczytał dla wpisu — dzięki temu signature skopiowany z jednego wpisu do innego zostaje odrzucony niezależnie od wymagań dotyczących podpisu. Build nie weryfikuje żadnego podpisu, więc pakietu zapisanego ręcznie w pamięci podręcznej i wystawionego dla artefaktu danego wpisu nie da się odróżnić od pakietu zweryfikowanego przez pull. Ponadto gdy konfiguracja zaufania przestrzeni roboczej wymaga podpisu dla wpisu dostarczonego przez pamięć podręczną treści — jest to wymaganie, które pull stosuje przy pobieraniu artefaktu, więc pominięcia i rejestr advisory, które pozwalają operacji pull przyjąć artefakt bez podpisu, pozwalają też buildowi przyjąć jego wpis — wpis bez tego faktu zatrzymuje build. Wpis odczytany z katalogu, z kopii wbudowanej w plik binarny kompilatora lub z miejsca obok encji Release nigdy nie podlega temu wymaganiu.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
bundle_digest | string | tak | Skrót SHA-256 obiektu pakietu podpisu w pamięci podręcznej, w postaci sha256:, po którym następuje 64 małe znaki szesnastkowe. Nazywa obiekt w pamięci podręcznej, więc tworzy ścieżkę i nie zawiera /, \ ani .. — co postać sha256: już wyklucza — a we wpisie dowolnej sekcji jest wartością, z którą build porównuje ponownie obliczony skrót tego obiektu. Wzorzec: ^sha256:[a-f0-9]{64}$. |
identity | string | nie | Zweryfikowany podpisujący: podmiot certyfikatu podpisującego dla podpisu bezkluczowego lub keyed:sha256:, po którym następuje SHA-256 tekstu PEM przypiętego klucza publicznego, dla podpisu kluczowego. |
issuer | string | nie | Zweryfikowany wystawca OIDC dla podpisu bezkluczowego. Pusty dla podpisu kluczowego. |
mode | string (enum) | tak | Tryb weryfikacji, który dopuścił podpis. Dozwolone wartości: "keyless", "keyed" |
Dodatkowe właściwości są niedozwolone.