讲师中心 微信公众号
AI工具推荐 视频效率加速

Codex怎么校验Webhook请求的签名

落敏吖_1619

落敏吖_1619

发布时间:2026-10-19 13:26:48

|

124人浏览过

|

来源于php中文网

原创

验证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,不执行后续业务逻辑。

热门AI工具

更多
二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

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

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

554

2026.05.26

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

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

244

2026.05.26

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

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

177

2026.05.26

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

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

410

2026.05.27

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

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

228

2026.06.10

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

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

20

2026.10.16

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

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

20

2026.10.16

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

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

0

2026.10.16

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

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

20

2026.10.16

热门下载

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

精品课程

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

共0课时 | 167人学习

Codex官方文档
Codex官方文档

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn