AiSOC 安全策略实战指南:漏洞披露流程、威胁模型边界与生产加固落点

原创2026-11-02 12:44:411,812 阅读
文章标签:人工智能AI Agent网络安全后端前端

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 只列出三份威胁模型,但它们的优先级排序是有意为之的:

读 docs/security/agent-threat-model.md 可以看清这个排名的原因:AiSOC 的调查 Agent(services/agents/)读取攻击者可影响的遥测,并且能够驱动高影响力的 SOAR 动作(封禁 IP、隔离主机、吊销凭证),因此 prompt 边界和工具边界同时是"恶意输入面"。

信任边界与资产

该文档定义的四类资产是:系统/开发者 prompt 与 Agent 进程可达的密钥;自主性决策(verdict + confidence + 选定 tier)及其派生的工具调用;调查账本(Investigation Ledger,必须是真实且防篡改的记录);流经 Agent 的租户遥测(用户名、主机、IP、路径、命令行)。

信任边界在文档中以 Mermaid 流程图给出,可归纳为三条通路:

  1. 日志字段与富化数据 → 证据信封(nonce 围栏) → LLM 推理;
  2. 日志字段 → PromptInjectionGuard → 高危时直接触发工具层的自主性门控;
  3. 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/ 的描述是一段信息密度极高的披露,值得逐条拆解。

共享什么。 仅两类产物:

  1. IOC 观测:SHA-256 归一化后的指示器("<type>:<value>")哈希 + 粗粒度类型(ip/domain/hash/url)+ 严重度 + 首末观测时间。原始 IOC 永不发布。对端只有在自己已经拥有该 IOC 时才能算出同一个哈希——这是一种私有集合交集(PSI)式交换:查询只针对你提供的哈希返回信誉,且必须满足 k-匿名。
  2. 裁决签名:类别 + 连接器 + 主技术组成的签名键,加裁决分布与平均置信度。不含租户数据、不含实体、不含自由文本。

永不共享的内容。 原始 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,一个已迁移的托管安排会让页面读起来与今天完全一致。因此该页面选择不猜,并明确写道:"在未经确认的情况下点名任何一家,就是这份页面存在所要避免的编造。"

十二、把安全策略变成可执行动作

把上述内容压缩成一份面向不同角色的行动清单:

如果你是安全研究员:

  1. 先确认问题落在"源码 / 官方镜像 / 默认 Helm 与 Terraform"三者之一,且在版本支持窗口内;
  2. 使用 GitHub 私密漏洞报告提交,附最小 PoC、commit SHA 或镜像 digest;
  3. 若主通道不可用,开一个**只写"我有安全发现 + 联系方式"**的公开 issue,等待维护者提供私密渠道;
  4. Mesh 相关的隐私绕过按高危处理;
  5. 修复发布后确认致谢并检查 .github/CREDITS.md 是否已收录。

如果你是运维者:

  1. 按 docs/runbooks/HARDENING.md 逐项打勾,重点是密钥重新生成、90 天轮换、Passkey/SSO、TLS 终止与入口收敛;
  2. 在确认 CNI 真正执行网络策略后,显式打开 infra/helm/aisoc/values.yaml 中的 networkPolicy.enabled,并收窄 allowedEgressCIDRs;
  3. 让 EXPLAIN、lake 查询与登录三个面都处于限流之下,并确认 Redis 不可用时的降级日志真的被你采集到;
  4. 把审计日志转发到不可变存储,并用 GET /api/v1/ledger/{run_id}/published 做一条会在非 200 时告警的合成探针(注意:不存在 /ledger/verify 路由,早期版本的运行手册曾错误地发布过它);
  5. 对任何毁灭性响应动作(isolate-host、disable-user、block-domain)要求人工审批,并在服务端策略中镜像该约束,而不只依赖前端强制。

如果你是评审者:

直接运行第十一节列出的五个脚本,让仓库自己回答"哪些声明有门禁支撑"。这是这份安全策略最核心的方法论:声明必须有链接,链接必须指向能失败的检查,检查必须真的接在 CI 上。任何一环断裂,都应当被视为这份文档的 bug 而不是读者的理解问题——docs/security/README.md 是这么写的,也邀请你按这个标准来报告它。

登录后查看全文
AiSOC