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.
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érification | Points | Ce qu’elle examine |
|---|---|---|
| Known advisories | 30 | Les avis de sécurité connus sur cette version et sur chaque package de sa résolution de dépendances. |
| Secrets in the archive | 20 | Jetons, 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 verdict | 10 | Le verdict d’une revue de sécurité sur cette version. |
| Binaries and build hooks | 15 | Les 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 provenance | 15 | Qui publie le package, et si cela a changé. |
| Same uploader as the last release | 5 | Si la personne qui a envoyé cette version a aussi envoyé la précédente. |
| Release age | 5 | Si 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.
| Politique | Nouvelles versions publiques | Une version signalée en revue |
|---|---|---|
| MonitorVisibilité totale, aucune interruption | Servies immédiatement | Servie et comptabilisée |
| StandardProtection équilibrée pour les équipes en production | Attente de 3 jours | Servie, et signalée sur la page du package |
| StrictContrôle maximal pour les environnements réglementés | Attente de 7 jours, puis d’une personne tant qu’une revue est ouverte | Non 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 :
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, … }
}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 message | Ce 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