Sicurezza di Pub
Dartastic Pub assegna un punteggio a ogni pacchetto che pubblica, e applica la policy di sicurezza della sua organizzazione a ogni pacchetto che serve, compresi quelli pubblici. Questa pagina spiega i punteggi, le policy, cosa significa un rifiuto e cosa fare.
La scheda « Scores »
La scheda Scores di ogni pacchetto sul suo Dartastic Pub mostra due valori. Dopo la pubblicazione di una versione, Dartastic Pub analizza l’ultima versione stabile e l’ultima prerelease del pacchetto in un worker isolato senza accesso a internet.
- Pub points: il report da 160 punti di pana, lo stesso che mostra pub.dev. Una riga è diversa: la riga della licenza è superata con una vera licenza di qualsiasi tipo, perché una licenza commerciale è quella giusta per il codice privato. Una licenza mancante, vuota o segnaposto continua a non superarla, e la scheda indica che la riga è stata modificata.
- Security Score: da 0 a 100 con un voto, per ciò che pana non controlla. Ogni controllo mostra cosa ha esaminato, cosa ha trovato e come correggerlo.
Quando un’analisi non riesce a terminare (ha esaurito la memoria o il tempo, oppure una dipendenza non è stata risolta), la scheda lo dice e spiega perché, invece di mostrare un punteggio basso.
I controlli del Security Score
| Controllo | Punti | Cosa esamina |
|---|---|---|
| Known advisories | 30 | Avvisi di sicurezza noti su questa versione e su ogni pacchetto a cui si è risolta. |
| Secrets in the archive | 20 | Token, chiavi e file di credenziali lasciati nell’archivio. Chi può leggere il pacchetto vede che tipo è stato trovato; solo i suoi amministratori vedono dove. |
| Review verdict | 10 | L’esito di una revisione di sicurezza su questa versione. |
| Binaries and build hooks | 15 | Binari nativi e build hook nell’archivio, ognuno registrato con il suo sha256. Ottengono questi punti una volta revisionati e consentiti. FFI da solo non li toglie. |
| Publisher and provenance | 15 | Chi pubblica il pacchetto, e se è cambiato. |
| Same uploader as the last release | 5 | Se la persona che ha caricato questa versione ha caricato anche quella precedente. |
| Release age | 5 | Se la release ha almeno 7 giorni. |
- Un controllo senza elementi su cui basarsi viene escluso: il punteggio è calcolato in proporzione sui controlli eseguiti, e la scheda elenca quelli che non sono stati eseguiti. Non viene mai contato come superato.
- Voti: A da 90, B da 80, C da 70, D da 60, F sotto 60. A e B appaiono in blu, C in giallo, D e F in rosso.
- Una versione in quarantena o bloccata ottiene 0. Un amministratore può impostare a mano l’uno o l’altro punteggio; la scheda allora lo indica, e il punteggio calcolato resta registrato.
- Un punteggio riporta ciò che è stato controllato. Non promette che un pacchetto sia sicuro.
La policy di sicurezza della sua organizzazione
Ogni organizzazione ha una policy, Standard a meno che un amministratore non la cambi. Decide quanto aspettano le nuove versioni pubbliche e cosa succede a una versione segnalata in revisione.
| Policy | Nuove versioni pubbliche | Una versione segnalata in revisione |
|---|---|---|
| MonitorVisibilità completa, nessuna interruzione | Servite subito | Servita e conteggiata |
| StandardProtezione equilibrata per i team in produzione | Attesa di 3 giorni | Servita, e segnalata nella pagina del pacchetto |
| StrictMassimo controllo per ambienti regolamentati | Attesa di 7 giorni, e attesa di una persona finché una revisione è aperta | Non servita |
I pacchetti della sua organizzazione non aspettano mai e non vengono mai trattenuti per una revisione. Nessuna policy serve una versione in quarantena o bloccata.
Le nuove versioni pubbliche aspettano
Una versione pubblica più recente del limite della sua policy viene esclusa dalle versioni servite dal suo Dartastic Pub, quindi dart pub get si risolve alla versione più recente abbastanza vecchia. Nulla fallisce. Un amministratore può approvare una versione in anticipo, oppure rifiutarla.
Se un lockfile vincola già una versione che è ancora in attesa, dart pub get la rifiuta e indica la data in cui diventa disponibile.
Revisione ed esiti
Alcuni segnali mandano una versione in revisione: un nome a un refuso di distanza da un pacchetto popolare, un pacchetto pubblico il cui publisher è cambiato, un pacchetto fermo da tempo che all’improvviso esce con una release, o un nuovo uploader su uno dei suoi pacchetti. Con Strict, la versione aspetta finché la sua revisione è aperta.
Una revisione si conclude con un esito. allow serve la versione. warn la serve, segnalata nella sua pagina, tranne che con Strict. quarantine e deny la fermano per ogni organizzazione.
Quality gate
Un amministratore dell’organizzazione può impostare una quality gate: un minimo di pub points, un Security Score minimo e controlli che devono essere superati. Una versione sotto la soglia viene esclusa dalle versioni servite alla sua organizzazione, quindi dart pub get non può sceglierla.
Qui un pacchetto pubblico non ha pub points, quindi un minimo di pub points non lo trattiene. Un controllo obbligatorio deve essere stato superato, quindi uno che non è stato eseguito lo fa fallire.
La sua CI può chiedere se una versione ha superato la soglia, con lo stesso token Pub con cui legge. Lo status della risposta è allow, warn, block o pending. Continui a interrogare finché è pending, che significa che l’analisi non è terminata:
curl -sS -H "Authorization: Bearer $PUB_TOKEN" \
https://pub.dartastic.io/api/dartastic/security/quality-gate/acme_models/1.3.0{
"package": "acme_models",
"version": "1.3.0",
"status": "block",
"securityScore": 73,
"pubPoints": 140,
"reasons": ["Security Score 73 is below 80."],
"gate": { "action": "block", "minSecurityScore": 80, "minPubPoints": 120, … }
}Per far passare una versione, un amministratore dell’organizzazione la esenta, con una motivazione. Così la quality gate viene sospesa per quella sola versione.
Quando dart pub get rifiuta una versione
Un rifiuto dice perché e cosa fare. Ecco cosa significa ciascuno:
| Il messaggio | Cosa significa |
|---|---|
Your organization's security policy holds <package> <version> until <date>. | La sua policy trattiene questa versione pubblica fino alla data indicata. Attenda, usi una versione precedente, o chieda a un amministratore dell’organizzazione di approvarla in anticipo. |
Your organization's security policy holds every version of <package>. | Ogni versione di questo pacchetto pubblico è più recente di quanto la sua policy consenta. La prima diventa disponibile alla data indicata. |
An organization admin rejected <package> <version>. | Un amministratore dell’organizzazione ha rifiutato questa versione. Ne usi un’altra, o gli chieda di revocare il rifiuto. |
<package> <version> is quarantined while it is reviewed. | La versione è in revisione e non viene servita a nessuno finché la revisione non termina. Usi un’altra versione. |
<package> <version> was denied. | Una revisione ha giudicato difettosa questa versione. Usi un’altra versione. |
A security review flagged <package> <version>, … | Una revisione ha segnalato questa versione, e la sua policy (Strict) non serve le versioni segnalate. Usi un’altra versione, o chieda un’esenzione a un amministratore dell’organizzazione. |
<package> <version> is waiting on a security review, … | La versione ha una revisione aperta, e la sua policy (Strict) aspetta che si chiuda. Usi un’altra versione, o chieda a un amministratore dell’organizzazione di esentarla. |
<package> <version> does not meet your organization's quality gate. | La versione è sotto la quality gate della sua organizzazione; il messaggio elenca i motivi. Usi un’altra versione, o chieda a un amministratore dell’organizzazione di esentarla. |
La pagina di sicurezza
Gli amministratori dell’organizzazione gestiscono tutto questo nella pagina di sicurezza, https://pub.dartastic.io/security-admin, con l’accesso al suo Dartastic Pub. Ogni azione lì viene registrata con chi l’ha eseguita e quando. Lì un amministratore può:
- Approvare in anticipo, o rifiutare, una versione trattenuta dalla policy
- Mettere in quarantena, togliere dalla quarantena o bloccare una versione dei pacchetti dell’organizzazione
- Impostare a mano un punteggio sui pacchetti dell’organizzazione
- Aggiungere o rimuovere un’esenzione, con una motivazione
- Scegliere la policy dell’organizzazione e la sua quality gate
- Vedere ogni versione con un esito o un avviso di sicurezza noto che l’organizzazione ha scaricato, chi l’ha scaricata, quanto spesso e quando, e quali dei suoi pacchetti ne dipendono