Te strony pokazują adresy URL Cloud. Po zalogowaniu się na Dedicated pokazują adresy własnego serwera: Zaloguj się.

Bezpieczeństwo Pub

Dartastic Pub ocenia każdy opublikowany pakiet i stosuje politykę bezpieczeństwa organizacji do każdego udostępnianego pakietu, także publicznego. Ta strona wyjaśnia oceny, polityki, znaczenie odmowy i to, co wtedy zrobić.

BUDOWANIEARCHITEKTURA DARTASTICUŻYTKOWNICYtokenyzgłoszeniatoken Pubpushwymiana w CIaplikacje trafiają do użytkowników: sklepy z aplikacjami, web, serwerysymboleawariestosy wywołańkod źródłowytelemetriaKomputer programistyflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomtworzenie tokenów · kontrola dostępu oparta na rolachPłaszczyzna sterowaniaorganizacje · role · tokenyDartastic Pubpakiety · kod źródłowyObservatorysesje · trasy · logiSymbolizerawarie → linie kodu źródłowegoDartastic AIodpowiedzi z obu źródełSystem zgłoszeńGitHub · Jira · LinearAplikacje mobilne i desktopowetelefony · tablety · komputerywysyła z tokenem OTLPAplikacje webowew przeglądarkachwysyła z tokenem Browser OTLPSerwery Dartbackendy · usługiwysyła z tokenem OTLP

Karta Scores

Karta Scores każdego pakietu w Dartastic Pub pokazuje dwie liczby. Po opublikowaniu wersji Dartastic Pub analizuje najnowszą stabilną i najnowszą przedpremierową wersję pakietu w odizolowanym środowisku bez dostępu do internetu.

  • Pub points: 160-punktowy raport narzędzia pana, ten sam, który pokazuje pub.dev. Różni się jedna pozycja: pozycja licencji jest zaliczana dla prawdziwej licencji dowolnego rodzaju, bo licencja komercyjna jest właściwa dla kodu prywatnego. Brakująca, pusta lub zastępcza licencja nadal jej nie zalicza, a karta informuje, że pozycja została zmieniona.
  • Security Score: od 0 do 100 z oceną literową, za to, czego pana nie sprawdza. Każde sprawdzenie pokazuje, co przejrzało, co znalazło i jak to naprawić.

Gdy analiza nie może się zakończyć (zabrakło pamięci lub czasu albo nie udało się rozwiązać zależności), karta podaje to wraz z przyczyną, zamiast pokazywać niską ocenę.

Sprawdzenia w Security Score

SprawdzeniePunktyCo sprawdza
Known advisories30Znane podatności w tej wersji i w każdym pakiecie wybranym przy rozwiązywaniu jej zależności.
Secrets in the archive20Tokeny, klucze i pliki z danymi uwierzytelniającymi pozostawione w archiwum. Każdy, kto może czytać pakiet, widzi, jaki rodzaj znaleziono; tylko jego administratorzy widzą, gdzie.
Review verdict10Werdykt przeglądu bezpieczeństwa dla tej wersji.
Binaries and build hooks15Natywne pliki binarne i hooki buildu w archiwum, każdy zapisany z sumą sha256. Dostają te punkty, gdy zostaną przejrzane i dopuszczone. Samo FFI ich nie odbiera.
Publisher and provenance15Kto publikuje pakiet i czy to się zmieniło.
Same uploader as the last release5Czy osoba, która przesłała tę wersję, przesłała też poprzednią.
Release age5Czy wersja ma co najmniej 7 dni.
  • Sprawdzenie bez danych jest pomijane: ocena jest skalowana do sprawdzeń, które się wykonały, a karta wymienia te, które się nie wykonały. Nigdy nie liczy się jako zaliczone.
  • Oceny: A od 90, B od 80, C od 70, D od 60, F poniżej 60. A i B są niebieskie, C żółta, D i F czerwone.
  • Wersja objęta kwarantanną lub zablokowana dostaje 0. Administrator może ustawić każdą z ocen ręcznie; karta wtedy to podaje, a wyliczona ocena pozostaje zapisana.
  • Ocena mówi, co sprawdzono. Nie obiecuje, że pakiet jest bezpieczny.

Polityka bezpieczeństwa organizacji

Każda organizacja ma jedną politykę, Standard, dopóki administrator jej nie zmieni. Polityka decyduje, jak długo czekają nowe wersje publiczne i co dzieje się z wersją oznaczoną w przeglądzie.

PolitykaNowe wersje publiczneWersja oznaczona w przeglądzie
MonitorPełny wgląd, bez przerw w pracyUdostępniane od razuUdostępniana i liczona
StandardWyważona ochrona dla zespołów produkcyjnychCzekają 3 dniUdostępniana i oznaczona na stronie pakietu
StrictMaksymalna kontrola w środowiskach regulowanychCzekają 7 dni, a przy otwartym przeglądzie czekają na decyzję człowiekaNieudostępniana

Własne pakiety organizacji nigdy nie czekają i nigdy nie są wstrzymywane do przeglądu. Żadna polityka nie udostępnia wersji objętej kwarantanną ani zablokowanej.

Nowe wersje publiczne czekają

Wersja publiczna młodsza niż limit polityki jest pomijana wśród wersji udostępnianych przez Dartastic Pub, więc dart pub get wybiera najnowszą wystarczająco starą wersję. Nic nie zawodzi. Administrator może zatwierdzić wersję wcześniej albo ją odrzucić.

Jeśli lockfile już przypina wersję, która wciąż czeka, dart pub get ją odrzuca i podaje datę jej dostępności.

Przegląd i werdykty

Niektóre sygnały kierują wersję do przeglądu: nazwa o jedną literówkę od popularnego pakietu, pakiet publiczny, którego wydawca się zmienił, długo uśpiony pakiet, który nagle wydaje nową wersję, albo nowa osoba przesyłająca we własnym pakiecie. W polityce Strict wersja czeka, dopóki jej przegląd jest otwarty.

Przegląd kończy się werdyktem. allow udostępnia wersję. warn udostępnia ją z oznaczeniem na jej stronie, z wyjątkiem polityki Strict. quarantine i deny zatrzymują ją dla każdej organizacji.

Bramki jakości

Administrator organizacji może ustawić bramkę jakości: minimum pub points, minimalny Security Score i sprawdzenia, które muszą przejść. Wersja poniżej bramki jest pomijana wśród wersji udostępnianych organizacji, więc dart pub get nie może jej wybrać.

Pakiet publiczny nie ma tu pub points, więc minimum pub points go nie wstrzymuje. Wymagane sprawdzenie musi zakończyć się powodzeniem, więc takie, które się nie wykonało, nie przechodzi bramki.

CI może zapytać, czy wersja przeszła, tym samym tokenem Pub, którym odczytuje pakiety. Pole status w odpowiedzi ma wartość allow, warn, block lub pending. Dopóki ma wartość pending, czyli analiza się nie zakończyła, należy odpytywać dalej:

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, … }
}

Aby przepuścić jedną wersję przez bramkę, administrator organizacji ją zwalnia, podając powód. To znosi bramkę tylko dla tej wersji.

Gdy dart pub get odrzuca wersję

Odmowa podaje przyczynę i to, co zrobić. Co oznacza każda z nich:

KomunikatCo oznacza
Your organization's security policy holds <package> <version> until <date>.Polityka wstrzymuje tę wersję publiczną do podanej daty. Można poczekać, wybrać starszą wersję albo poprosić administratora organizacji o wcześniejsze zatwierdzenie.
Your organization's security policy holds every version of <package>.Każda wersja tego pakietu publicznego jest młodsza, niż pozwala polityka. Pierwsza staje się dostępna w podanym dniu.
An organization admin rejected <package> <version>.Administrator organizacji odrzucił tę wersję. Można wybrać inną albo poprosić o cofnięcie odrzucenia.
<package> <version> is quarantined while it is reviewed.Wersja jest w przeglądzie i nie jest udostępniana nikomu, dopóki przegląd się nie zakończy. Należy wybrać inną wersję.
<package> <version> was denied.Przegląd uznał tę wersję za złą. Należy wybrać inną wersję.
A security review flagged <package> <version>, …Przegląd oznaczył tę wersję, a polityka organizacji (Strict) nie udostępnia oznaczonych wersji. Można wybrać inną wersję albo poprosić administratora organizacji o zwolnienie.
<package> <version> is waiting on a security review, …Wersja ma otwarty przegląd, a polityka organizacji (Strict) czeka na jego zamknięcie. Można wybrać inną wersję albo poprosić administratora organizacji o jej zwolnienie.
<package> <version> does not meet your organization's quality gate.Wersja nie spełnia bramki jakości organizacji; komunikat podaje dlaczego. Można wybrać inną wersję albo poprosić administratora organizacji o jej zwolnienie.

Strona bezpieczeństwa

Administratorzy organizacji zarządzają tym wszystkim na stronie bezpieczeństwa, https://pub.dartastic.io/security-admin, po zalogowaniu do Dartastic Pub. Każde działanie jest tam zapisywane w dzienniku audytu z informacją, kto i kiedy je wykonał. Administrator może tam:

  • Zatwierdzić wcześniej lub odrzucić wersję wstrzymaną przez politykę
  • Objąć kwarantanną, zdjąć kwarantannę lub zablokować wersję własnego pakietu organizacji
  • Ręcznie ustawić ocenę własnych pakietów organizacji
  • Dodać lub usunąć zwolnienie, z podaniem powodu
  • Wybrać politykę organizacji i jej bramkę jakości
  • Zobaczyć każdą wersję z werdyktem lub znaną podatnością, którą organizacja pobrała, kto ją pobrał, jak często i kiedy, oraz które pakiety organizacji od niej zależą