Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

Schema del socket Wasm di policy di Aggrega

Riferimento generato. Non modificarlo a mano — rigeneralo a partire dal JSON Schema pubblicato.

Id dello schema: https://aggrega.ai/schemas/wasm-policy-v1beta1.schema.json

Le forme di trasmissione che un plugin di governance associato con un ruolo di verdetto consuma — PolicyInput nel ruolo ir-verdict, RenderPolicyInput nel ruolo render-verdict — ed emette (PolicyOutput). Un verdetto di gravità halt arresta la build con una diagnostica in fase di build; un verdetto warn o info viene riportato e la build prosegue. Il grafo di input della fase IR è il grafo IR completo, agnostico rispetto alle capacità, referenziato da ir-v1beta1.schema.json anziché ridichiarato qui, così il plugin di policy vede lo stesso dettaglio di nodi, archi e associazioni che vede il compilatore; gli autori di plugin seguono la versione dello schema IR. L’input della fase di rendering porta i file di output renderizzati al posto del grafo. I tipi di payload Go, Rust e TypeScript sono generati da questo schema nei pacchetti dell’ABI dei plugin, così i tre linguaggi leggono e scrivono lo stesso formato di trasmissione; un guest li importa da quei pacchetti, oppure tramite il suo kit per plugin dove il kit li riesporta.

Una delle forme seguenti

  • PolicyInput
  • RenderPolicyInput
  • PolicyOutput

Definizioni

PolicyInput

Il payload che l’analisi statica passa al socket di policy: il grafo IR completo (la stessa forma che emette il Topology Builder) più i percorsi di instradamento precalcolati che l’analizzatore enumera accanto a esso.

ProprietàTipoObbligatoriaDescrizione
graphIRGraphsìIl grafo IR completo, agnostico rispetto alle capacità, con un’unica fonte in ir-v1beta1.schema.json. Il plugin di policy ragiona sul dettaglio completo di nodi, archi e associazioni anziché su una proiezione ristretta.
precalculated_pathsPrecalculatedPath[]sìPercorsi di instradamento che l’analizzatore ha enumerato in anticipo, così le policy possono ragionare sulla raggiungibilità senza ripercorrere il grafo.
sourcesPolicySource[]noFile di definizione che l’host legge in fase di compilazione e passa al plugin alla lettera, come elenco ordinato per percorso. L’host legge i byte come contenuto opaco e non li analizza. Assente quando l’associazione non dichiara alcun sorgente.
settingsobjectnoUn oggetto di impostazioni in forma libera che l’host passa al plugin alla lettera. L’host non ne analizza il contenuto né agisce su di esso. Assente quando l’associazione non dichiara alcuna impostazione.

Non sono consentite proprietà aggiuntive.

PolicyOutput

La forma di risposta che il plugin di policy emette: i verdetti scattati durante la valutazione, una diagnostica per ogni verdetto scattato. Una regola che consente non emette nulla, quindi un array results vuoto significa che non è scattato alcun verdetto.

ProprietàTipoObbligatoriaDescrizione
resultsDiagnostic[]sìI verdetti scattati, una diagnostica ciascuno, nell’ordine in cui il plugin li emette. Vuoto quando non è scattato alcun verdetto.
errorstringnoUn messaggio di errore impostato quando il guest è stato eseguito ma non ha potuto completare l’operazione; assente in caso di successo. È distinto da qualsiasi diagnostica portata dall’output: le diagnostiche riportano problemi trovati durante un’esecuzione che ha comunque prodotto un risultato, mentre error riporta che l’operazione stessa non è stata completata. L’host presenta un errore presente come un’invocazione del plugin non riuscita.

Non sono consentite proprietà aggiuntive.

RenderPolicyInput

Il payload che riceve un plugin di governance associato con il ruolo render-verdict: i file di output renderizzati su cui ragiona la policy, al posto del grafo IR.

ProprietàTipoObbligatoriaDescrizione
artifactsRenderedArtifact[]sìI file di output renderizzati su cui ragiona la policy, come elenco ordinato per percorso, così il formato di trasmissione è identico byte per byte tra esecuzioni con input identico.
sourcesPolicySource[]noFile di definizione che l’host legge in fase di compilazione e passa al plugin alla lettera, come elenco ordinato per percorso. L’host legge i byte come contenuto opaco e non li analizza. Assente quando l’associazione non dichiara alcun sorgente.
settingsobjectnoUn oggetto di impostazioni in forma libera che l’host passa al plugin alla lettera. L’host non ne analizza il contenuto né agisce su di esso. Assente quando l’associazione non dichiara alcuna impostazione.

Non sono consentite proprietà aggiuntive.

RenderedArtifact

Un file di output renderizzato: il suo percorso e il contenuto renderizzato in quel percorso.

ProprietàTipoObbligatoriaDescrizione
pathstringsìIl percorso di output del file renderizzato, relativo alla radice di rendering.
contentstringsìIl contenuto renderizzato in questo percorso.
treeanynoL’albero strutturato analizzato di questo artefatto, presente quando l’host ha analizzato il contenuto prima di passarlo al plugin — la vista JSON canonica di un formato sorgente che il plugin non legge nativamente (un artefatto HCL analizzato in JSON, per esempio). Il livello superiore può essere un oggetto, un array o uno scalare, in corrispondenza della forma propria del documento analizzato. Assente quando l’host non ha analizzato l’artefatto, nel qual caso il plugin legge direttamente il contenuto nativo. L’host fa passare l’albero in modo opaco, portandolo alla lettera senza interpretarne il contenuto.
formatstringnoIl formato in cui l’artefatto è stato renderizzato, presente quando il provider che lo ha prodotto lo ha dichiarato. Assente quando il provider che lo ha prodotto non ha dichiarato alcun formato.

Non sono consentite proprietà aggiuntive.

PolicySource

Un file di definizione passato al plugin: il suo percorso con il nome base e il contenuto del file. Entrambi sono portati alla lettera; l’host non analizza il contenuto.

ProprietàTipoObbligatoriaDescrizione
pathstringsìIl nome base del file sorgente. L’host fornisce solo il nome base, mai un percorso assoluto dell’host, così il formato di trasmissione è portabile e deterministico.
contentstringsìIl contenuto del file sorgente, portato alla lettera come stringa opaca.

Non sono consentite proprietà aggiuntive.

PrecalculatedPath

Un percorso di instradamento enumerato in anticipo che l’analizzatore materializza, così le regole di policy possono ragionare sulla raggiungibilità senza ripercorrere il grafo.

ProprietàTipoObbligatoriaDescrizione
path_idstringsìIdentificatore stabile di questo percorso; deterministico tra esecuzioni con input identico.
nodesstring[]sìSequenza ordinata degli ID dei nodi che il percorso attraversa, dall’origine al terminale.
attached_featuresstring[]sìUnione ordinata alfabeticamente degli URI di tipo di Feature associati a qualsiasi nodo lungo il percorso. Semantica di appartenenza a un insieme: una Feature compare una sola volta anche se più nodi la portano. Vuota quando nessun nodo lungo il percorso porta alcuna associazione di Feature.

Non sono consentite proprietà aggiuntive.