技能 Quality

安全基线

规范化的 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 门禁
S1Shell 脚本 + 内嵌 shell 块shellcheck(已提交的 .sh)
S2Python + python 围栏代码块bandit -ll -ii
S3凭据、密钥、租户标识符gitleaks、trufflehog
S4供应链actionlint、zizmor、osv-scanner、签名发布
S5Markdown 文档即代码正则反模式 grep(markdown-policy)
S6仓库卫生(LICENSE、SECURITY.md 等)清单存在性检查
S7CI 验证门禁(本矩阵)元规则 — 上述每个必需作业都会阻止合并
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 消费者侧入口点)。