BCAI/easyai-ai-gateway
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(identity): 合并标准统一认证接入与安全事件撤销 #7

Merged
chengcheng merged 21 commits from codex/merge-identity-main into main 2026-07-17 19:36:25 +08:00
Conversation 0 Commits 21 Files Changed 103 +20298 -623
chengcheng commented 2026-07-17 19:11:17 +08:00
Owner
Copy Link

变更摘要

  • 增加通用应用接入码交换与 Gateway 网页统一认证配置
  • 支持 OIDC、JIT、Introspection、BFF 与可选 SSF 会话撤销
  • 完善配对取消、后台恢复、并发门禁和 Secret 安全退役
  • 整合最新 main 的生产 CI、依赖升级与 API 文档改动
  • 将尚未发布的身份迁移整理为 0063–0068，避开现有 0062 并通过生产迁移安全门禁

验证

  • go test ./...
  • go test -race（identity/auth/SSF/http/store）
  • go vet ./...
  • govulncheck ./...
  • pnpm install --frozen-lockfile
  • pnpm lint / test（84 项）/ build
  • pnpm audit --audit-level high
  • docker compose config --quiet
  • migration / pipeline / SemVer / ShellCheck 门禁
  • PostgreSQL 17 完整迁移链与集成测试

风险与边界

  • 当前禁止直接恢复历史 superseded Revision；需安全禁用后使用新接入码重新接入
  • 真实浏览器与 auth.51easyai.com 测试 Application 验收仍需在 PR CI 后执行
## 变更摘要 - 增加通用应用接入码交换与 Gateway 网页统一认证配置 - 支持 OIDC、JIT、Introspection、BFF 与可选 SSF 会话撤销 - 完善配对取消、后台恢复、并发门禁和 Secret 安全退役 - 整合最新 main 的生产 CI、依赖升级与 API 文档改动 - 将尚未发布的身份迁移整理为 0063–0068，避开现有 0062 并通过生产迁移安全门禁 ## 验证 - go test ./... - go test -race（identity/auth/SSF/http/store） - go vet ./... - govulncheck ./... - pnpm install --frozen-lockfile - pnpm lint / test（84 项）/ build - pnpm audit --audit-level high - docker compose config --quiet - migration / pipeline / SemVer / ShellCheck 门禁 - PostgreSQL 17 完整迁移链与集成测试 ## 风险与边界 - 当前禁止直接恢复历史 superseded Revision；需安全禁用后使用新接入码重新接入 - 真实浏览器与 auth.51easyai.com 测试 Application 验收仍需在 PR CI 后执行
chengcheng added 21 commits 2026-07-17 19:11:19 +08:00 
新增数据库驱动的 SecurityEventConnectionManager，复用 RFC 7662 机器 Client，自动完成 Discovery、Push Bearer 生成、Stream 创建、Verification、首次启用、零停机轮换和安全退役。

增加文件与 Kubernetes SecretStore、最小权限 RBAC、动态 Receiver/撤销水位/内省降级，以及系统设置管理页面。已通过全量 Go 测试、go vet、关键包竞态测试、27 个 Web 测试、类型检查、生产构建、Compose 和 Kubernetes dry-run。
为已记录旧迁移版本的环境补充幂等表修复迁移，并让 Transmitter 网络连接在 IPv6 地址不可达时继续尝试 IPv4。失败连接现在通过 If-Match 安全重试，页面同步提供重试入口并清理过期错误提示。\n\n验证：Go securityevents/migrate 测试、Web Vitest 与 TypeScript 类型检查通过。
安全事件连接的成功和运行时失败现在写入脱敏审计，响应携带 Trace ID 与 Audit ID，管理页面展示最近一次成功操作证据。审计仅记录连接状态、健康模式和错误类别，不采集授权头、Token、Bearer 或 Secret。\n\n验证：HTTP API、Store、Security Events Go 测试以及 Web Vitest、TypeScript 类型检查通过。
为已执行旧版 0062 的环境补充不可变修复迁移，恢复 Stream 状态字段和 Verification challenge 表；同时为 timestamptz 参数增加显式类型，避免 pgx 在真实 PostgreSQL 中推断冲突。\n\n验证：pnpm test；pnpm lint；pnpm build；真实 PostgreSQL 集成测试通过。
连续两次有效 Verification 将 Stream 状态恢复为 push_healthy 时，同一事务同步把 degraded 连接恢复为 enabled、清除陈旧错误并推进版本，避免管理页永久误报降级。\n\n验证：真实 PostgreSQL 集成测试；pnpm test；pnpm lint；pnpm build；真实 Transmitter/Introspection 故障与恢复演练。
重建 Stream 时仅重置流级 Verification 状态，保留历史收据和撤销水位；允许显式恢复失败连接，并在进程重启后按持久化时间继续 bootstrap。\n\n已通过 pnpm test、pnpm lint、pnpm build、go vet、PostgreSQL 集成测试以及本地真实断开重连和停机重试验收。
Gateway 连接表单接收认证中心一次性交付的 machine Client 凭据，后端立即写入 SecretStore，数据库和公开响应只保留引用及公开 Client ID。SSF 管理 Token、Verification 和 RFC 7662 内省统一从动态凭据读取，支持现有连接无重启修复及进程重启恢复，环境变量仅保留为旧部署回退。\n\n验证：go test ./apps/api/...；pnpm nx test web；真实重启、OIDC 登录与 session-revoked 1.29 秒失效验收。
记录 Revision 状态机、验证后热切换、Break-glass 与 Secret 边界，明确网页/API 是身份业务配置唯一来源。\n\n验证：git diff --check。
新增统一认证 Revision 状态机、单 Active 数据库约束、SecretStore 引用字段、Break-glass 与本地租户门禁，并在关键身份变化或禁用时清理旧 BFF Session。\n\n同时实现标准应用接入 Manifest v1 消费端，接入码只进入请求 Body，Exchange Token 只进入 Authorization Header，禁用重定向并限制响应大小。\n\n验证：go test ./...；go vet ./...
Gateway 使用一次性接入码创建 Exchange，将 Exchange Token、机器凭据与 Session Key 仅写入 SecretStore，并持久化脱敏配对进度。\n\n资源就绪后先保存凭据和 Manifest，再自动准备 SSF，最后确认远端 Exchange；SecretStore 失败时保持 ready，重试会触发新 Secret 轮换，不回放旧值。\n\n验证：go test ./...；go vet ./...
从 Active Revision 构造并验证 OIDC、BFF Session、Introspection 与 SSF Runtime，在数据库激活成功后原子替换内存引用。请求链路使用不可变快照，失败保留当前运行时，本地管理登录不受影响。\n\n验证：go test ./apps/api/...；go vet ./apps/api/...
提供接入码配对、配置查询、本地策略修改、验证、激活、回滚、禁用和公开运行时状态接口。写操作强制 Idempotency-Key 与 If-Match，后台 Exchange 支持重启恢复和过期收敛，并记录脱敏 Trace 与审计。\n\n验证：go test 相关 identity、store、identityruntime、httpapi 包；go vet ./apps/api/...
Active Revision 重验证成功后更新验证元数据并原子替换同配置 Runtime；验证失败时不修改数据库状态或当前运行时。\n\n验证：go test ./apps/api/internal/identityruntime ./apps/api/internal/store ./apps/api/internal/httpapi
系统设置新增统一认证配对、验证、激活、重验证、回滚与禁用流程，安全事件改为统一能力状态。前端登录入口运行时读取公开配置，不再依赖 VITE_OIDC 构建变量。\n\n验证：web 31 项测试；web typecheck；pnpm lint；web production build
移除旧 OIDC_* 与 VITE_OIDC_* 业务配置读取，统一使用数据库 Revision 和 SecretStore 引用构建运行时。同步更新 Compose、示例配置、接入文档及集成测试，并保留数据库、SecretStore 和安全事件健康窗口等部署级参数。\n\n验证：go test ./...；go test -race ./...；go vet ./...；pnpm test；pnpm lint；pnpm build；docker compose config -q
为配对、策略、验证、激活、回滚、禁用和公开运行时接口补充 OpenAPI 注解，并将通用 Identity 类型加入生成范围。生成契约不包含 Exchange Token、Machine Secret 或 Secret 引用。\n\n验证：pnpm openapi；OpenAPI 敏感字段扫描通过
修复 credentials_saved 状态无法恢复、配对与激活并发冲突，以及 SSF 和身份 Secret 生命周期不完整的问题。新增持久化协调器、取消与清理状态机、事务级并发门禁、受控 SSF 凭据交接、禁用后的延迟 Secret 清理，并对生产环境统一认证及 Discovery 端点强制 HTTPS。

验证：go test ./...；go test -race ./internal/auth ./internal/identity ./internal/identityruntime ./internal/securityevents ./internal/httpapi ./internal/store -count=1；go vet ./...；真实 PostgreSQL 并发及清理成功/冲突回滚测试；pnpm openapi。
为处理中、失败和清理中的配对展示明确状态与恢复动作，支持放弃并清理、作用域内退役冲突连接，并在 Active 状态引导管理员先安全禁用再使用新接入码。同步修复运行时切换后的浏览器会话残留与确认弹窗焦点约束。

验证：pnpm test；pnpm lint；pnpm build。
补充管理员从 Active 禁用到新接入码重配的标准流程，说明 credentials_saved 恢复、SSF 凭据交接、持久清理、Break-glass 与动态 Origin 边界，并明确历史 Revision 仅作审计、当前不支持直接回滚。
chore(merge): 整合最新 main 与统一认证变更
All checks were successful
ci / verify (pull_request) Successful in 12m18s
Details
4426eeccf7 
合并远端生产 CI、依赖与 API 文档改动，保留统一认证和 SSF 能力。由于远端生产基线已占用 0062，将尚未发布的身份迁移整理为 0063 至 0068 的最终增量 Schema，移除仅用于开发期草稿升级的破坏性迁移步骤。

验证：go test ./...。其余生产门禁在合并提交后继续执行。
chengcheng merged commit 82a494051d into main 2026-07-17 19:36:25 +08:00
chengcheng deleted branch codex/merge-identity-main 2026-07-17 19:36:28 +08:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No Label
Milestone
Clear milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: BCAI/easyai-ai-gateway#7
No description provided.
Delete Branch "codex/merge-identity-main"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?