AiSOC 安全策略实战指南:漏洞披露流程、威胁模型边界与生产加固落点
AiSOC 安全策略实战指南:漏洞披露流程、威胁模型边界与生产加固落点
本文以仓库根目录的 SECURITY.md 为骨架,逐条拆解 AiSOC 作为一款安全软件所承诺的安全治理机制:漏洞如何私密上报、48 小时/7 天/30 天的响应窗口如何定义、哪些资产在范围内、加固指引指向哪些真实文件,以及联邦威胁情报 Mesh 的隐私边界。读完之后,你应当能够独立完成一次合规的漏洞披露、为自建实例做出一份有源码依据的加固清单,并看懂仓库里那些"自我验证脚本"到底在验证什么。
一、这份策略文件的定位:不是免责声明,而是一份可被证伪的承诺
SECURITY.md 开篇只说了两句话,但确立了一个重要前提:AiSOC 本身是安全软件,因此它对自己技术栈里的漏洞采取严肃态度。这句话决定了文档后续所有内容都不是模板化的客套,而是带有具体时限、具体范围和具体文件路径的工程承诺。
从结构上看,这份文件承担四个职能:
| 职能 | 对应章节 | 面向读者 |
|---|---|---|
| 引导安全评审者进入完整安全包 | Security pack / Threat models | 做尽职调查的客户、审计方 |
| 定义版本支持周期与漏洞上报通道 | Supported versions / Reporting a vulnerability | 外部安全研究员 |
| 承诺响应与披露节奏 | What to expect | 上报者 |
| 划定资产范围与加固入口 | Scope / Hardening guidance | 自建实例的运维者 |
值得注意的是文档自身记录了一次治理事故:早先版本的兜底上报路径写的是"仓库 profile 里的 SECURITY 联系人",而该联系人并不存在;同时 GitHub 私密漏洞报告功能被关闭,主通道直接返回 HTTP 403。于是一位持有 Critical 级漏洞的研究员完全没有任何可用的上报路径,最终只能以公开 issue 的形式提出(即文件中提到的 #637)。这段文字被刻意保留在文档里,并用"这个兜底路径描述的是一个不可能静默失效的步骤"来解释修复思路——这是理解整份文档风格的关键:它宁可写下自己曾经错在哪里,也不写一句无法验证的漂亮话。
二、安全包:评审者的推荐阅读顺序
SECURITY.md 明确要求:如果你是在评审 AiSOC 而不是在报告漏洞,请从 docs/security/README.md 开始,而不是从这份策略文件开始。安全包按"安全问卷通常的行走顺序"编排:
| 文档 | 回答的问题 |
|---|---|
| docs/security/architecture-and-data-flow.md | 有哪些组件、跨越哪些信任边界、每一类数据流向哪里 |
| docs/security/data-handling.md | 四种部署模式下各有什么数据离开你的边界、留存何处 |
| docs/security/platform-threat-model.md | 平台层 STRIDE,凭证保险库为最高价值资产 |
| docs/security/agent-threat-model.md | Prompt 与工具两条边界的 STRIDE,两者都接收攻击者影响过的输入 |
| docs/security/access-governance.md | 属性条件、限时提权、按服务工作负载身份 |
| docs/security/connector-least-privilege.md | 每个连接器所需的最小厂商权限范围 |
| docs/security/questionnaire.md | 标准控制问题逐条作答,并附完整缺口清单 |
| docs/security/subprocessors.md | 关于托管服务,本仓库能证明什么、不能证明什么 |
安全包遵循一条硬性规则,docs/security/README.md 称之为"这些文档唯一遵守的规则":每一句陈述都必须指名让这句话成立的源文件或 CI 作业;当某项控制的实际能力比标题听起来更窄时,这个限制必须写在同一段落里。
规则之所以存在,是因为项目曾经违反过它——安全包自己列出了四例:备份脚本只有 gzip 上传却被描述成 AES-256-GCM 加密;数据库导出以信封加密作为缓解措施,而 EnvelopeCipher 零调用方;Kafka 主干两端都未插桩却宣称单一分布式追踪;按租户留存策略被一个只断言"purge SQL 能解析"的测试标记为已门禁。这四项后来都被修正,然后才被实现。因此文档给出了一句可执行的定义:
在这个安全包里,一句没有链接的声明就是这份文档的 bug。
这句话直接解释了为什么 SECURITY.md 的加固章节不惜篇幅地给出具体文件路径,而不是泛泛地说"请做好加固"。
三、威胁模型:Agent 与工具面才是主要战场
SECURITY.md 只列出三份威胁模型,但它们的优先级排序是有意为之的:
- Agent + 工具面(Prompt 注入、工具滥用):docs/security/agent-threat-model.md
- 平台 + 凭证保险库(KMS 信封加密、密钥轮换):docs/security/platform-threat-model.md
- 连接器最小权限:docs/security/connector-least-privilege.md
读 docs/security/agent-threat-model.md 可以看清这个排名的原因:AiSOC 的调查 Agent(services/agents/)读取攻击者可影响的遥测,并且能够驱动高影响力的 SOAR 动作(封禁 IP、隔离主机、吊销凭证),因此 prompt 边界和工具边界同时是"恶意输入面"。
信任边界与资产
该文档定义的四类资产是:系统/开发者 prompt 与 Agent 进程可达的密钥;自主性决策(verdict + confidence + 选定 tier)及其派生的工具调用;调查账本(Investigation Ledger,必须是真实且防篡改的记录);流经 Agent 的租户遥测(用户名、主机、IP、路径、命令行)。
信任边界在文档中以 Mermaid 流程图给出,可归纳为三条通路:
- 日志字段与富化数据 → 证据信封(nonce 围栏) → LLM 推理;
- 日志字段 → PromptInjectionGuard → 高危时直接触发工具层的自主性门控;
- LLM 推理 → 调查账本,以及 → L0–L4 门控 → SOAR 执行器。
这条结构意味着一个设计取向:检测到注入并不只产生一条告警,而是可以绕过 LLM 直接压低执行权限。
STRIDE 与代码落点
| 威胁类别 | 攻击方式 | 文档给出的控制点 |
|---|---|---|
| Spoofing | 注入文本伪装 system/user/developer 角色 | 每次运行生成的 nonce 证据围栏(services/agents/app/prompting/envelope.py::EvidenceEnvelope)、system_rule 将围栏内内容绑定为纯数据、PromptInjectionGuard 识别 <|im_start|>、[INST]、# system 等角色标记 |
| Tampering | 改写 verdict,或伪造围栏"越狱"追加指令 | 证据中出现 run nonce 会被剥离,围栏即使泄漏也无法伪造;LLM 输出按结构化 schema 二次校验,自由文本 verdict 不具权威性 |
| Repudiation | 注入导致动作与合法动作事后无法区分 | GuardVerdict.as_ledger_dict 连同命中信号与严重度写入账本,账本哈希链式串联(services/api/app/services/audit_hash.py),并记录降级到 L0 的事件 |
| Information disclosure | 诱导泄漏系统 prompt、凭证或跨租户数据 | reveal_prompt 与密钥外泄检测;出网前 PII 假名化(services/agents/app/privacy/);LLM 输入契约(services/agents/app/llm/contract.py)对原始日志/密钥载荷 fail-closed |
| Denial of service | 告警洪水消耗 LLM 预算,或单字段挤爆上下文 | 净化器中的字段/二进制长度上限;按租户的 token/USD 预算与降级到确定性档的熔断器;相同调查的去重与缓存 |
| Elevation of privilege | 注入召唤高影响工具,作用于并不在案卷中的实体 | 任何高危 guard 信号(含证据中出现 SOAR 工具名)使案卷自主性降级为 L0(GuardVerdict.should_demote_to_l0);工具调用溯源用案卷证据图校验每个实体参数;L0–L4 门控(services/actions/app/services/maturity.py)阻断高爆炸半径的自主动作 |
残差风险:文档主动承认"prompt 不是硬信任边界"
这一点值得单独强调,因为它是判断该文档是否可信的分水岭。docs/security/agent-threat-model.md 明确写道:这些控制提高了攻击成本并让注入"变得响亮"(被标记、被降级),但足够新颖的载荷仍可能影响 LLM 的自由文本输出。补偿控制是结构化输出二次校验、工具调用溯源、检测到即降权、动作后回滚与验证,以及每个 PR 都要跑对抗性评测套件。配套的 docs/security/questionnaire.md 更进一步把"留出载荷上的注入防御率 7.1%"作为公开数字列入缺口清单——这种把弱点量化公开的做法,比任何"业界领先"的措辞更有参考价值。
四、支持版本与生命周期
SECURITY.md 的支持矩阵只有三行,但边界写得很清楚:
| 版本 | 状态 |
|---|---|
main |
活跃开发,安全修复最先落在这里 |
| 最新带 tag 的发布 | 发布后 90 天内接收关键修复 |
| 更早的带 tag 发布 | 仅尽力而为,强烈建议升级 |
对运维者的实际含义是:"我用的是某个 release tag"并不等于"我在支持窗口内"。若你的实例落后于最新 tag 超过 90 天,遇到关键漏洞时官方只承诺尽力而为。这与 docs/runbooks/HARDENING.md 中的供应链要求形成闭环——那里要求订阅安全公告并在 SECURITY.md 规定的 SLA 窗口内完成修补。
五、上报漏洞:主通道与"不会静默失效"的兜底通道
5.1 唯一正确的入口
SECURITY.md 的第一条规则是反直觉但必要的:不要在 GitHub 上开公开 issue 或 PR 讨论安全问题。正确做法是使用 GitHub 的私密漏洞报告功能(private vulnerability reporting),该功能现已启用。
报告应尽量包含以下四类信息:
- 问题及其影响的清晰描述;
- 复现步骤,最好是一个最小 PoC;
- 受影响的版本、commit SHA 或容器 digest;
- 你希望被致谢时使用的姓名 / handle。
第三项值得单列说明:AiSOC 的分发形态包括源码、官方镜像与 Helm Chart,因此"版本号"往往不足以定位问题。提供 commit SHA 或容器 digest 能让维护者直接判断你的构建是否包含某个修复。
5.2 兜底通道的设计逻辑
如果 GitHub 的报告流程在你的环境下不可用,文档允许开一个公开 issue,但要求只写"我有一个安全发现"以及如何联系你——不含细节、不含 payload、不含受影响版本。维护者会回复一个私密渠道,并在你发送任何敏感内容之前完成带外沟通;需要 PGP 密钥可在第一次交互中索要。
这段设计有一个明确的失败模式分析:兜底方案刻意写成一个"平凡的步骤"而不是一个邮箱地址,因为邮箱地址会随人员变动失效,而"开 issue 并等待维护者回复"这个步骤无法静默停止工作。这与前文 #637 的教训直接对应——任何依赖仓库外部状态的指引,都可能在某天变成 404 或 403 而不被察觉。
六、响应时限与协调披露
SECURITY.md 把响应承诺固定为四个窗口:
| 时间窗 | 维护者的动作 |
|---|---|
| 48 小时内 | 确认收到并指定主联系人 |
| 7 天内 | 给出初步分级:严重度、影响范围、缓解状态 |
| 30 天内 | 交付修复、公告,或若需更多工作则给出明确时间表 |
| 披露时 | 协调发布公开公告,并在报告者同意时致谢 |
文档同时说明项目遵循协调披露(coordinated disclosure),并在公告中给出 CVSS v3.1 评分。这里的工程含义是:报告者可以预期在 7 天内拿到一个可对外沟通的严重度判断,而不是等到修复完成才知道事情有多大;30 天窗口则允许"修复尚未完成但时间表已明确"这种真实情况存在,避免为了按期交付而仓促上线不完整的补丁。
七、范围:什么算、什么不算
范围界定看似行政条款,实际上决定了报告是否会被受理。原文的两张清单可以整理为:
在范围内:
- 本仓库中的源码:
services/、apps/web/、infra/、集成与packages/; - 从本仓库发布的官方 Docker 镜像;
infra/下的默认 Helm Chart 与 Terraform 模块。
不在范围内:
- AiSOC 集成的第三方服务(CrowdStrike、Splunk、AWS 等);
- 经过定制改造的自建部署;
- 需要物理接触宿主机的议题。
第二类排除项需要运维者特别注意:一旦你修改了 Helm values、替换了镜像、改动了网络策略,"默认配置是安全的"这一前提就不再成立,你也不能再以"AiSOC 有漏洞"的形式上报配置类问题——这类问题属于你自己的部署责任,可参考 docs/security/data-handling.md 中"软件属性"与"部署属性"的区分。
八、加固指引:五个入口与它们的源码依据
SECURITY.md 用五个要点把运维者送到具体文件,这一段是全篇最"可执行"的部分。
8.1 生产加固清单入口
docs/runbooks/HARDENING.md 是从"能启动"走到"敢灌真实客户遥测"的检查表,覆盖身份与密钥、传输与网络面、数据面、容器与供应链、可观测与审计、AI 与 Agent 控制、应急准备七个部分。它也明确说明:如果你只是本地演示,make up && make demo 会刻意跳过其中大部分控制。
其中几项与源码强相关:
SECRET_KEY(API JWT 签名)与JWT_SECRET(SSO/SAML/OIDC 流程)各需 32+ 随机字节,可用openssl rand -hex 32生成;- Passkey(WebAuthn)需正确设置
PASSKEY_RP_ID(无 scheme、无端口)、PASSKEY_RP_NAME、PASSKEY_RP_ORIGINS(完整 origin URL); - JWT 签名密钥与 webhook 密钥每 90 天轮换,并预留新旧 token 同时被接受的重叠窗口。
8.2 Helm Chart 的安全默认值,以及一个必须自己打开的开关
infra/helm/aisoc/values.yaml 里有安全相关默认值,其中最容易被误读的是网络策略段(约 L765–L775):
networkPolicy:
enabled: false
# Destinations reachable outside the release: vendor APIs, an LLM endpoint,
# a SIEM. 169.254.169.254 is excluded from each of these automatically.
allowedEgressCIDRs: []
默认关闭是刻意的,注释给出的理由值得逐字理解:如果集群的 CNI 不真正执行 NetworkPolicy,这份对象会被静默忽略——一个被静默忽略的控制比一个运维者主动打开的开关更糟,因为它读起来像保护,实际提供零保护。所以正确顺序是:先确认你的 CNI 会执行网络策略,再显式把 enabled 设为 true 并填写 allowedEgressCIDRs(云元数据地址 169.254.169.254 会自动从每个 CIDR 中排除,防止 SSRF 式凭证窃取)。
8.3 认证、RBAC 与 SSO 原语
services/api/app/core/security.py 是认证与授权的单一实现点,读它比读任何描述都可靠:
- 角色权限映射
ROLE_PERMISSIONS(L22 起)以静态字典给出每个角色的权限列表。platform_admin与admin持有通配*;tenant_admin的列表带有大量行内注释,解释每个权限为何存在,例如为什么租户管理员必须拥有audit_log:read(SOC 2 CC7.2 与 ISO 27001 A.12.4 要求控制责任方能够查看自己的审计轨迹,而若只有持有*的平台角色可读,多租户部署下客户就得向运营方索取日志)。同时注释明确说明workload_identities:*故意不授予租户管理员:服务凭证在租户尚未确定前就要完成认证,若允许从租户会话签发,等于授予跨全部租户数据的权限。 - JWT 签发
create_access_token/create_refresh_token会写入exp、iat与type(access/refresh)声明,并使用settings.SECRET_KEY与settings.ALGORITHM签名;access token 默认有效期取settings.ACCESS_TOKEN_EXPIRE_MINUTES,refresh token 取REFRESH_TOKEN_EXPIRE_DAYS。 - 令牌吊销
token_is_revoked(issued_at, sessions_revoked_at)通过比较签发时间与会话吊销时间判断,这使得"吊销所有会话"不必依赖黑名单表。 - API Key
generate_api_key()返回三元组(raw_key, prefix, hashed_key):原始 key 只出现一次,prefix取前 12 字符(形如aisoc_abc123)用于展示与查找,数据库里只存 SHA-256 十六进制摘要;校验路径hash_api_key()用同样方式计算摘要。这是"可展示、不可还原"的标准做法。 - 口令哈希 使用
bcrypt,并显式处理 bcrypt 的 72 字节上限(_BCRYPT_MAX_BYTES),注释解释了为何不再使用 passlib 的版本自省逻辑:passlib 1.7.4 读取_bcrypt.__about__.__version__,而该属性在 bcrypt 4.x 中被移除,导致短口令也会弹出误导性的"72 字节"错误。
此外 services/api/app/core/security.py 还包含 create_realtime_ticket,它刻意不使用 SECRET_KEY 而使用独立的实时票据密钥,并携带 aud 声明,使得泄漏的一线 API access token 无法被重放到实时通道边界。
8.4 中间件目录:审计有,限流不在那里
services/api/app/middleware/ 实际只包含两个文件:audit_middleware.py 与 demo_mode.py。因此该目录对应的是审计日志与请求加固,而不是限流。
这一点在 SECURITY.md 中被单独点明:该行原文曾经声称限流位于中间件目录,"而那个目录只有两个文件,且都不是限流器"。真实位置是 services/api/app/services/login_throttle.py,其旁边还有 explain_rate_limit.py、lake_rate_limit.py 以及 waitlist/ 模块,分别覆盖解释接口、湖查询与公开等待名单三个面。
8.5 登录限流:为什么是两个计数器
services/api/app/services/login_throttle.py 的模块文档本身就是一份设计说明,其开头指出修复的缺陷:一分钟内对同一账号连续 50 次错误口令全部返回 401,既无延迟也无锁定。
(1) 双计数器模型。 一个账号计数器、一个来源计数器,因为两者捕获不同攻击,单一计数器无法同时胜任:
- 一个地址猜很多口令 → 由账号计数器捕获;
- 一个来源用同一常见口令喷洒大量账号 → 账号计数器完全不会触发,因为每个账号只看到一次失败。
(2) 成功只清账号计数器,不清来源计数器。 这是最容易被忽略的一半:否则攻击者猜中千次中的一次,就能重置自己的预算并从头开始。
(3) 退避在前,锁定在后。 阈值以下不做任何干预;超过后退回带 Retry-After 的拒绝,延迟按失败次数翻倍直至上限;超过锁定阈值后改为固定冷却。翻倍而非固定窗口,是因为固定窗口是一种攻击者可以直接排期的速率;而早期几次翻倍的延迟短到"输错两次口令的人根本感觉不到"。
模块中的默认常量可以直接作为调参起点:
| 常量 | 值 | 含义 |
|---|---|---|
DEFAULT_FAILURE_THRESHOLD |
5 | 开始拒绝的失败次数 |
DEFAULT_LOCKOUT_THRESHOLD |
10 | 固定冷却替换翻倍延迟的失败次数 |
DEFAULT_BASE_DELAY_SECONDS |
2.0 | 首次拒绝的延迟秒数 |
DEFAULT_MAX_DELAY_SECONDS |
60.0 | 翻倍延迟的上限 |
DEFAULT_LOCKOUT_SECONDS |
900.0 | 锁定时长 |
DEFAULT_WINDOW_SECONDS |
900.0 | 失败计数的过期窗口 |
SOURCE_MULTIPLIER |
6 | 同一来源在阈值之前的额外容忍倍数 |
DEFAULT_WINDOW_SECONDS 的存在理由同样被写清:若失败计数永不过期,一个月一次的笔误最终也会锁死一个无人攻击的账号。SOURCE_MULTIPLIER = 6 则是因为"一个 NAT 地址后面可能是一整个办公室的人,其中若干人会输错口令"。
这些值通过模块内的 _env_float() 读取环境变量覆盖,函数对非数字与非正数都会记录 warning 并回退到默认值——配置错误不会让限流悄悄归零。
(4) 响应文案对存在与不存在的账号完全一致。 只为真实账号启用的限流就是一个用户枚举 oracle,文档判断"这是比它要修的缺陷更糟的缺陷"。
(5) Redis 不可用时的降级策略。 回退到进程内计数器并在 warning 级别说明。fail-closed 会因为一次 Redis 抖动把全部运维者锁在自己的控制台之外;静默 fail-open 则会在攻击者最有可能制造这起故障的时刻让控制消失。文档诚实地写明:按副本计数弱于共享计数,并在文档中如此描述,而不宣称两者等价。
ThrottleDecision 结构中的 scope 字段("account" 或 "source")是为审计服务的:一条审计记录应当能区分"一个账号正在被攻击"和"一个来源正在喷洒多个账号"。
8.6 限流的调用位置与门禁验证
限流的语义只有在正确位置才成立。仓库用门禁脚本而非文档来固定这些结构性约束,docs/security/README.md 与 docs/security/access-governance.md 都指向同一套工具:
# 哪一个 CI 作业证明了哪一条产品声明(每行都指名一个门禁)
python3 scripts/check_claim_gate_matrix.py
# 授权面:计数,而非描述
python3 scripts/check_route_auth.py # 每条路由都要认证,或在清单中给出理由
python3 scripts/check_route_authz.py # 每条状态变更路由都要授权,或在清单中给出理由
python3 scripts/check_one_permission_model.py --check
# 默认配置不指向任何公网主机
python3 scripts/check_default_egress.py
# 本安全包提到的每个门禁都真的接到了某个 workflow 上
python3 scripts/check_gate_coverage.py
其中 check_one_permission_model.py 的设计最能说明"单一权限路径"的工程价值:CurrentUser.require_permission(位于 services/api/app/api/v1/deps.py)是唯一的权限检查点,有三种放行方式(API key 的显式 scope、被实时提权拓宽的 RBAC 表、静态角色映射)和一种收窄方式(属性条件),且收窄永远在放行之后执行,只能拒绝、不能授予。文档解释了原因:一个能够授予权限的条件等于第二套授权系统,它会在最关键的那天与第一套给出不同答案——这正是安全公告 GHSA-pm3f-h6gc-rvgp 的成因。该脚本的 --self-test 会跑十个探针,每个移除一半接线并要求门禁察觉。
九、联邦威胁情报 Mesh:隐私承诺的技术实现
SECURITY.md 对 services/mesh/ 的描述是一段信息密度极高的披露,值得逐条拆解。
共享什么。 仅两类产物:
- IOC 观测:
SHA-256归一化后的指示器("<type>:<value>")哈希 + 粗粒度类型(ip/domain/hash/url)+ 严重度 + 首末观测时间。原始 IOC 永不发布。对端只有在自己已经拥有该 IOC 时才能算出同一个哈希——这是一种私有集合交集(PSI)式交换:查询只针对你提供的哈希返回信誉,且必须满足 k-匿名。 - 裁决签名:类别 + 连接器 + 主技术组成的签名键,加裁决分布与平均置信度。不含租户数据、不含实体、不含自由文本。
永不共享的内容。 原始 IOC 值、实体名、主机名、用户名、IP、租户标识、告警描述以及任何单告警自由文本。docs/architecture/mesh.md 补充了一个可操作的前置检查:mesh preview 会在你启用任何共享之前打印准确的出网载荷。
四道隐私门禁。 文档列出 k-匿名、按实例签名、租户/规则级 opt-out 与出网审计。源码可以逐一对应:
- k-匿名默认
k=5,由环境变量AISOC_MESH_K覆盖(services/mesh/app/main.py)。低于 k 时,查询结果与"未知"不可区分——这是设计目标而非缺陷。 - 每个产物都由 Ed25519 签名,hub 在计入共识之前先验证签名(services/mesh/app/crypto.py)。因此单个行为者无法用傀儡 ID 灌水共识:每个不同实例对应一个不同的已验证公钥。对应的测试是
test_same_instance_cannot_inflate_consensus。 - 每份共享产物都会记录,hub 侧保留按实例的回执日志。
共识只能微调,不能主导。 裁决引擎中的 mesh 阶段 mesh_contribution(services/mesh/app/consensus.py)对裁决的增量被硬性限制在 ±0.10(MESH_CAP = 0.10,并在 L45 用 max(-MESH_CAP, min(MESH_CAP, …)) 夹紧):社区高误报率把裁决往良性拉,压倒性的真阳性确认小幅上抬,低于 k-匿名则贡献为零。这个上限由 test_mesh_contribution_is_bounded_and_directional 单测保护。
preview 返回的字段。 services/mesh/app/consensus.py 中 mesh_preview() 的返回值本身就是一份"数据分类说明":would_share 里 IOC 只有 ioc_hash/ioc_type/severity,签名只有 signature_key/category/connector_type/primary_technique/verdict_counts;never_shared 则显式列出原始 IOC 值、实体名与主机名、租户标识、告警自由文本。运维者可以据此写自己的脱敏断言,而不必相信任何文字描述。
上报等级。 如果你认为 mesh 泄漏了超出上述范围的信息(例如原始 IOC 或实体可从共享产物还原、k-匿名可被绕过、签名可被伪造),SECURITY.md 要求按高危处理并使用私密上报——不要开公开 issue。
一条自我约束的诚实注记。 docs/architecture/mesh.md 明确写道:"mesh 降低误报"这一主张必须被测量而非宣称;在真实多实例数据上跑完纵向对比之前,基准页上的任何 mesh 增益都必须标注为合成/模拟结果,不得作为真实生产数字发布。
十、漏洞赏金与名人堂
SECURITY.md 的表述没有模糊空间:AiSOC 是开源项目,目前不运营付费赏金计划。但它把回报定义在另一个维度上——在安全公告与名人堂中致谢。
致谢流程是可验证的:SECURITY.md 说明修复发布后,经报告者同意,会在对应的 GitHub Security Advisory 与相关 CHANGELOG.md 条目中致谢;完整名单存放在 .github/CREDITS.md。文件中列出的三条代表性记录各自说明了不同类型的贡献:
| 报告者 | 议题 / PR | 摘要 |
|---|---|---|
| @TanmayZade | #220 → PR #219 | 分类 Agent 中的 prompt 注入导致告警自动关闭绕过;报告者同时提交了修复(prompt 净化器 + 五个分类 Agent 的非受信内容包裹) |
| @mangod12 | #159 → PR #221 | 提出跨租户隔离测试 + RBAC 回归的夜间 CI;直接促成了检测循环端点上的租户隔离加固 |
| @jay-cyble | #130 | 通过代码评审与站点实测整理出的 13 项安全与 UI 议题结构化报告 |
如果报告了有效问题却未被列出,文档邀请直接对 .github/CREDITS.md 提 PR,理由是"宁可多致谢,也不要漏掉任何人"。
十一、缺口清单:这份策略明确没有承诺什么
评估一份安全策略的可信度,最有效的办法是看它愿不愿意列缺口。docs/security/questionnaire.md 把每一项缺失都写成了表格行,其中与安全策略直接相关的包括:
| 缺口 | 当前状态 |
|---|---|
| 按角色的 MFA 强制 | TOTP 与恢复码已上线,但策略是每租户一个布尔值,无法只对管理员强制二次因子 |
| SOC 2 / ISO 27001 | 未委托认证;"控制对齐"的说法靠惯例维持(见 docs/decisions/0002-compliance-claims.md) |
| ADR-0002 声称的合规措辞门禁 | scripts/audit_compliance_claims.py 不存在,也没有任何 workflow 引用它 |
| 渗透测试 | 未委托;以 16 份已发布安全公告替代(docs/security/README.md) |
| 托管服务子处理者清单 | 不存在;ADR-0002 曾承诺但从未落地(见 docs/security/subprocessors.md) |
| GDPR 姿态文档 | ADR-0002 承诺的 docs/compliance/gdpr.md 在树中缺失 |
| 数据主体请求端点 | 不存在 |
| 服务间 TLS | 默认栈的容器网络内为明文 |
/metrics 覆盖 |
19 个服务中的 5 个;其余 14 个由 scripts/audit_prometheus_targets.py 在自身输出中点名 |
| 留出载荷上的注入防护率 | 7.1%,作为诚实数字公开发布 |
| 连接器 scope 一致性门禁 | 最小权限文档靠代码评审执行,尚无 CI |
对采购方最直接的两条是"SOC 2 / ISO 27001 未委托"和"托管服务子处理者清单不存在"。docs/security/subprocessors.md 甚至进一步解释为什么这份清单无法从源码推导:子处理者清单是一份描述实际生效处理安排的法律文件,需要写明谁处理个人数据、为何目的、在哪个司法辖区、依据哪份合同——这些信息不在 compose 文件或 Terraform 模块里;而且基础设施变更可以没有 commit,一个已迁移的托管安排会让页面读起来与今天完全一致。因此该页面选择不猜,并明确写道:"在未经确认的情况下点名任何一家,就是这份页面存在所要避免的编造。"
十二、把安全策略变成可执行动作
把上述内容压缩成一份面向不同角色的行动清单:
如果你是安全研究员:
- 先确认问题落在"源码 / 官方镜像 / 默认 Helm 与 Terraform"三者之一,且在版本支持窗口内;
- 使用 GitHub 私密漏洞报告提交,附最小 PoC、commit SHA 或镜像 digest;
- 若主通道不可用,开一个**只写"我有安全发现 + 联系方式"**的公开 issue,等待维护者提供私密渠道;
- Mesh 相关的隐私绕过按高危处理;
- 修复发布后确认致谢并检查 .github/CREDITS.md 是否已收录。
如果你是运维者:
- 按 docs/runbooks/HARDENING.md 逐项打勾,重点是密钥重新生成、90 天轮换、Passkey/SSO、TLS 终止与入口收敛;
- 在确认 CNI 真正执行网络策略后,显式打开 infra/helm/aisoc/values.yaml 中的
networkPolicy.enabled,并收窄allowedEgressCIDRs; - 让
EXPLAIN、lake 查询与登录三个面都处于限流之下,并确认 Redis 不可用时的降级日志真的被你采集到; - 把审计日志转发到不可变存储,并用
GET /api/v1/ledger/{run_id}/published做一条会在非 200 时告警的合成探针(注意:不存在/ledger/verify路由,早期版本的运行手册曾错误地发布过它); - 对任何毁灭性响应动作(
isolate-host、disable-user、block-domain)要求人工审批,并在服务端策略中镜像该约束,而不只依赖前端强制。
如果你是评审者:
直接运行第十一节列出的五个脚本,让仓库自己回答"哪些声明有门禁支撑"。这是这份安全策略最核心的方法论:声明必须有链接,链接必须指向能失败的检查,检查必须真的接在 CI 上。任何一环断裂,都应当被视为这份文档的 bug 而不是读者的理解问题——docs/security/README.md 是这么写的,也邀请你按这个标准来报告它。