SuperAPI AI 工具集

jira-webhooks

测试与质量

查看项目

更新于 10-15 22:14

技能介绍

用途:帮助开发者搭建 Jira Cloud Webhook 接收端,完成签名验证与事件分发,适用于处理 issue 创建、更新、删除,评论增删改,以及 worklog 记录等场景。

主要能力:管理员 Webhook(在 Jira 管理页或通过 POST /rest/webhooks/1.0/webhook 创建)若设置了 secret,Jira Cloud 会用该 secret 对原始请求体做 HMAC-SHA256 签名,摘要放在 X-Hub-Signature 头(非 X-Hub-Signature-256),格式为 sha256=<hex>,需在解析 JSON 前对原始 body 做时序安全比较。未设 secret 的管理员 Webhook 不签名。应用 Webhook 采用不同方案:Connect 描述符 Webhook 使用 sharedSecret 签名的 JWT,OAuth 2.0 动态 Webhook(POST /rest/api/3/webhook)使用 client secret 签名的 bearer JWT,均放在 Authorization 头。

事件识别:Jira 不发送事件类型头,事件名在 JSON body 的 webhookEvent 字段中,如 jira:issue_created、jira:issue_updated、jira:issue_deleted、comment_created、comment_updated、comment_deleted、worklog_created。其他重要头包括 X-Atlassian-Webhook-Identifier(唯一投递标识)。

使用方式:设置环境变量 JIRA_WEBHOOK_SECRET=your_webhook_secret;本地开发可用 npx hookdeck-cli listen 3000 jira --path /webhooks/jira 启动隧道。完整处理器(路由、事件分发、测试)见 examples/express/、examples/nextjs/、examples/fastapi/。建议配合 webhook-handler-patterns 技能处理幂等、错误与重试。

限制:资料未提供具体收费、平台支持范围或性能数据;签名验证失败常见原因与完整事件参考需查阅 references/verification.md 与 Jira 官方事件文档。