3.8 KiB
3.8 KiB
仓库安全加固清单(路线图 R0-8)
这些设置只能由维护者在 GitHub 网页或本机上完成,这里只给步骤。每完成一项就勾选。 背景:本项目的自动更新器会下载 GitHub Release 资产并替换程序文件。所以谁能改 Release,谁就能在所有用户机器上执行代码。仓库和账号的安全就是用户的安全。
1. 令牌与凭据(优先级最高)
- 吊销在 AI 对话里出现过的 PAT。 本轮开发开始时提供给 Arena 沙盒的是 admin 级令牌,它已经出现在对话记录中。
- 入口:GitHub → Settings → Developer settings → Personal access tokens,删除对应令牌。
- 现在的推送走「沙盒打包 bundle → 你本机的 Git Credential Manager」,不需要任何令牌。
- 以后确实要给自动化工具令牌时,一律用 Fine-grained token:
- 只选本仓库;
- 权限最小化,一般只给 Contents 读写,要改工作流时再加 Workflows 读写;
- 设置有效期(≤ 30 天)。
- Portal:每次 AI 会话结束后执行「重新生成地址」并停止 Portal。另外关闭
portal.startOnActivation,避免一打开编辑器就对外暴露命令行。 - 本机
ghCLI 已登录。用gh auth status看一下它的令牌权限,不需要的 scope(比如delete_repo、admin:org)可以用gh auth refresh -r去掉。
2. 账号
- 维护者账号开启 2FA,优先用通行密钥或 TOTP,不要用短信。
- 保存好恢复码。
3. 分支与标签规则集(Settings → Rules → Rulesets)
- main 分支规则集:
- 禁止 force push;
- 禁止删除;
- 要求通过 PR 合并。个人仓库也建议开:可以把自己设为 bypass,这样平时照常直接推,但误操作的 force push 会被拦下。
- 等 CI(R0-3)上线后,再加「必须通过状态检查」。
- 发布标签规则集,目标为
refs/tags/*:禁止删除,禁止更新(即不能移动已发布的标签)。- 顺便处理误打的
3.7.5标签:它指向 848622b,与发布序列无关。先删掉,再启用规则。这一步暂缓,等你确认。
- 顺便处理误打的
4. Release 与更新器
- 开启 Immutable releases(仓库 Settings → General → Releases):发布后资产不能被替换或删除,防止有人事后偷换更新包。
- 更新器已经会校验 GitHub API 返回的资产
digest(sha256,见updater.py)。但这只能证明「下载的就是仓库里的那个文件」,证明不了「文件是从这份源码构建的」。- 等自动发包(R0-4)上线后,用
actions/attest-build-provenance生成构建证明; - 更新器(或发布说明)再提供
gh attestation verify校验方式。
- 等自动发包(R0-4)上线后,用
- 发布包清单检查(
static/js存在、VERSION 与标签一致、不含chrome_profile、.env、logs)最好由工作流自动完成。对应 #25:2.9.8 的包缺少static/js。
5. 仓库安全功能(Settings → Code security)
- Secret scanning 和 Push protection:公开仓库免费,确认已开启。
- Dependabot alerts 和 Dependabot security updates。升级依赖前先看
docs/review/DEPENDENCY_UPGRADE_PLAN.md,注意 Starlette 下限必须 ≥ 0.49.1。 - Private vulnerability reporting:开启后,别人可以私下报告漏洞,不必开公开 issue。
- 可以同时加一个简短的
SECURITY.md,说明报告渠道和支持的版本,并链接到docs/SECURITY-TRUST-BOUNDARIES.md。
- 可以同时加一个简短的
6. 社区贡献
- 行尾已统一(R0-6,
.gitattributes)。之前因为行尾冲突合不进来的社区 PR(#16、#17、#18、#21),可以请作者 rebase 到新的 main 再提交。 - 以后的 PR 由 CI(R0-3,暂缓)自动跑测试,维护者只需要看代码。