Skip to content

端到端业务时序

这一页是全站时序的权威源:SaaS 形态 7 跳、私有化同域旁挂形态 8 跳,两张完整泳道图。其他页面出现的时序片段都是这两张图的局部裁剪。两形态的差异只有一跳:⑧ 身份联邦

读图先分清两套编号

图中 autonumber 生成的 1–N 是消息序号(每条箭头一个号);①–⑧ 是环节跳号——全站文档引用"跳几"时指的都是后者。一个环节跳号通常覆盖多条消息。

SaaS 形态:7 跳

App 接入 api.eak.eazo.ai,从注册到吊销的完整闭环:

User员工/终端用户App你的应用与资源服务AgentGenAuthHuman IAM① 注册与审批(一次性,控制平面)注册 Agent(技术负责人 + 业务归属人就位)1审批通过,Agent 入台账2② 发起委托(每次任务/会话)交办任务(“帮我出客户周报”)3发起委托请求(interactive)4授权确认页(Consent:范围 + 期限)5③ 缩权校验:人的真实权限 ∩ 显式委托 ∩ 企业批准边界评估用户真实权限6权限断言7④ 签发委托令牌(Delegate Token)确认授权8委托令牌(短时 · 缩权 · 带 audit_id)9⑤ 令牌兑换(Token Exchange, RFC 8693)凭委托令牌申请资源访问令牌10访问令牌(sub=用户,act=Agent)11⑥ 受限访问(资源侧校验)携访问令牌调用 API12校验 sub / act / scope 交集13仅返回授权范围内的数据14⑦ 审计与吊销(全程)审计链可查(谁授权 · 以谁身份 · 做了什么)15停止后续签发(生效时效见 e5)16

私有化同域旁挂形态:8 跳

GenAuth 部署在你的环境里,人的身份权威在你既有的 Human IAM——所以授权确认之前多出一跳:⑧ 身份联邦(插在②与③之间),用户先以企业账号完成 OIDC 联邦登录,GenAuth 由此确认"张三就是你目录里的张三"。

User员工/终端用户App你的应用与资源服务AgentGenAuth部署于客户环境Human IAM客户既有身份系统① 注册与审批(一次性,控制平面)注册 Agent(技术负责人 + 业务归属人就位)1审批通过,Agent 入台账2② 发起委托交办任务3发起委托请求(interactive)4⑧ 身份联邦:用你既有的企业账号登录(OIDC)联邦登录跳转5以企业账号完成认证6身份断言(张三 = 客户目录中的张三)7②(续)授权确认(Consent)授权确认页(Consent:范围 + 期限)8③ 缩权校验:人的真实权限 ∩ 显式委托 ∩ 企业批准边界评估用户真实权限(同域内部 API / 只读视图)9权限断言10④ 签发委托令牌(Delegate Token)确认授权11委托令牌(短时 · 缩权 · 带 audit_id)12⑤ 令牌兑换(Token Exchange, RFC 8693)凭委托令牌申请资源访问令牌13访问令牌(sub=用户,act=Agent)14⑥ 受限访问(资源侧校验)携访问令牌调用 API15校验 sub / act / scope 交集16仅返回授权范围内的数据17⑦ 审计与吊销(全程,数据不出客户域)审计链可查(谁授权 · 以谁身份 · 做了什么)18停止后续签发(生效时效见 e5)19

每跳承接的文档

时序图给全貌,细节各有专页。按私有化叙事顺序(① ② ⑧ ③ ④ ⑤ ⑥ ⑦)逐跳对照——SaaS 形态跳过⑧即可:

环节(责任方)对应 API / 机制相关文档页备注
注册与审批(App 管理员 × GenAuth)控制平面:Agent 注册、审批、责任人绑定注册和管理你的 Agent · Agent 的身份模型Roadmap
发起委托 + 授权确认(User × App × GenAuth)POST /api/v3/eak/delegations(interactive)→ GET /api/v3/eak/delegations/:grantId/approval-contextPOST /api/v3/eak/delegations/:grantId/approveConsent 与审批
身份联邦,仅私有化(GenAuth × Human IAM)OIDC 联邦登录 + 用户映射整合原理Roadmap
缩权校验:三方交集(GenAuth × Human IAM)用户真实权限评估Delegate Token 与缩权Roadmap
签发委托令牌(GenAuth)POST /api/v3/eak/delegations/callback/consume → 委托令牌Delegate Token 与缩权 · Token 与 Claim 参考
令牌兑换(Agent × GenAuth)POST /api/v3/eak/token-exchange(RFC 8693)Delegate Token 与缩权 · 让 Agent 代表用户调用你的 API
资源侧校验(App:资源服务/网关)sub / act / scope 交集校验保护你的 API:资源侧集成Roadmap
审计与吊销(GenAuth × User/管理员)audit_id 全链贯穿;POST /api/v3/eak/delegations/introspect;分层吊销审计与追责链 · 吊销与应急处置

标注 Roadmap 的跳怎么读

标注 Roadmap 的环节,概念与设计已定型(两张图即按此目标态绘制),接口与操作步骤以正式发布为准。对应文档页会在首屏给出同样的徽章说明。

两形态的差异,就是⑧

只有这一处不同:

  • SaaS 形态:用户身份由 GenAuth 托管侧确认,授权确认页直达,全程 7 跳;
  • 私有化形态:人的身份权威在你的 Human IAM,所以 Consent 之前先走⑧——OIDC 联邦登录 + 用户映射,把"确认授权的这个人"锚定到你目录里的真实员工,全程 8 跳。

其余七跳,两形态逐条一致:同一套概念、同一套 API、同一套审计链。这也是"两形态代码零差异"的底气所在(见 部署形态)。

下一步