Pub安全
Dartastic Pub为您发布的每个package评分,并对它提供的每个package(包括公共package)应用您组织的安全策略。本页介绍这些评分和策略、拒绝的含义以及如何处理。
“Scores”标签页
您的Dartastic Pub上每个package的Scores标签页都显示两个分数。版本发布后,Dartastic Pub会在一个无法访问互联网的隔离worker中分析该package的最新稳定版和最新预发布版。
- pub points:pana的160分报告,也就是pub.dev显示的那份。只有一行不同:任何真正的许可证都能通过许可证这一行,因为商业许可证适合私有代码。缺失、空白或占位的许可证仍然无法通过,标签页也会注明这一行已被调整。
- Security Score:0到100分并附带等级,覆盖pana不检查的内容。每项检查都会显示它查看了什么、发现了什么以及如何修复。
当分析无法完成时(内存或时间耗尽,或无法解析某个依赖),标签页会说明情况和原因,而不是显示一个低分。
Security Score的检查项
| 检查项 | 分数 | 检查内容 |
|---|---|---|
| Known advisories | 30 | 该版本及其解析到的每个package上的已知安全公告。 |
| Secrets in the archive | 20 | 归档中遗留的令牌、密钥和凭据文件。能读取该package的人都能看到发现的类型,只有其管理员能看到具体位置。 |
| Review verdict | 10 | 安全审查对该版本给出的结论。 |
| Binaries and build hooks | 15 | 归档中的原生二进制文件和构建钩子,每一项都连同其sha256一起记录。经审查并获准后,它们才能获得这部分分数。仅使用FFI本身不会扣分。 |
| Publisher and provenance | 15 | 谁发布该package,以及发布者是否发生了变化。 |
| Same uploader as the last release | 5 | 上传此版本的人是否也上传了上一个版本。 |
| Release age | 5 | 该版本是否已发布至少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时(表示分析尚未完成),请继续轮询:
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, … }
}要让某个版本通过门禁,由组织管理员为其设置豁免并注明理由。豁免只对该版本解除门禁。
当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依赖它