Spring Boot实现Agent签名写网关
前一篇讲了为什么 Agent 写数据库前应该先签名。这一篇直接落地一个最小 Spring Boot Write Gateway。目标链路Agent ↓ Signed Action ↓ Spring Boot Gateway ├─ Signature Verify ├─ Expiry ├─ Idempotency ├─ Authorization ├─ Business Rule └─ Audit ↓ Database重点不是把 KMS SDK 塞进 Controller而是把“状态变更”变成一个可验证的协议。第一步定义Action EnvelopepublicrecordSignedActionRequest(StringagentId,StringrunId,StringsubjectId,Stringpurpose,Stringcapability,StringresourceId,StringgrantId,StringapprovalId,StringidempotencyKey,InstantexpiresAt,JsonNodepayload,StringkeyId,StringkeyVersion,Stringsignature){}这里几个字段不能省agentId runId capability resourceId idempotencyKey expiresAt否则签名很难绑定到真正的业务动作。第二步Canonical Payload签名不能直接对 JavatoString()。定义publicinterfaceActionCanonicalizer{byte[]canonicalize(SignedActionRequestrequest);}实现时只把参与签名的字段放进去。ComponentpublicclassJsonActionCanonicalizerimplementsActionCanonicalizer{privatefinalObjectMappermapper;Overridepublicbyte[]canonicalize(SignedActionRequestrequest){ObjectNodenodemapper.createObjectNode();node.put(agent_id,request.agentId());node.put(run_id,request.runId());node.put(subject_id,request.subjectId());node.put(purpose,request.purpose());node.put(capability,request.capability());node.put(resource_id,request.resourceId());node.put(grant_id,request.grantId());node.put(approval_id,request.approvalId());node.put(idempotency_key,request.idempotencyKey());node.put(expires_at,request.expiresAt().toString());node.set(payload,request.payload());try{returnmapper.writer().with(SerializationFeature.ORDER_MAP_ENTRIES_BY_KEYS).writeValueAsBytes(node);}catch(JsonProcessingExceptione){thrownewIllegalStateException(e);}}}生产环境建议使用真正的 JSON Canonicalization Scheme而不是只靠 Map 排序。第三步先算Action HashComponentpublicclassActionHasher{publicStringsha256(byte[]content){try{MessageDigestdigestMessageDigest.getInstance(SHA-256);returnHexFormat.of().formatHex(digest.digest(content));}catch(NoSuchAlgorithmExceptione){thrownewIllegalStateException(e);}}}这个 Hash 后面同时绑定签名 Approval Idempotency Audit不要各算各的。第四步Signature Verifier做接口publicinterfaceAgentSignatureVerifier{VerificationResultverify(StringkeyId,StringkeyVersion,byte[]canonicalPayload,Stringsignature);}这样生产可以接Cloud KMS HSM Vault Transit AWS KMS测试环境可以用本地公钥。本地RSA验证示例ComponentpublicclassRsaSignatureVerifierimplementsAgentSignatureVerifier{privatefinalAgentPublicKeyStorekeyStore;OverridepublicVerificationResultverify(StringkeyId,StringkeyVersion,byte[]payload,StringsignatureBase64){try{PublicKeykeykeyStore.load(keyId,keyVersion);SignaturesignatureSignature.getInstance(SHA256withRSA);signature.initVerify(key);signature.update(payload);booleanvalidsignature.verify(Base64.getDecoder().decode(signatureBase64));returnvalid?VerificationResult.valid():VerificationResult.invalid(SIGNATURE_MISMATCH);}catch(GeneralSecurityExceptione){returnVerificationResult.invalid(VERIFY_ERROR);}}}生产 Agent 不保存私钥。这里只加载 Public Key。第五步Expiry先于数据库写ComponentpublicclassActionExpiryValidator{privatefinalClockclock;publicvoidvalidate(SignedActionRequestrequest){if(request.expiresAt().isBefore(clock.instant())){thrownewActionExpiredException();}}}Clock 要注入。以后 Replay / Test 才能固定时间。第六步Idempotency必须数据库唯一EntityTable(nameagent_write_idempotency,uniqueConstraints{UniqueConstraint(columnNamesidempotencyKey)})publicclassIdempotencyEntity{IdprivateStringid;privateStringidempotencyKey;privateStringactionHash;Enumerated(EnumType.STRING)privateWriteStatusstatus;privateStringresultRef;privateInstantcreatedAt;}状态publicenumWriteStatus{STARTED,COMMITTED,FAILED,UNKNOWN}为什么要有UNKNOWN最危险窗口数据库提交成功 ↓ Gateway返回前进程Crash调用方重试。如果只看到timeout很容易重复写。所以如果结果无法确定UNKNOWN下一次调用必须Reconcile不能直接再次执行。第七步同Idempotency Key不同Hash要报警publicIdempotencyDecisioncheck(Stringkey,StringactionHash){OptionalIdempotencyEntityexistingrepository.findByIdempotencyKey(key);if(existing.isEmpty()){returnNEW;}if(!existing.get().getActionHash().equals(actionHash)){thrownewIdempotencyConflictException();}returnREPLAY;}这类冲突不应该返回409普通业务错误而应该进入安全审计。第八步Authorization Validator签名有效不代表有权写。publicinterfaceActionAuthorizationService{AuthorizationDecisionauthorize(SignedActionRequestrequest,StringactionHash);}至少检查Agent Identity Grant Purpose Capability Resource Ownership ApprovalApproval也绑定同一个HashpublicvoidrequireApproval(SignedActionRequestrequest,StringactionHash){if(request.approvalId()null){thrownewApprovalRequiredException();}ApprovalRecordapprovalapprovalRepository.load(request.approvalId());if(!approval.actionHash().equals(actionHash)){thrownewApprovalMismatchException();}}审批以后payload任何关键字段变化都会重新计算 Hash。旧 Approval 自动失效。第九步Business Rule最后再做例如退款ComponentpublicclassRefundBusinessPolicy{publicvoidvalidate(RefundPayloadpayload,Orderorder){if(payload.amountMinor()order.refundableMinor()){thrownewRefundLimitException();}if(order.status()OrderStatus.CLOSED){thrownewInvalidOrderStateException();}}}签名和授权都通过以后仍然必须过业务规则。第十步事务边界TransactionalpublicWriteResultexecute(SignedActionRequestrequest){byte[]canonicalcanonicalizer.canonicalize(request);StringactionHashhasher.sha256(canonical);expiryValidator.validate(request);signatureService.requireValid(request,canonical);authorizationService.requireAllowed(request,actionHash);IdempotencyDecisiondecisionidempotencyService.begin(request.idempotencyKey(),actionHash);if(decision.isReplay()){returnidempotencyService.loadResult(request.idempotencyKey());}WriteResultresultmutationService.execute(request);idempotencyService.markCommitted(request.idempotencyKey(),result);auditService.append(request,actionHash,result);returnresult;}如果 Audit 必须和业务写强一致可以Transactional Outbox不要直接同步发 Kafka。Audit EventpublicrecordSignedWriteAuditEvent(StringeventId,StringagentId,StringrunId,StringsubjectId,Stringcapability,StringresourceId,StringactionHash,StringkeyId,StringkeyVersion,StringgrantId,StringapprovalId,Stringresult,InstantoccurredAt){}不要把完整敏感 Payload 直接写日志。保存Hash Encrypted Evidence Ref第十一步Key RegistryEntitypublicclassAgentSigningKeyEntity{IdprivateStringkeyId;privateStringagentId;privateStringkeyVersion;privateStringpublicKeyRef;Enumerated(EnumType.STRING)privateKeyStatusstatus;privateInstantvalidFrom;privateInstantvalidUntil;}状态publicenumKeyStatus{ACTIVE,VERIFY_ONLY,REVOKED,EXPIRED}轮换后旧 KeyVERIFY_ONLY历史记录还能验证但不能再用于新签名。第十二步Agent和Key必须一一约束如果 Requestagent_idrefund-agent却使用research-agent-key必须拒绝。if(!key.agentId().equals(request.agentId())){thrownewAgentKeyMismatchException();}这是非常重要的身份绑定。第十三步Metricsagent_write_total{ capability, result } agent_signature_invalid_total{ reason } agent_idempotency_conflict_total agent_write_unknown_total agent_approval_mismatch_total agent_key_mismatch_total不要把run_id放 Metric Tag。Run 细节放 Trace。Traceagent.write ├─canonicalize ├─signature.verify ├─expiry.validate ├─authorization ├─idempotency ├─business.validate ├─mutation └─audit一条写操作到底卡在哪层一眼能看到。第十四步失败要分层publicenumWriteFailureCode{SIGNATURE_INVALID,KEY_REVOKED,ACTION_EXPIRED,AUTHORITY_DENIED,APPROVAL_MISMATCH,IDEMPOTENCY_CONFLICT,BUSINESS_RULE_DENIED,MUTATION_FAILED,RESULT_UNKNOWN}不要全部抛WRITE_FAILED这会让事故分析非常痛苦。第十五步最重要的单元测试TestvoidchangedPayloadMustInvalidateApproval(){SignedActionRequestrequestfixture.approvedRefund();StringoldHashfixture.approvalHash();SignedActionRequestchangedfixture.withAmount(request,99900L);assertNotEquals(oldHash,hash(changed));assertThrows(ApprovalMismatchException.class,()-gateway.execute(changed));}还要测这些签名被篡改 Payload被篡改 Key已撤销 Action过期 Agent-Key不匹配 相同Key重复请求 相同Key不同Hash Grant撤销 Approval Hash不一致 事务提交后响应丢失最后一个 Case 要配UNKNOWN Reconcile网关的部署边界不要让 Agent 同时拥有Write Gateway Direct DB否则所有检查都能绕过。网络策略Agent → Write Gateway允许。Agent → DB拒绝。只有 Gateway Service Account 有数据库写权限。Spring Boot 这层真正解决的不是“怎么验一个RSA签名”。它把生产 Agent 的写操作固化成一条确定性链谁 →签了什么 →基于什么授权 →有没有过期 →是否重复 →业务是否允许 →最终写了什么只要 Agent 可以改真实状态这条链就比 Prompt 里的任何“请谨慎操作”更重要。模型可以负责提出动作。真正决定能不能落库的应该一直是这层确定性网关。

相关新闻

Agent写库前先签名:零信任写操作怎么做

Agent写库前先签名:零信任写操作怎么做

很多 Agent 系统现在已经能: 改数据库 改CRM 发退款 写工单 更新配置但真正落到生产以后,一个很难回答的问题是: 数据库里这一行, 到底是谁改的?如果所有 Agent 都通过同一个连接池、同一个 Service Account 写入&…

2026/11/17 19:15:47 阅读更多 →
Copilot全局模型策略:企业别再靠默认开启

Copilot全局模型策略:企业别再靠默认开启

企业接入多模型以后,一个非常常见的状态是: 管理员没有明确配 ↓ 平台新模型上线 ↓ 用户自动就能用了这对个人用户很方便,对企业治理却不一定合适。 GitHub 8月26日开始逐步执行 Copilot 的 Global Model Policy,并计划在 9月1日…

2026/11/6 0:23:36 阅读更多 →
Agent day_6:Python中requests和response使用、HTTP状态码、浏览器的拓展、JSON结构的转换、历史记录与摘要的存储、上下文和记忆设计、summary和memory区别

Agent day_6:Python中requests和response使用、HTTP状态码、浏览器的拓展、JSON结构的转换、历史记录与摘要的存储、上下文和记忆设计、summary和memory区别

day_6requests请求方法方法作用常用场景示例requests.get()发送 GET 请求查询数据、获取网页、下载资源requests.get(url)requests.post()发送 POST 请求登录、提交表单、创建数据requests.post(url, jsondata)requests.put()更新资源(整体修改)修改用户…

2026/11/6 12:26:46 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/17 8:22:52 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/17 12:46:04 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/17 12:46:04 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/17 11:26:33 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/17 12:46:05 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/17 12:46:05 阅读更多 →

日新闻

周新闻

月新闻