这些页面显示的是Cloud的URL。在Dedicated上登录后,即显示您服务器的URL。

Pub安全

Dartastic Pub为您发布的每个package评分,并对它提供的每个package(包括公共package)应用您组织的安全策略。本页介绍这些评分和策略、拒绝的含义以及如何处理。

构建DARTASTIC架构用户令牌IssuePub令牌推送CI令牌交换应用发布给用户:应用商店、Web、服务器符号崩溃堆栈源代码遥测数据开发者电脑flutter run · dart pub getCIGitHub Actions、GitLab…Control Room生成令牌 · 基于角色的访问控制控制平面组织 · 角色 · 令牌Dartastic Pubpackage · 源代码Observatory会话 · 链路 · 日志Symbolizer崩溃 → 源代码行Dartastic AI综合两者作答Issue跟踪器GitHub · Jira · Linear移动和桌面应用手机 · 平板 · 电脑使用OTLP令牌发送Web应用运行在浏览器中使用Browser OTLP令牌发送Dart服务器后端 · 服务使用OTLP令牌发送

“Scores”标签页

您的Dartastic Pub上每个package的Scores标签页都显示两个分数。版本发布后,Dartastic Pub会在一个无法访问互联网的隔离worker中分析该package的最新稳定版和最新预发布版。

  • pub points:pana的160分报告,也就是pub.dev显示的那份。只有一行不同:任何真正的许可证都能通过许可证这一行,因为商业许可证适合私有代码。缺失、空白或占位的许可证仍然无法通过,标签页也会注明这一行已被调整。
  • Security Score:0到100分并附带等级,覆盖pana不检查的内容。每项检查都会显示它查看了什么、发现了什么以及如何修复。

当分析无法完成时(内存或时间耗尽,或无法解析某个依赖),标签页会说明情况和原因,而不是显示一个低分。

Security Score的检查项

检查项分数检查内容
Known advisories30该版本及其解析到的每个package上的已知安全公告。
Secrets in the archive20归档中遗留的令牌、密钥和凭据文件。能读取该package的人都能看到发现的类型,只有其管理员能看到具体位置。
Review verdict10安全审查对该版本给出的结论。
Binaries and build hooks15归档中的原生二进制文件和构建钩子,每一项都连同其sha256一起记录。经审查并获准后,它们才能获得这部分分数。仅使用FFI本身不会扣分。
Publisher and provenance15谁发布该package,以及发布者是否发生了变化。
Same uploader as the last release5上传此版本的人是否也上传了上一个版本。
Release age5该版本是否已发布至少7天。
  • 没有依据可查的检查会被排除:分数按实际运行的检查折算,标签页会列出未运行的检查。它绝不算作通过。
  • 等级:90分及以上为A,80分及以上为B,70分及以上为C,60分及以上为D,低于60分为F。A和B显示为蓝色,C为黄色,D和F为红色。
  • 被隔离或被拒绝的版本得0分。管理员可以手动设置任一分数;此时标签页会注明这一点,计算得出的分数仍保留在记录中。
  • 分数只反映检查过的内容,并不保证package是安全的。

您组织的安全策略

每个组织有一种策略,除非管理员更改,否则为Standard。它决定新的公共版本需要等待多久,以及审查中被标记的版本如何处理。

策略新的公共版本审查中被标记的版本
Monitor全面可见,不打断开发立即提供提供并计数
Standard适合生产团队的均衡保护等待3天提供,并在package页面上标记
Strict适合受监管环境的最高管控等待7天,审查未结束时还要等待人工处理不提供

您组织自己的package从不等待,也从不因审查而被暂缓。任何策略都不会提供被隔离或被拒绝的版本。

新的公共版本需要等待

发布时间短于策略时限的公共版本不会出现在您的Dartastic Pub提供的版本中,因此dart pub get会解析到满足时长要求的最新版本。不会有任何失败。管理员可以提前批准某个版本,也可以拒绝它。

如果lock文件已经固定了一个仍在等待中的版本,dart pub get会拒绝它,并给出它可用的日期。

审查与结论

某些信号会让版本进入审查:与热门package仅差一个拼写的名称、发布者发生变化的公共package、长期沉寂后突然发布的package,或您的某个package出现新的上传者。在Strict策略下,审查未结束时该版本需要等待。

审查以结论结束。allow:提供该版本。warn:提供该版本,并在其页面上标记,Strict策略下除外。quarantine和deny:对所有组织停止提供该版本。

质量门禁

组织管理员可以设置质量门禁:最低pub points、最低Security Score,以及必须通过的检查。低于门禁的版本不会出现在您的组织获得的版本中,因此dart pub get无法选择它。

公共package在这里没有pub points,因此pub points下限不会拦下公共package。必需的检查必须已经通过,因此未运行的检查视为不通过。

您的CI可以使用读取时所用的同一个Pub令牌,查询某个版本是否通过。响应中的status为allow、warn、block或pending。当它为pending时(表示分析尚未完成),请继续轮询:

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

要让某个版本通过门禁,由组织管理员为其设置豁免并注明理由。豁免只对该版本解除门禁。

当dart pub get拒绝某个版本时

拒绝消息会说明原因和处理方法。各类消息的含义:

消息含义
Your organization's security policy holds <package> <version> until <date>.您的策略会暂缓这个公共版本,直到显示的日期。您可以等待、依赖更旧的版本,或请组织管理员提前批准。
Your organization's security policy holds every version of <package>.这个公共package的所有版本都比您的策略允许的更新。最早的版本在显示的日期变为可用。
An organization admin rejected <package> <version>.组织管理员拒绝了这个版本。请依赖其他版本,或请管理员解除拒绝。
<package> <version> is quarantined while it is reviewed.该版本正在审查中,审查结束前不向任何人提供。请依赖其他版本。
<package> <version> was denied.审查认定该版本有问题。请依赖其他版本。
A security review flagged <package> <version>, …审查标记了该版本,而您的策略(Strict)不提供被标记的版本。请依赖其他版本,或请组织管理员设置豁免。
<package> <version> is waiting on a security review, …该版本有未结束的审查,您的策略(Strict)会等待审查结束。请依赖其他版本,或请组织管理员为其设置豁免。
<package> <version> does not meet your organization's quality gate.该版本低于您组织的质量门禁;消息中列出了原因。请依赖其他版本,或请组织管理员为其设置豁免。

安全页面

组织管理员在安全页面https://pub.dartastic.io/security-admin上管理以上所有内容,需登录您的Dartastic Pub。页面上的每项操作都会被审计,记录操作人和时间。管理员可以在这里:

  • 提前批准或拒绝被策略暂缓的版本
  • 隔离、解除隔离或拒绝组织自有package的某个版本
  • 手动设置组织自有package的分数
  • 添加或移除豁免,并注明理由
  • 选择组织的策略及其质量门禁
  • 查看组织拉取过的、受审查结论或已知安全公告影响的每个版本,谁拉取了它、拉取频率和时间,以及组织的哪些package依赖它