安全基线
规范化的 S1–S11 安全规则参考,引用自 AGENTS.md § Security Mandate。在 plan/qa/compliance/do 涉及已交付产物时加载。
概述
安全基线是 Datarim 已交付产物(技能、智能体、命令、模板、脚本、文档)的规范化 S1–S11 规则集。在 /dr-plan、/dr-qa、/dr-compliance 和 /dr-do 期间,当涉及生产代码路径时,由评审者、安全和合规智能体加载。来源:企业安全审计,2026-04-28(6 项发现:2 项 HIGH 命令注入,4 项 MEDIUM SSH/凭据/供应链)。
威胁模型
Datarim 交付的技能、模板、智能体和命令会被 AI 智能体复制到运行时并执行,通常具有提升的权限(root SSH、具有写作用域的 OAuth 令牌、软件包安装)。已交付脚本中的一行漏洞会被复制到每个消费者的生产运行手册中。技能中记录的 curl | bash 配方会成为整个生态系统的规范安装模式。每个已交付产物都是处于攻击之下的生产代码。
规则集群(快速参考)
| 集群 | 范围 | 必需的 CI 门禁 |
|---|---|---|
| S1 | Shell 脚本 + 内嵌 shell 块 | shellcheck(已提交的 .sh) |
| S2 | Python + python 围栏代码块 | bandit -ll -ii |
| S3 | 凭据、密钥、租户标识符 | gitleaks、trufflehog |
| S4 | 供应链 | actionlint、zizmor、osv-scanner、签名发布 |
| S5 | Markdown 文档即代码 | 正则反模式 grep(markdown-policy) |
| S6 | 仓库卫生(LICENSE、SECURITY.md 等) | 清单存在性检查 |
| S7 | CI 验证门禁(本矩阵) | 元规则 — 上述每个必需作业都会阻止合并 |
| S8 | 标准映射(S1–S7 → ASVS / SOC 2 / …) | (无自动门禁 — 仅供参考) |
| S9 | 漂移、演进、事件响应 | bats 回归测试 + 抑制注册表同步 |
| S10 | 分支集成底线 | branch-integration-guard PreToolUse 钩子(运行时) |
| S11 | 不可信内容边界评审门禁 | 独立的对抗性评审(合并前;仅 CI 通过不能清除此门禁) |
S1 — Shell 脚本
- 严格模式位于每个脚本顶部:
set -euo pipefail+ 带引号的IFS=$'\n\t'。 - 为每个参数展开加引号(
"$1"、"$@")。未加引号的展开属于缺陷。 - 在使用前用显式正则验证位置参数。
- 带引号的 heredoc 终止符(
<<'EOF'),当 heredoc 携带必须原样到达消费者的变量时。 - 禁止
eval用于用户控制或文件系统派生的输入。 - 禁止
curl | bash安装配方;仅使用哈希固定的 tarball 或包管理器。 - 禁止
ssh -o StrictHostKeyChecking=no;通过ssh-keyscan -H引导主机密钥。 shellcheck -S warning干净;抑制必须内联引用原因 + 发现-ID + 评审者。
S2 — Python
- 禁止
shell=True用于用户控制的输入;使用带 argv 列表的subprocess。 - 原子模式 0o600 凭据写入通过
O_EXCL。 - 禁止
eval/pickle.loads/yaml.load用于不可信输入。 requests verify=True(默认;切勿为“方便”而设为False)。- 哈希使用 SHA-256 或更强(遗留场景外不使用 MD5 / SHA-1)。
bandit -ll -ii干净。
S3 — 凭据与密钥
- 禁止硬编码密钥、API 密钥、租户 ID 出现在代码或文档中。
- 通用环境变量路径(
${PROJECT_CREDS_DIR})— 不交付主机特定路径。 - 密钥仅通过环境变量 / Vault / 提示 — 绝不放在提交到 git 的
.env中。 .gitignore覆盖:*.pem、*.key、*.token、**/Credentials/**。- 意外提交的轮换策略:24 小时内轮换、清理历史、强制推送、通知克隆。
S4 — 供应链
- 禁止
curl | bash;仅哈希固定安装。 - GitHub Actions 固定到提交 SHA + 显式
permissions:块。 - SBOM(CycloneDX)随每个版本交付。
- 签名发布(Sigstore cosign 无密钥,GitHub OIDC)。
- SLSA L2 构建来源通过
actions/attest-build-provenance。 - Dependabot / Renovate 在每个仓库启用。
- 消费者侧验证:参见
release-verify技能。
S5 — Markdown 即代码
- 已交付配方中使用占位符,而非真实 ID。
- 绝不将不安全模式规定为主要配方。
- 用于教学不安全模式的反例围栏语法:
<!-- security:counter-example -->…<!-- /security:counter-example -->。 - 内嵌围栏代码块(
```bash、```python)继承相应的 S1 / S2 规则。
S6 — 仓库卫生
每个已交付仓库(Datarim 本身及其脚手架生成的每个项目)应交付:LICENSE、SECURITY.md、CODE_OF_CONDUCT.md、CONTRIBUTING.md、CODEOWNERS、dependabot.yml、分支保护规则、标签保护规则。
S7 — CI 验证门禁
必需作业(每个 PR / 推送到 main):shellcheck、bandit、semgrep、gitleaks、trufflehog、actionlint、zizmor、osv-scanner、回归 bats、markdown-policy。每个作业在发现非零问题时阻止合并。
S8 — 标准映射
S1–S7 映射到 OWASP ASVS v5、SOC 2 CC 控制、ISO 27001 附录 A、CIS Controls v8。完整表格见 documentation/reference/standards-mapping.md;仅供参考 — 无自动门禁,用于审计。
SOC 2 进展
状态:技术控制映射进行中。Datarim 尚未发布 SOC 2 报告,本页面不声称认证或鉴证。
已覆盖(9/9 基线 → SOC 2 通用标准):全部 9 个 S 集群(S1–S9)至少映射到一个 SOC 2 通用标准 — CC6(逻辑与物理访问)、CC7(系统运营)、CC8(变更管理)、CC9(风险缓解)。基线是技术脚手架:默认安全代码、签名发布、漂移检测、公共表面卫生、网络暴露分层。
未完成(运营证据):Datarim 是开发工具基线,而非应用型 SOC 2 控制集。以下内容仍属于消费者项目的责任,而非框架的责任:
- 正式的 SOC 2 Type I 就绪评审(与外部审计师进行控制设计走查)— 尚未安排。
- 证据收集工作流(工单轨迹、访问评审、供应商管理登记册)— 在框架层未完成。
- 消费者采用的运营产物:事件响应运行手册、业务连续性 / 灾难恢复演练、HR 控制、供应商风险登记册。
下一步证据:保持控制映射最新,定义证据所有权和保留期,完成内部就绪评审,并在做出任何就绪或报告声明之前聘请独立服务审计师。此处不承诺审计日期。
S9 — 漂移与演进
- 未经架构师批准不得放宽。
- 新发现 → 7 天内在
tests/security/中更新规则 + 回归测试。 - 抑制注册表:
tests/security/baseline.json— 每个# shellcheck disable、# nosec、# nosemgrep条目必须内联引用原因 + 发现-ID + 评审者。
S10 — 分支集成底线
智能体不得将集成分支(dev、develop、development、integration、staging)直接合并或推送到受保护分支(main、master、trunk、release);受保护分支仅通过拉取/合并请求接收变更。允许将受保护分支拉取到工作分支。由 branch-integration-guard PreToolUse 钩子在运行时强制执行,该钩子仅检查结构化命令;没有环境变量、标志或带内文本可以禁用它。
S11 — 不可信内容边界评审门禁
任何引入或改变不可信字节进入模型上下文的边界的变更(检索文档、获取的 Web 或工具输出、用户文件、数据库行)都需要在合并前进行独立的、仅发现问题的对抗性安全评审。CI 通过不能清除此门禁。评审至少覆盖围栏逃逸、nonce 可预测性、信任类交叉提升、来源伪造、大小防护绕过和故障开放行为;发现遵循 S9 义务。
使用时机
在 /dr-plan、/dr-qa、/dr-compliance、/dr-do 期间由评审者、安全和合规智能体加载。引用自 AGENTS.md § Security Mandate。配套:security 技能(操作配方 — git 历史清理、Tailscale+VPN 共存、侦察与入侵启发式)和 release-verify 技能(S4 消费者侧入口点)。