Codex怎么校验Webhook请求的签名

落敏吖_1619

落敏吖_1619

2026-10-19

124人浏览

原创

验证codex webhook签名需先提取x-codex-signature和x-codex-timestamp,构造t={timestamp}\n{body}原始消息,用hmac-sha256密钥计算签名并恒定时间比对,且时间戳须在当前±300秒内。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

codex怎么校验webhook请求的签名

验证Codex Webhook请求的签名,是为了确认该请求确实来自Codex服务器而非伪造,避免恶意第三方冒充触发业务逻辑。你必须在收到HTTP请求后、处理业务前完成签名校验,否则将面临未授权操作风险。

获取请求头中的签名和时间戳

从HTTP请求头中提取 X-Codex-Signature 和 X-Codex-Timestamp 两个字段。前者是HMAC-SHA256生成的十六进制签名字符串,后者是Unix秒级时间戳(如 1717023456)。若任一字段缺失或格式非法,直接拒绝请求。

注意:Codex不会发送 X-Codex-Signature-256 或其他变体头,只用 X-Codex-Signature 这一个签名头。

构造待签名原始消息

将时间戳字符串与原始请求体(raw body)按 t={timestamp}\n{body} 格式拼接,中间用换行符(\n)连接,不加空格、不加BOM、不进行URL编码。例如时间戳为 1717023456,body为 {"event":"user.created"},则原始消息为:

t=1717023456\n{"event":"user.created"}

⚠️ 关键点:必须使用原始未解析的body字节流,不能用JSON.parse后再stringify——这会改变空格、换行、转义顺序,导致签名不匹配。

Codex Imagen
Codex Imagen

通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存

下载

用密钥计算预期签名

方法一:使用HMAC-SHA256算法,以你在Codex控制台配置的Webhook密钥(secret)为key,上一步拼接出的原始消息为message,计算HMAC值。

方法二:输出为十六进制小写字符串,长度固定为64位(32字节→64字符)。Python示例:hmac.new(secret.encode(), msg.encode(), hashlib.sha256).hexdigest();Node.js示例:crypto.createHmac('sha256', secret).update(msg).digest('hex')。

如果你用的是base64密钥,请先base64解码再参与HMAC计算——Codex后台使用的密钥是原始字节,不是base64字符串本身。

比对签名并验证时效性

第一步:检查 X-Codex-Timestamp 是否为有效整数,且与当前时间相差不超过5分钟(300秒)。Codex强制要求请求在发出后5分钟内被接收,超时即拒收。

第二步:将计算出的预期签名字符串与请求头中 X-Codex-Signature 的值进行恒定时间比对(constant-time compare),防止时序攻击。不要用 == 或 === 直接比较。

第三步:若时间有效且签名一致,校验通过;任一失败,立即返回HTTP 401或400,不执行后续业务逻辑。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

codex codex后端开发

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Codex AI 编程代理与智能开发工作流
Codex AI 编程代理与智能开发工作流

Codex 是一款超越传统代码生成的 AI 编程代理,致力于构建全生命周期的智能开发工作流。通过持久线程保留上下文,支持多智能体并行协作与后台自动化运维。借助沙箱权限控制、Plan/Steer 任务管理机制,Codex 既能自主拆解并执行复杂工程任务,又能让开发者牢牢掌控项目进程。从需求分析、编码测试到代码审查与部署,Codex 将 AI 深度融入研发全链路,极大提升了软件工程的交付效率与质量标准。

2026.05.26

574

10

Codex API集成与AI编程生态开发
Codex API集成与AI编程生态开发

Codex API 集成是构建下一代 AI 编程生态的核心基石,能通过 API 将强大的代码生成与推理能力无缝接入 VS Code、JetBrains 等主流 IDE 插件,还能将其深度嵌入 CI/CD 流水线,实现自动化的代码审查、单元测试生成与 Bug 修复。结合 Amazon Bedrock 等云平台的托管服务,企业可以灵活打造符合内部安全规范的专属 AI 编程助手。

2026.05.26

244

10

Codex 模型原理与AI软件工程进阶
Codex 模型原理与AI软件工程进阶

Codex 是基于通用大模型底座,通过海量代码语料与真实 Pull Request 进行专项微调的代码专用模型,能深度理解代码语法树与跨文件依赖,实现从自然语言到高质量工程代码的精准转化。在 AI 软件工程进阶中,Codex 推动了从提示词工程向“驾驭工程(Harness Engineering)”的范式跃迁。

2026.05.26

177

10

Codex AI编程工具新手指南
Codex AI编程工具新手指南

全面解析Codex AI编程工具的核心原理、功能特点与实际用途,提供适合新手的Codex入门教程、环境配置方法、代码生成演示与常见问题解答,帮助开发者快速掌握AI自动写代码能力,提升编程学习与开发效率。

2026.05.27

410

10

Codex Agent编程与自主开发能力调优专题
Codex Agent编程与自主开发能力调优专题

PHP中文网为您提供Codex Agent编程与自主开发能力调优专题。针对AI Agent全权委托开发模式,我们为您系统梳理了Harness Engineering(驾驭工程)核心理念,以及涵盖AGENTS.md规范编写、Skills技能配置、Worktree沙盒隔离与多Agent协作架构的实战指南。

2026.06.10

228

7

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

2026.10.16

60

10

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

2026.10.16

40

10

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

2026.10.16

40

10

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

2026.10.16

20

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Codex 应用程序简介
Codex 应用程序简介

共0课时 | 167人学习

Codex官方文档
Codex官方文档

共0课时 | 0人学习

Buffalo & Goth 官方视频教程
Buffalo & Goth 官方视频教程

共0课时 | 0人学习