Queste pagine mostrano gli URL di Cloud. Acceda su Dedicated e vedrà quelli del suo server.

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.

BUILDARCHITETTURA DARTASTICUTENTItokentickettoken Pubpushscambio CIle app arrivano agli utenti: app store, web, serversimbolicrashstack tracecodice sorgentetelemetriaComputer dello sviluppatoreflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomcreazione di token · controllo degli accessi basato sui ruoliPiano di controlloorganizzazioni · ruoli · tokenDartastic Pubpacchetti · codice sorgenteObservatorysessioni · tracce · logSymbolizercrash → righe di codice sorgenteDartastic AIrisposte da entrambiSistema di ticketingGitHub · Jira · LinearApp mobile e desktoptelefoni · tablet · computerinvia con un token OTLPApp webnei browserinvia con un token Browser OTLPServer Dartbackend · serviziinvia con un token OTLP

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

ControlloPuntiCosa esamina
Known advisories30Avvisi di sicurezza noti su questa versione e su ogni pacchetto a cui si è risolta.
Secrets in the archive20Token, 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 verdict10L’esito di una revisione di sicurezza su questa versione.
Binaries and build hooks15Binari 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 provenance15Chi pubblica il pacchetto, e se è cambiato.
Same uploader as the last release5Se la persona che ha caricato questa versione ha caricato anche quella precedente.
Release age5Se 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.

PolicyNuove versioni pubblicheUna versione segnalata in revisione
MonitorVisibilità completa, nessuna interruzioneServite subitoServita e conteggiata
StandardProtezione equilibrata per i team in produzioneAttesa di 3 giorniServita, e segnalata nella pagina del pacchetto
StrictMassimo controllo per ambienti regolamentatiAttesa di 7 giorni, e attesa di una persona finché una revisione è apertaNon 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:

shell
curl -sS -H "Authorization: Bearer $PUB_TOKEN" \
  https://pub.dartastic.io/api/dartastic/security/quality-gate/acme_models/1.3.0
json
{
  "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 messaggioCosa 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