Pub-Sicherheit
Dartastic Pub bewertet jedes Package, das Sie veröffentlichen, und wendet die Sicherheitsrichtlinie Ihrer Organisation auf jedes Package an, das es ausliefert, öffentliche eingeschlossen. Diese Seite erklärt die Scores, die Richtlinien, was eine Ablehnung bedeutet und was Sie dann tun.
Der Tab „Scores“
Der Tab Scores jedes Packages auf Ihrem Dartastic Pub zeigt zwei Werte. Nachdem eine Version veröffentlicht ist, analysiert Dartastic Pub die neueste stabile Version und die neueste Vorabversion des Packages in einem isolierten Worker ohne Internetzugang.
- Pub points: der Bericht von pana mit 160 Punkten, derselbe, den pub.dev zeigt. Eine Zeile weicht ab: Die Lizenzzeile besteht bei jeder echten Lizenz, denn eine kommerzielle Lizenz ist für privaten Code richtig. Eine fehlende, leere oder Platzhalter-Lizenz besteht weiterhin nicht, und der Tab vermerkt, dass die Zeile geändert wurde.
- Security Score: 0 bis 100 mit einer Note, für das, was pana nicht prüft. Jede Prüfung zeigt, was sie angesehen hat, was sie gefunden hat und wie Sie es beheben.
Kann eine Analyse nicht abschließen (Speicher oder Zeit reichten nicht, oder eine Abhängigkeit ließ sich nicht auflösen), sagt der Tab das und warum, statt einen niedrigen Score zu zeigen.
Die Prüfungen des Security Score
| Prüfung | Punkte | Was sie ansieht |
|---|---|---|
| Known advisories | 30 | Bekannte Sicherheitshinweise zu dieser Version und zu jedem Package, auf das sie aufgelöst wurde. |
| Secrets in the archive | 20 | Tokens, Schlüssel und Dateien mit Zugangsdaten, die im Archiv geblieben sind. Wer das Package lesen kann, sieht, welche Art gefunden wurde; nur seine Administratoren sehen, wo. |
| Review verdict | 10 | Das Urteil einer Sicherheitsprüfung zu dieser Version. |
| Binaries and build hooks | 15 | Native Binärdateien und Build-Hooks im Archiv, jeweils mit ihrem sha256 erfasst. Sie bringen diese Punkte, sobald sie geprüft und erlaubt sind. FFI allein kostet keine. |
| Publisher and provenance | 15 | Wer das Package veröffentlicht, und ob sich das geändert hat. |
| Same uploader as the last release | 5 | Ob die Person, die diese Version hochgeladen hat, auch die vorherige hochgeladen hat. |
| Release age | 5 | Ob das Release mindestens 7 Tage alt ist. |
- Eine Prüfung ohne Grundlage wird weggelassen: Der Score wird über die ausgeführten Prüfungen skaliert, und der Tab führt die nicht ausgeführten auf. Sie zählt nie als bestanden.
- Noten: A ab 90, B ab 80, C ab 70, D ab 60, F unter 60. A und B erscheinen blau, C gelb, D und F rot.
- Eine Version in Quarantäne oder eine gesperrte Version erhält 0 Punkte. Ein Administrator kann jeden der beiden Scores von Hand setzen; der Tab vermerkt das dann, und der berechnete Score bleibt protokolliert.
- Ein Score berichtet, was geprüft wurde. Er verspricht nicht, dass ein Package sicher ist.
Die Sicherheitsrichtlinie Ihrer Organisation
Jede Organisation hat eine Richtlinie, Standard, solange kein Administrator sie ändert. Sie bestimmt, wie lange neue öffentliche Versionen warten und was mit einer bei der Prüfung markierten Version geschieht.
| Richtlinie | Neue öffentliche Versionen | Eine bei der Prüfung markierte Version |
|---|---|---|
| MonitorVolle Transparenz, keine Unterbrechungen | Sofort ausgeliefert | Ausgeliefert und gezählt |
| StandardAusgewogener Schutz für Produktionsteams | 3 Tage warten | Ausgeliefert und auf der Package-Seite markiert |
| StrictMaximale Kontrolle für regulierte Umgebungen | 7 Tage warten, und bei offener Prüfung auf einen Menschen warten | Nicht ausgeliefert |
Die eigenen Packages Ihrer Organisation warten nie und werden nie zur Prüfung zurückgehalten. Keine Richtlinie liefert eine Version in Quarantäne oder eine gesperrte Version aus.
Neue öffentliche Versionen warten
Eine öffentliche Version, die jünger ist als die Grenze Ihrer Richtlinie, fehlt in den Versionen, die Ihr Dartastic Pub ausliefert, sodass dart pub get auf die neueste Version auflöst, die alt genug ist. Nichts schlägt fehl. Ein Administrator kann eine Version vorzeitig freigeben oder ablehnen.
Legt ein Lockfile bereits eine Version fest, die noch wartet, lehnt dart pub get sie ab und nennt das Datum, ab dem sie verfügbar ist.
Prüfung und Urteile
Einige Signale schicken eine Version zur Prüfung: ein Name, der nur einen Tippfehler von einem beliebten Package entfernt ist, ein öffentliches Package mit neuem Publisher, ein lange ruhendes Package, das plötzlich ein Release bringt, oder ein neuer Uploader bei einem Ihrer Packages. Unter Strict wartet die Version, solange ihre Prüfung offen ist.
Eine Prüfung endet mit einem Urteil. allow liefert die Version aus. warn liefert sie aus, auf ihrer Seite markiert, außer unter Strict. quarantine und deny stoppen sie für jede Organisation.
Quality Gates
Ein Administrator der Organisation kann ein Quality Gate festlegen: einen Mindestwert für pub points, einen Mindestwert für den Security Score und Prüfungen, die bestehen müssen. Eine Version unter dem Gate fehlt in den Versionen, die Ihre Organisation erhält, sodass dart pub get sie nicht wählen kann.
Ein öffentliches Package hat hier keine pub points, daher hält ein Mindestwert für pub points es nicht zurück. Eine Pflichtprüfung muss bestanden sein, daher fällt ein Package durch, wenn die Prüfung nicht ausgeführt wurde.
Ihre CI kann mit demselben Pub-Token, mit dem sie liest, fragen, ob eine Version bestanden hat. Der status der Antwort ist allow, warn, block oder pending. Fragen Sie weiter ab, solange er pending ist, denn dann ist die Analyse noch nicht fertig:
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, … }
}Um eine Version am Gate vorbeizulassen, nimmt ein Administrator der Organisation sie mit Begründung aus. Das hebt das Gate nur für diese Version auf.
Wenn dart pub get eine Version ablehnt
Eine Ablehnung sagt, warum und was zu tun ist. Was jede bedeutet:
| Die Meldung | Was sie bedeutet |
|---|---|
Your organization's security policy holds <package> <version> until <date>. | Ihre Richtlinie hält diese öffentliche Version bis zum angezeigten Datum zurück. Warten Sie, verwenden Sie eine ältere Version, oder bitten Sie einen Administrator der Organisation, sie vorzeitig freizugeben. |
Your organization's security policy holds every version of <package>. | Jede Version dieses öffentlichen Packages ist jünger, als Ihre Richtlinie erlaubt. Die erste wird am angezeigten Datum verfügbar. |
An organization admin rejected <package> <version>. | Ein Administrator der Organisation hat diese Version abgelehnt. Verwenden Sie eine andere, oder bitten Sie ihn, die Ablehnung aufzuheben. |
<package> <version> is quarantined while it is reviewed. | Die Version wird geprüft und an niemanden ausgeliefert, bis die Prüfung endet. Verwenden Sie eine andere Version. |
<package> <version> was denied. | Eine Prüfung hat diese Version als schlecht eingestuft. Verwenden Sie eine andere Version. |
A security review flagged <package> <version>, … | Eine Prüfung hat diese Version markiert, und Ihre Richtlinie (Strict) liefert markierte Versionen nicht aus. Verwenden Sie eine andere Version, oder bitten Sie einen Administrator der Organisation um eine Ausnahme. |
<package> <version> is waiting on a security review, … | Die Version hat eine offene Prüfung, und Ihre Richtlinie (Strict) wartet, bis sie abgeschlossen ist. Verwenden Sie eine andere Version, oder bitten Sie einen Administrator der Organisation, sie auszunehmen. |
<package> <version> does not meet your organization's quality gate. | Die Version liegt unter dem Quality Gate Ihrer Organisation; die Meldung nennt die Gründe. Verwenden Sie eine andere Version, oder bitten Sie einen Administrator der Organisation, sie auszunehmen. |
Die Sicherheitsseite
Administratoren der Organisation verwalten all das auf der Sicherheitsseite, https://pub.dartastic.io/security-admin, angemeldet bei Ihrem Dartastic Pub. Jede Aktion dort wird mit Urheber und Zeitpunkt protokolliert. Dort kann ein Administrator:
- eine Version, die die Richtlinie zurückhält, vorzeitig freigeben oder ablehnen
- eine Version der eigenen Packages der Organisation unter Quarantäne stellen, aus der Quarantäne holen oder sperren
- einen Score für die eigenen Packages der Organisation von Hand setzen
- eine Ausnahme mit Begründung hinzufügen oder entfernen
- die Richtlinie der Organisation und ihr Quality Gate wählen
- jede Version mit einem Urteil oder einem bekannten Sicherheitshinweis sehen, die die Organisation abgerufen hat, wer sie abgerufen hat, wie oft und wann, und welche ihrer Packages davon abhängen