Vai al contenuto principale

Flusso di revisione

Come rivedere un inventario di terze parti prima della pubblicazione

Una sequenza pratica per ingegneria e conformità, dall'importazione alla pubblicazione approvata, senza saltare barriere.

Ultimo aggiornamento: 2 luglio 2026

La divulgazione delle licenze di terze parti fallisce quando l'inventario viene importato una volta e mai rivisto. Devi far corrispondere ogni componente a una licenza identificata, allegare il testo completo della licenza, e bloccare la pubblicazione finché un essere umano non approva quello che la pagina di conformità rappresenterà.

Questo flusso di lavoro si applica sia che tu parta da lockfile npm, SBOM CycloneDX, esportazioni FOSSA o Snyk, o fogli di calcolo manuali. I passaggi sono gli stessi: importa, rivedi per componente, pubblica con barriere, mantieni a ogni release.

  1. Importa dagli input rilasciati

    Lockfile, SBOM o esportazioni di strumenti dal branch di release. Ogni riga parte non rivista.

  2. Rivedi ogni componente

    Conferma la licenza, allega il testo completo, fai l'escalation dei casi di copyleft e dei conflitti.

  3. Pubblica con barriere

    Nessuna riga non rivista, URL stabile, esportazioni dalla stessa istantanea.

  4. Mantieni a ogni release

    I controlli di deriva segnalano le modifiche; rivedi e ripubblica prima che gli acquirenti se ne accorgano.

Perché la revisione conta più dell'importazione?

Perché l'importazione ti dice solo cosa c'è, non se i metadati di licenza sono affidabili: i registri dei pacchetti etichettano male le licenze, i fornitori cambiano le condizioni, e le dipendenze transitive introducono copyleft che non ti aspettavi. Un file di inventario di terze parti è un input, non una pagina di conformità finita.

La portata è documentata, ed è esattamente l'insieme di casi che l'importazione automatica non può risolvere da sola.

Le barriere di revisione esistono perché tu non possa pubblicare un URL di conformità delle licenze che dichiara più di quanto il tuo team abbia verificato. Gli acquisti e i revisori trattano la pagina pubblica come la tua dichiarazione degli obblighi di licenza di terze parti.

delle codebase controllate presenta conflitti di licenza

56%

Black Duck 2025 OSSRA.

contiene open source senza licenza o con licenza personalizzata

33%

Le righe che un essere umano deve valutare prima che qualsiasi pagina possa dichiararle.

Passaggio 1: importa dagli input rilasciati

Parti dagli artefatti legati alla build che rilasci: package-lock.json, pnpm-lock.yaml, yarn.lock, go.mod, Cargo.lock, pom.xml, Gemfile.lock, uno SBOM CycloneDX dalla CI, o esportazioni dal tuo strumento SBOM esistente. Contrassegna ogni riga come da rivedere finché qualcuno non conferma la licenza.

Circoscrivi l'importazione a un prodotto. Le aziende multi-prodotto hanno bisogno di pagine di conformità delle licenze separate, o sezioni chiaramente separate, per ogni prodotto rilasciato. Mescolare gli inventari crea errori di divulgazione.

  • Importa lockfile o SBOM dal branch di release, non da main se diverge.
  • Includi font, icone, SDK e asset incorporati richiesti dalla tua policy.
  • Segnala i duplicati e unisci le voci che si riferiscono allo stesso componente.
  • Registra la data di importazione e l'hash del file sorgente per l'audit trail.
  • Non pubblicare automaticamente. Ogni voce parte non rivista.

Passaggio 2: rivedi ogni componente

Per ogni riga, conferma che l'identificatore di licenza corrisponda all'uso reale, non solo ai metadati di package.json. Leggi i fattori scatenanti del copyleft. Allega il testo completo della licenza. Documenta esplicitamente le esclusioni.

I revisori si concentrano su GPL, LGPL, AGPL, SDK proprietari e componenti con dati di licenza mancanti o in conflitto. Quelle righe bloccano la pubblicazione finché non vengono risolte.

  • Fai corrispondere la licenza alla fonte: file LICENSE del repository, accordo con il fornitore, o identificatore SPDX confermato da un essere umano.
  • Aggiungi il testo completo della licenza al registro prima di contrassegnarlo come approvato.
  • Segnala copyleft, copyleft di rete (AGPL) e licenze personalizzate per la revisione del legale o dell'ingegneria senior.
  • Risolvi i conflitti (il registro dice MIT, il repository dice Apache) prima di approvare.
  • Documenta i componenti esclusi dal prodotto rilasciato e il perché.
  • Richiedi un secondo approvatore per le licenze ad alto rischio se la tua policy ne definisce uno.

Passaggio 3: pubblica la pagina di conformità

Pubblica solo quando le barriere sono superate: nessuna riga non rivista, testo completo della licenza allegato, ambito del prodotto chiaro, URL stabile. La pagina di conformità delle licenze pubblica è gli stessi dati delle tue esportazioni. Un unico inventario rivisto, output multipli.

Le pagine di divulgazione delle licenze di terze parti dovrebbero caricarsi senza autenticazione, elencare i componenti chiaramente, e includere il testo completo delle licenze che gli acquisti possono cercare e copiare. È questo che cercano le revisioni enterprise.

  • Blocca la pubblicazione se un componente in ambito manca del testo di licenza approvato.
  • Genera l'URL pubblico e verifica in incognito prima di condividere esternamente.
  • Esporta pacchetti JSON, di attribuzione e di divulgazione dalla stessa istantanea approvata.
  • Registra chi ha approvato la pubblicazione e a quale tag di release corrisponde.

Passaggio 4: mantieni a ogni release

La conformità delle licenze non è un'operazione da fare una volta sola. Nuove dipendenze, aggiornamenti di versione e cambi di licenza arrivano a ogni sprint. I controlli di deriva confrontano i lockfile o gli SBOM attuali con la tua ultima pubblicazione approvata e segnalano le differenze prima che i clienti se ne accorgano.

Quando l'inventario cambia, riesegui le barriere di revisione. Aggiorna la pagina di conformità delle licenze. Invia gli URL aggiornati agli acquisti solo quando la nuova pubblicazione è approvata, non quando l'importazione termina.

  • Esegui controlli della pipeline o CI su pull request, tag o release.
  • Segnala i nuovi pacchetti non rivisti prima della release, secondo la tua policy.
  • Approva di nuovo i componenti copyleft quando il collegamento o il modello di distribuzione cambia.
  • Mantieni un audit trail: eventi di importazione, revisione, pubblicazione, deriva.

Cookie su sourcetrust.dev

Utilizziamo cookie essenziali per la sicurezza (ad esempio per prevenire abusi nella scansione del sito e nel modulo di richiesta della demo). Con il tuo consenso, utilizziamo anche analitiche e diagnostica opzionali (Google Tag Manager su questo sito e l'SDK browser di Sentry nell'applicazione SourceTrust quando configurato). Consulta la nostra cookie policy.