跨服务 Agent 集成:用户级 JWT 铸造、JWKS 验签、inject/memory/usage 三类接口、幂等 externalId
把 mini-multi-agent 服务和 mini-koda 打通:铸造用户级 JWT、用 JWKS 验签,并对接 inject、memory、usage 三类接口,保证幂等。
今日目标
- 能实现用户级 JWT 的铸造流程,并说明它和服务级令牌的区别
- 能实现用 JWKS 验签,验证跨服务请求的合法性
- 能对接 inject/memory/usage 三类接口,并用 externalId 保证幂等
昨天那张图已经能自己跑完、能压缩历史、能从检查点恢复。但它到现在为止还是一座孤岛:所有输入都来自你手动喂进去的一句话。今天把它和 W2 那套 Agent 平台接上——这是本课两个里程碑项目第一次连起来。读完回到页面顶部,把上面三条勾掉。
小白版讲解
你在别国办事,出示的是自己的护照
先把今天要连的两头摆清楚。W2 建的 mini-koda 是一个 Agent 平台:它有会话、有执行记录、有长期记忆、有成本台账,用户的数据都在它这儿。W3 建的多 Agent 编排服务是另一个进程、另一个仓库、另一支团队在管,它跑完一轮分诊和退款草案之后,需要把结论写回用户的会话里,也需要读一读这个用户以前说过什么。
于是问题变成:两个服务之间凭什么信任对方?
最省事的答案是发一把钥匙。平台生成一个长长的随机字符串交给编排服务,对方每次请求带上它,平台一比对,对上就放行。这就是服务级令牌(service token),也是绝大多数团队上线第一版时的做法。它的问题不在于不安全,而在于一旦出事,你什么补救手段都没有。
换成出国办事的场景就一目了然了。服务级令牌相当于 B 国给 A 国某家公司发了一把万能钥匙:拿着它的人可以走进任何一间办公室、调阅任何一份档案。而正常的做法是每个人带自己的护照入境,边检看的是这个人是谁、来做什么、签证有效期到哪天。
用户级令牌(user token)就是那本护照。 它由编排服务签发,但代表的是某一个具体用户,里面写着这个用户的 id 和这次能做哪些事。三个理由让它不是「更规范一点」而是「必须这么做」:
第一,爆炸半径。服务级令牌泄露一次,等于全平台所有用户的数据一起泄露,而且你连是从哪儿漏的都不知道;用户级令牌泄露一张,最多丢一个用户的数据,而且十五分钟后自动作废。
第二,审计追不到人。事故复盘时你只能查到「编排服务在 03:14 调了一次写接口」,查不到它当时替谁在操作。有了 sub 这个字段,每一条访问日志都能落到具体用户身上。
第三,下游没法做用户级权限判断。平台这边的 memory 接口要回答「该返回谁的记忆」,如果身份只能从请求体里读,那就等于把这个问题交给了调用方自己回答——而调用方是可以写错、也可以撒谎的。
那这本护照里该写什么?答案比多数人想的要少得多。JWT 的载荷是 base64 编码,不是加密,任何人拿到 token 都能直接解开看:
eyJhbGciOiJSUzI1NiIsImtpZCI6ImFnZW50LWtleS0xIn0.eyJzY29wZSI6...
↓ 把中间那段 base64 解开,不需要任何密钥
{
"sub": "u-1",
"iss": "http://127.0.0.1:4019",
"aud": "mini-koda",
"scope": "inject:write memory:read",
"jti": "5968-2b94-2db3-4fe0",
"iat": 1788566547,
"exp": 1788567447
}本课的口径固定成这五个字段(外加签发时间 iat 与过期时间 exp):sub 是用户 id,iss 是谁签的,aud 是签给谁用的,scope 是这次授权做哪几件事,jti 是这张令牌自己的编号。业务数据一个都不许进来。 两个理由,都很硬:一是它根本藏不住,把用户手机号、会员等级写进去等于明文发在公网上;二是它写进去的那一刻就过时了——用户十分钟后降级成免费版,那张令牌里还写着「会员」,而它要到十五分钟后才失效。令牌只回答「你是谁、能做什么」,「你现在是什么状态」永远要去数据库现查。
护照要能用,前提是边检能验出真伪。但边检不会为了核实一本护照就打个越洋电话回签发国——那怎么验?
面试题库
两个服务之间调用,你会用服务级令牌还是用户级令牌?分别适用于什么场景?For service-to-service calls, would you use a service token or a user token? When does each apply?
国内高频海外高频进阶#auth#security#api-design🔒 解锁本章后查看答题要点。
JWKS 验签是怎么工作的?为什么跨服务场景下它比共享密钥更合适?How does JWKS-based verification work, and why does it fit cross-service scenarios better than a shared secret?
国内高频海外高频基础#auth#jwt#security🔒 解锁本章后查看答题要点。
跨服务调用的幂等键该怎么设计?由谁生成、存在哪、重复了返回什么?How do you design an idempotency key for cross-service calls — who generates it, where does it live, and what do you return on a repeat?
国内高频海外高频进阶#idempotency#distributed-systems#api-design🔒 解锁本章后查看答题要点。
设计一组给外部服务调用的 Agent 平台接口,你会怎么划分职责边界?You are designing the API surface an Agent platform exposes to other services. How do you draw the responsibility boundaries?
国内高频海外高频深入#api-design#security#architecture🔒 解锁本章后查看答题要点。
