Ces pages affichent les URL de Cloud. Connectez-vous sur Dedicated et elles affichent celles de votre serveur.

Sécurité du dépôt Pub

Dartastic Pub attribue des scores à chaque package que vous publiez, et applique la politique de sécurité de votre organisation à chaque package qu’il sert, packages publics compris. Cette page explique les scores, les politiques, ce que signifie un refus et que faire.

BUILDARCHITECTURE DARTASTICUTILISATEURSjetonsticketsjeton Pubpushéchange CIles applis sont livrées aux utilisateurs : stores d’applications, web, serveurssymbolescrashspiles d’appelscode sourcetélémétriePoste développeurflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomcréation de jetons · contrôle d’accès par rôlePlan de contrôleorganisations · rôles · jetonsDartastic Pubpackages · code sourceObservatorysessions · traces · logsSymbolizercrashs → lignes de codeDartastic AIrépond à partir des deuxSuivi des ticketsGitHub · Jira · LinearApplis mobiles + bureautéléphones · tablettes · ordinateursenvoie avec un jeton OTLPApplis webdans les navigateursenvoie avec un jeton Browser OTLPServeurs Dartbackends · servicesenvoie avec un jeton OTLP

L’onglet Scores

L’onglet Scores de chaque package sur votre Dartastic Pub affiche deux scores. Après la publication d’une version, Dartastic Pub analyse la dernière version stable et la dernière préversion du package dans un worker isolé sans accès à Internet.

  • Pub points : le rapport de pana sur 160 points, celui qu’affiche pub.dev. Une ligne diffère : la ligne de licence est validée par une vraie licence de n’importe quel type, car une licence commerciale convient au code privé. Une licence absente, vide ou factice ne la valide toujours pas, et l’onglet indique que la ligne a été modifiée.
  • Security Score : de 0 à 100 avec une note, pour ce que pana ne vérifie pas. Chaque vérification montre ce qu’elle a examiné, ce qu’elle a trouvé et comment corriger.

Quand une analyse ne peut pas aboutir (mémoire ou temps épuisé, ou dépendance impossible à résoudre), l’onglet l’indique, avec la raison, au lieu d’afficher un score bas.

Les vérifications du Security Score

VérificationPointsCe qu’elle examine
Known advisories30Les avis de sécurité connus sur cette version et sur chaque package de sa résolution de dépendances.
Secrets in the archive20Jetons, clés et fichiers d’identifiants oubliés dans l’archive. Toute personne qui peut lire le package voit le type trouvé ; seuls ses administrateurs voient où.
Review verdict10Le verdict d’une revue de sécurité sur cette version.
Binaries and build hooks15Les binaires natifs et les build hooks de l’archive, chacun consigné avec son sha256. Ils obtiennent ces points une fois examinés et autorisés. Le FFI seul ne fait pas perdre de points.
Publisher and provenance15Qui publie le package, et si cela a changé.
Same uploader as the last release5Si la personne qui a envoyé cette version a aussi envoyé la précédente.
Release age5Si la version a au moins 7 jours.
  • Une vérification sans rien sur quoi s’appuyer est écartée : le score est recalculé sur les vérifications exécutées, et l’onglet liste celles qui ne l’ont pas été. Elle n’est jamais comptée comme réussie.
  • Notes : A dès 90, B dès 80, C dès 70, D dès 60, F en dessous de 60. A et B s’affichent en bleu, C en jaune, D et F en rouge.
  • Une version mise en quarantaine ou refusée obtient 0. Un administrateur peut fixer l’un ou l’autre score à la main ; l’onglet l’indique alors, et le score calculé reste consigné.
  • Un score rend compte de ce qui a été vérifié. Il ne garantit pas qu’un package est sûr.

La politique de sécurité de votre organisation

Chaque organisation a une politique, Standard sauf si un administrateur la change. Elle détermine combien de temps les nouvelles versions publiques attendent et ce qu’il advient d’une version signalée en revue.

PolitiqueNouvelles versions publiquesUne version signalée en revue
MonitorVisibilité totale, aucune interruptionServies immédiatementServie et comptabilisée
StandardProtection équilibrée pour les équipes en productionAttente de 3 joursServie, et signalée sur la page du package
StrictContrôle maximal pour les environnements réglementésAttente de 7 jours, puis d’une personne tant qu’une revue est ouverteNon servie

Les packages de votre organisation n’attendent jamais et ne sont jamais retenus pour revue. Aucune politique ne sert une version mise en quarantaine ou refusée.

Les nouvelles versions publiques attendent

Une version publique plus récente que la limite de votre politique est exclue des versions que sert votre Dartastic Pub, donc dart pub get résout vers la version la plus récente assez ancienne. Rien n’échoue. Un administrateur peut approuver une version plus tôt, ou la rejeter.

Si un lockfile épingle déjà une version encore en attente, dart pub get la refuse et indique la date à laquelle elle devient disponible.

Revue et verdicts

Certains signaux envoient une version en revue : un nom à une faute de frappe d’un package populaire, un package public dont l’éditeur a changé, un package longtemps inactif qui publie soudain, ou un nouvel uploader sur l’un de vos packages. Avec Strict, la version attend tant que sa revue est ouverte.

Une revue se conclut par un verdict. allow sert la version. warn la sert, signalée sur sa page, sauf avec Strict. quarantine et deny la bloquent pour toutes les organisations.

Seuils de qualité

Un administrateur de l’organisation peut définir un seuil de qualité : un minimum de pub points, un Security Score minimum et des vérifications obligatoires. Une version sous le seuil est exclue des versions servies à votre organisation, donc dart pub get ne peut pas la choisir.

Un package public n’a pas de pub points ici, donc un minimum de pub points ne le retient pas. Une vérification obligatoire doit avoir réussi : une vérification qui n’a pas été exécutée fait donc échouer le seuil.

Votre CI peut demander si une version a passé le seuil, avec le même jeton Pub qu’elle utilise pour lire. Le status de la réponse vaut allow, warn, block ou pending. Continuez d’interroger tant qu’il vaut pending, ce qui signifie que l’analyse n’est pas terminée :

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

Pour laisser passer une version, un administrateur de l’organisation l’exempte, avec un motif. Cela lève le seuil pour cette version seulement.

Quand dart pub get refuse une version

Un refus dit pourquoi et quoi faire. Ce que signifie chacun :

Le messageCe que cela signifie
Your organization's security policy holds <package> <version> until <date>.Votre politique retient cette version publique jusqu’à la date indiquée. Attendez, dépendez d’une version plus ancienne, ou demandez à un administrateur de l’organisation de l’approuver plus tôt.
Your organization's security policy holds every version of <package>.Toutes les versions de ce package public sont plus récentes que ce que votre politique autorise. La première devient disponible à la date indiquée.
An organization admin rejected <package> <version>.Un administrateur de l’organisation a rejeté cette version. Dépendez d’une autre, ou demandez-lui de lever le rejet.
<package> <version> is quarantined while it is reviewed.La version est en cours de revue et n’est servie à personne jusqu’à la fin de la revue. Dépendez d’une autre version.
<package> <version> was denied.Une revue a jugé cette version mauvaise. Dépendez d’une autre version.
A security review flagged <package> <version>, …Une revue a signalé cette version, et votre politique (Strict) ne sert pas les versions signalées. Dépendez d’une autre version, ou demandez une exemption à un administrateur de l’organisation.
<package> <version> is waiting on a security review, …La version a une revue ouverte, et votre politique (Strict) attend sa clôture. Dépendez d’une autre version, ou demandez à un administrateur de l’organisation de l’exempter.
<package> <version> does not meet your organization's quality gate.La version est sous le seuil de qualité de votre organisation ; le message en liste les raisons. Dépendez d’une autre version, ou demandez à un administrateur de l’organisation de l’exempter.

La page de sécurité

Les administrateurs de l’organisation gèrent tout cela sur la page de sécurité, https://pub.dartastic.io/security-admin, une fois connectés à votre Dartastic Pub. Chaque action y est auditée, avec son auteur et sa date. Depuis cette page, un administrateur peut :

  • Approuver plus tôt, ou rejeter, une version que la politique retient
  • Mettre en quarantaine, sortir de quarantaine ou refuser une version des packages de l’organisation
  • Fixer un score à la main sur les packages de l’organisation
  • Ajouter ou retirer une exemption, avec un motif
  • Choisir la politique de l’organisation et son seuil de qualité
  • Voir chaque version sous verdict ou concernée par un avis de sécurité connu que l’organisation a récupérée, qui l’a récupérée, combien de fois et quand, et lesquels de ses packages en dépendent