Deze pagina’s tonen de URL’s van Cloud. Log in op Dedicated, dan tonen ze die van uw server.

Pub-beveiliging

Dartastic Pub geeft elk package dat u publiceert een score, en past het beveiligingsbeleid van uw organisatie toe op elk package dat het levert, ook de openbare. Deze pagina legt de scores en het beleid uit, wat een weigering betekent en wat u eraan doet.

BUILDDARTASTIC-ARCHITECTUURGEBRUIKERStokensissuesPub-tokenpushCI-uitwisselingapps bereiken gebruikers via appstores, het web en serverssymbolencrashesstacktracesbroncodetelemetrieOntwikkelaarscomputerflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomtokens aanmaken · rolgebaseerd toegangsbeheerControl Planeorganisaties · rollen · tokensDartastic Pubpackages · broncodeObservatorysessies · traces · logsSymbolizercrashes → broncoderegelsDartastic AIantwoorden uit beideIssuetrackerGitHub · Jira · LinearMobiele en desktopappstelefoons · tablets · desktopsverstuurt met een OTLP-tokenWebappsin browsersverstuurt met een Browser OTLP-tokenDart-serversbackends · servicesverstuurt met een OTLP-token

Het tabblad “Scores”

Het tabblad Scores van elk package op uw Dartastic Pub toont twee getallen. Nadat een versie is gepubliceerd, analyseert Dartastic Pub de nieuwste stabiele versie en de nieuwste pre-release van het package in een geïsoleerde worker zonder internettoegang.

  • Pub points: het rapport van 160 punten van pana, hetzelfde dat pub.dev toont. Eén regel wijkt af: de licentieregel slaagt voor een echte licentie van welke soort ook, omdat een commerciële licentie juist is voor privécode. Een ontbrekende, lege of placeholderlicentie zakt er nog steeds voor, en het tabblad vermeldt dat de regel is aangepast.
  • Security Score: 0 tot 100 met een cijfer, voor wat pana niet controleert. Elke controle toont wat ze heeft bekeken, wat ze heeft gevonden en hoe u het oplost.

Als een analyse niet kan afronden (het geheugen of de tijd raakte op, of een dependency kon niet worden geresolved), zegt het tabblad dat en waarom, in plaats van een lage score te tonen.

De controles van de Security Score

ControlePuntenWat ze bekijkt
Known advisories30Bekende beveiligingsadviezen voor deze versie en voor elk package waarnaar die resolvede.
Secrets in the archive20Tokens, sleutels en bestanden met inloggegevens die in het archief zijn achtergebleven. Wie het package kan lezen, ziet wat voor soort er is gevonden; alleen de beheerders zien waar.
Review verdict10Het oordeel van een beveiligingsreview over deze versie.
Binaries and build hooks15Native binaire bestanden en build hooks in het archief, elk vastgelegd met de sha256. Ze leveren deze punten op zodra ze zijn beoordeeld en toegestaan. FFI op zich kost ze niet.
Publisher and provenance15Wie het package publiceert, en of dat is veranderd.
Same uploader as the last release5Of de persoon die deze versie heeft geüpload, ook de vorige heeft geüpload.
Release age5Of de release minstens 7 dagen oud is.
  • Een controle zonder gegevens wordt weggelaten: de score wordt geschaald over de controles die wel liepen, en het tabblad noemt de controles die niet liepen. Ze telt nooit als geslaagd.
  • Cijfers: A vanaf 90, B vanaf 80, C vanaf 70, D vanaf 60, F onder 60. A en B zijn blauw, C geel, D en F rood.
  • Een versie in quarantaine of een geweigerde versie scoort 0. Een beheerder kan elk van beide scores handmatig instellen; het tabblad vermeldt dat dan, en de berekende score blijft vastgelegd.
  • Een score rapporteert wat is gecontroleerd. Hij belooft niet dat een package veilig is.

Het beveiligingsbeleid van uw organisatie

Elke organisatie heeft één beleid, Standard tenzij een beheerder het wijzigt. Het bepaalt hoe lang nieuwe openbare versies wachten en wat er gebeurt met een versie die in review is gemarkeerd.

BeleidNieuwe openbare versiesEen versie gemarkeerd in review
MonitorVolledig inzicht, geen onderbrekingenMeteen geleverdGeleverd en geteld
StandardEvenwichtige bescherming voor productieteams3 dagen wachtenGeleverd, en gemarkeerd op de packagepagina
StrictMaximale controle voor gereguleerde omgevingen7 dagen wachten, en op een mens wachten zolang een review openstaatNiet geleverd

De eigen packages van uw organisatie wachten nooit en worden nooit tegengehouden voor review. Geen enkel beleid levert een versie in quarantaine of een geweigerde versie.

Nieuwe openbare versies wachten

Een openbare versie die jonger is dan de grens van uw beleid, blijft buiten de versies die uw Dartastic Pub levert, zodat dart pub get resolvet naar de nieuwste versie die oud genoeg is. Er faalt niets. Een beheerder kan een versie eerder goedkeuren, of afwijzen.

Pint een lockfile al een versie vast die nog wacht, dan weigert dart pub get die en noemt het de datum waarop ze beschikbaar wordt.

Review en oordelen

Sommige signalen sturen een versie naar review: een naam die één typfout verwijderd is van een populair package, een openbaar package waarvan de publisher is veranderd, een lang slapend package dat plotseling een release uitbrengt, of een nieuwe uploader op een package van u. Onder Strict wacht de versie zolang de review openstaat.

Een review eindigt met een oordeel. allow levert de versie. warn levert haar, gemarkeerd op haar pagina, behalve onder Strict. quarantine en deny houden haar tegen voor elke organisatie.

Quality gates

Een beheerder van de organisatie kan een quality gate instellen: minimale pub points, een minimale Security Score en controles die moeten slagen. Een versie onder de gate blijft buiten de versies die uw organisatie krijgt, zodat dart pub get haar niet kan kiezen.

Een openbaar package heeft hier geen pub points, dus een minimum voor pub points houdt het niet tegen. Een verplichte controle moet zijn geslaagd, dus een controle die niet liep, laat het zakken.

Uw CI kan vragen of een versie geslaagd is, met hetzelfde Pub-token waarmee ze leest. De status van het antwoord is allow, warn, block of pending. Blijf pollen zolang het pending is, wat betekent dat de analyse nog niet klaar is:

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

Om één versie langs de gate te laten, maakt een beheerder van de organisatie er een uitzondering voor, met een reden. Dat heft de gate alleen voor die versie op.

Als dart pub get een versie weigert

Een weigering zegt waarom en wat u kunt doen. Wat elke weigering betekent:

De meldingWat het betekent
Your organization's security policy holds <package> <version> until <date>.Uw beleid houdt deze openbare versie tegen tot de getoonde datum. Wacht, gebruik een oudere versie, of vraag een beheerder van de organisatie om haar eerder goed te keuren.
Your organization's security policy holds every version of <package>.Elke versie van dit openbare package is jonger dan uw beleid toestaat. De eerste wordt beschikbaar op de getoonde datum.
An organization admin rejected <package> <version>.Een beheerder van de organisatie heeft deze versie afgewezen. Gebruik een andere, of vraag de beheerder de afwijzing op te heffen.
<package> <version> is quarantined while it is reviewed.De versie is in review en wordt aan niemand geleverd tot de review afloopt. Gebruik een andere versie.
<package> <version> was denied.Een review heeft deze versie slecht bevonden. Gebruik een andere versie.
A security review flagged <package> <version>, …Een review heeft deze versie gemarkeerd, en uw beleid (Strict) levert geen gemarkeerde versies. Gebruik een andere versie, of vraag een beheerder van de organisatie om een uitzondering.
<package> <version> is waiting on a security review, …De versie heeft een openstaande review, en uw beleid (Strict) wacht tot die is afgesloten. Gebruik een andere versie, of vraag een beheerder van de organisatie om een uitzondering.
<package> <version> does not meet your organization's quality gate.De versie zit onder de quality gate van uw organisatie; de melding noemt waarom. Gebruik een andere versie, of vraag een beheerder van de organisatie om een uitzondering.

De beveiligingspagina

Beheerders van de organisatie regelen dit allemaal op de beveiligingspagina, https://pub.dartastic.io/security-admin, ingelogd op uw Dartastic Pub. Elke actie daar wordt vastgelegd met wie het deed en wanneer. Daar kan een beheerder:

  • Een versie die het beleid tegenhoudt eerder goedkeuren, of afwijzen
  • Een versie van de eigen packages van de organisatie in quarantaine plaatsen, uit quarantaine halen of weigeren
  • Een score handmatig instellen op de eigen packages van de organisatie
  • Een uitzondering toevoegen of verwijderen, met een reden
  • Het beleid van de organisatie en de quality gate kiezen
  • Elke versie met een oordeel of een bekend beveiligingsadvies zien die de organisatie heeft opgehaald, wie die heeft opgehaald, hoe vaak en wanneer, en welke van haar packages ervan afhangen