外观
安全总览
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 |
| 4 | RLS 变量缺失时读写都是 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 | 旋转失效 + 家族连坐 |
| AppToken | 32 字节随机数长期凭据 | 手动管理 | rotate(24h 宽限窗)/ revoke |
| App 访问令牌 | EdDSA JWT(kind=app,携带 tid / tier) | 15min | AppToken 状态镜像(交换面拦截) |
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 / result | iam 审计查询面 |
| 记录未被篡改 | 哈希链逐条校验 | verify_window 离线重放(公开 API) |
| 租户隔离未被穿透 | RLS 拦截计数恒 0 | rustsvc_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 权限点怎么声明),涉及敏感字段时补加密页。部署与运维:先读加密(证书与密钥注入点都在那里),再读供应链(发布门禁的形态与豁免清单)。安全评审:本页加审计哈希链页即评审地图,证据面清单可直接作为核验起点。
两条路线之外的共同前提是接受本页的诚实清单:把未实现当已实现来设计或承诺,是安全文档最贵的错误。