Skip to content

安全总览 ​

rust_svc 的安全设计有一条贯穿的主线:fail-closed(故障时闭合)、纵深防御(多层独立防线)、可举证(每个机制留有可核验的证据面)。本页给全景地图与主线说明,各防线的机制细节在后续五页展开,每页都对照真实源码。

威胁模型视角的防线 ​

text
攻击面              防线                                承载页
------------------------------------------------------------------
北向 API            网关认证链(EdDSA 验签 + 吊销三查)   identity
                    限流 / 并发 / 日额度(资源耗尽面)     架构·请求生命周期
伪造身份            算法面收窄到 EdDSA 单算法 + JWKS 轮换 identity
伪造租户            客户端租户头剥离,信任头由网关注入     tenant-isolation
越权访问            授权引擎 deny-first + 行/列策略       authorization
跨租户读写          PG RLS ENABLE + FORCE(裸事务 0 行)   tenant-isolation
DBA / 应用缺陷      RLS 在数据库层强制,与代码纪律解耦     tenant-isolation
篡改审计            sha256 哈希链 + 周期巡检断链告警       observability/audit-chain
内部流量窃听        ztunnel L4 mTLS(云化形态)           encryption
横向移动            AuthorizationPolicy 仅网关可达内部面   encryption
供应链投毒          cargo-deny 门禁 + trivy + cosign 钉版 supply-chain
敏感数据泄露        列级信封加密 + 等值哈希 + 展示掩码     encryption

读这张表的正确方式是横向看:同一个攻击面至少有两道独立防线,例如跨租户访问先在应用层被 TenantContext 过滤(写代码时的纪律),再在数据库层被 RLS 拦截(即使代码写错也出不了跨租户的行)。防线的独立性比数量重要:两道共享同一前提的防线,可靠性等于一道。

fail-closed 的具体体现 ​

fail-closed 不是口号,是可以在代码里逐处指认的行为。当前有五处:

序行为代码位置
1未认证请求一律 401,无匿名路径(白名单显式枚举)svc-gateway 的 middleware.rs
2吊销查询不可达时 GET / HEAD 放行,写与管理 503 拒绝svc-gateway 的 authn.rs 的 degradation_allows
3无授权记录即拒绝,合并总序末端是默认拒绝svc-iam 的 authz.rs
4RLS 变量缺失时读写都是 0 行,不存在无租户上下文的成功路径各库迁移的策略模板
5审计写入失败时业务变更整体回滚,不存在变更成功但审计缺失的中间态各服务 insert_audit_tx 同事务协议

反向的取舍同样显式:第 2 条里读请求在吊销面故障时放行,接受的是访问令牌 15 分钟短 TTL 限制的风险窗口。这是可用性与安全的量化交换,不是疏漏;真正的疏漏不会写进降级函数的名字与注释里。

身份体系一览 ​

四类主体收敛为一套 claims 结构(platform-auth 的 claims.rs),凭证形态与生命周期:

凭证形态TTL吊销通道
用户访问令牌EdDSA JWT(kind=user)15min(900s)jti 名单 + 主体 ver 递增
用户刷新令牌32 字节随机数,库存 sha256 指纹14d旋转失效 + 家族连坐
AppToken32 字节随机数长期凭据手动管理rotate(24h 宽限窗)/ revoke
App 访问令牌EdDSA JWT(kind=app,携带 tid / tier)15minAppToken 状态镜像(交换面拦截)

svc/sys 两类内部主体不持有长期凭证,直接由 iam 签发短令牌。机制细节(轮换窗口、三查时延、登录防爆破参数、种子管理)见身份与令牌。

数据保护一览 ​

五个层面各配独立机制与密钥来源:

层机制密钥来源
传输入口 TLS 终结(部署面);云化东西向 ztunnel mTLS;PG 连接 rustls 栈 + verify-full + 内部 CA部署面证书 / 内部 CA
结构化存储字段级 AES-256-GCM 信封加密(DEK 随值、KEK 包裹)+ 等值哈希伴随列KEK 经 Secret 注入
对象存储桶版本化 + 对象锁 WORM(Governance / Compliance 两模式)对象存储侧
展示列掩码四态(hash / partial / null / redact),多规则冲突取严授权策略驱动
审计哈希链防篡改,断链 P0 告警无密钥(sha256 链)

各层的能力边界(加密列失去范围查询、等值哈希可被低熵暴力)在加密里逐条说明,写功能设计前应先读那一页的边界清单。

授权模型速览 ​

策略(policy,宽粒度主体-动作-资源)与访问规则(access rule,行谓词与列策略)两层,合并总序 deny 优先;角色继承闭包在装载期物化,ABAC 是受限 AST 谓词而非表达式脚本,委托只加 allow 不加 deny。关键常量与边界(决策缓存 30s、enforcer 池 1000、委托 90 天与 20 条上限、write 不含 read)见授权。

一次请求穿过的防线 ​

每一跳的机制在对应分页展开。这张图的价值在于标注信任边界:客户端到网关之间的一切都可伪造,网关注入的信任头与服务侧还原的上下文才可信;服务到 PG 之间再次不信任应用(RLS 兜底)。审计链独立于业务库路径,记录全部变更类操作。

证据面清单 ​

可举证不是修辞,每个安全承诺都有可核验的产物:

承诺证据核验方式
访问控制有效审计事件的 subject / action / resultiam 审计查询面
记录未被篡改哈希链逐条校验verify_window 离线重放(公开 API)
租户隔离未被穿透RLS 拦截计数恒 0rustsvc_rls_denied_total 指标
授权拒绝有据拒绝审计(result=denied 附 reason)审计查询面按 result 过滤
发布物可追溯镜像 sha tag + cosign 签名release 记录与 rekor
依赖合规deny.toml 白名单与忽略项注释CI 供应链关卡记录

合规证据包把这些证据映射到 SOC2 与等保的控制点。

未实现事项(诚实清单) ​

以下能力当前不存在,文档其他页面也不应假设它们存在:

  • OIDC / LDAP 联邦登录(联邦专属账号不允许本地登录,代码已留位);
  • MFA;
  • 外部渗透测试与红队演练的实际执行(用例集在设计文档);
  • Redis 权威吊销缓存(当前权威在 iam 进程内);
  • egress 治理;
  • WebSocket 每帧认证。

状态登记见实现状态矩阵。把未实现写成已实现是文档负债里最贵的一种,本清单随实现推进收缩。

阅读路线建议 ​

按角色给两条路线。服务开发者:先读租户隔离(写任何 SQL 前必须懂 begin_tenant),再读授权(决定 API 权限点怎么声明),涉及敏感字段时补加密页。部署与运维:先读加密(证书与密钥注入点都在那里),再读供应链(发布门禁的形态与豁免清单)。安全评审:本页加审计哈希链页即评审地图,证据面清单可直接作为核验起点。

两条路线之外的共同前提是接受本页的诚实清单:把未实现当已实现来设计或承诺,是安全文档最贵的错误。

相关页面 ​

以仓库代码为事实源构建 · RC Hardening 阶段