用途:在接收 Ideogram 异步生成完成回调时,先做密码学验证与幂等对账,再确认结果;因投递不保证送达,需保留轮询作为恢复路径。
主要能力:使用原始请求体与签名头(generation ID、user ID、timestamp、key ID、signature)验证 Ed25519 签名;对原始体计算 SHA-256,按 generation ID、换行、user ID、换行、timestamp、换行、小写体哈希构造签名消息;从 JWKS 缓存解析 key ID 并验证小写十六进制签名;限制时间戳窗口,绑定已提交的 generation 与预期租户;按 generation 与投递证据持久化去重记录,快速返回 2xx 并入队处理;验证失败时刷新一次 JWKS;缺失投递时用返回的 generation ID 轮询 GET /v1/generations/。
使用方式:需要公网 HTTPS 接收端、原始体访问、持久事件存储、队列与时钟;准备有效、无效、过期、重复、轮换密钥的本地 Ed25519 测试夹具。轮询使用服务端 IDEOGRAM_API_KEY 放在 Api-Key 头,绝不暴露给接收端请求。
限制与注意:不得验证重新序列化的 JSON,空白变化会破坏原始体完整性;未知密钥或验证失败只刷新一次 JWKS 后拒绝;重复或迟到的有效投递属于幂等场景,不授权创建新资产;公开路由、生产密钥、实时提交、重放窗口变更、保留标识符、存储或发布均需审批;接收端日志不得包含签名体或内容。输出应包含接收路由类别、签名与重放结果、不透明 generation ID、重复状态、确认延迟、下游终态与存储状态、轮询兜底与清理,排除头、体、URL、提示词与图像。