Jenkins Webhook返回403：BitBucket集成触发构建失败的配置问询

背景 #

我正在将BitBucket与Jenkins集成，已在BitBucket中创建Webhook。该Webhook的URL在浏览器中输入可正常触发Jenkins构建，但通过向BitBucket仓库推送代码触发Webhook时，调用同一URL却返回403错误。

问题 #

如何配置Webhook以正常调用Jenkins触发构建？

补充信息 #

我完全按照某YouTube教程操作，教程中要求禁用CSRF Protection，但我的Jenkins版本（2.375.2）中找不到该选项。

现有配置 #

Jenkins项目配置 #

路径：仪表盘 -> pow-wow（我的项目）-> 配置 -> 构建触发器

BitBucket配置 #

路径：Bitbucket -> 仓库 -> pow-wow（我的仓库）-> 仓库设置 -> Webhooks

触发URL #

https://xxxxxxxx/job/BitBucket%20PowWow/build?token=jenkinsToken

Jenkins全局安全配置 #

路径：仪表盘 -> 管理Jenkins -> 配置全局安全

问题详情 #

浏览器中输入触发URL可正常构建，但执行git push时，BitBucket触发Webhook调用该URL返回403错误。

解决步骤 #

1. 核对触发令牌一致性
   确保Jenkins项目「构建触发器」中「触发远程构建」的「身份验证令牌」与URL中token=jenkinsToken的令牌完全一致，无拼写或大小写错误。

2. 适配CSRF保护机制
   Jenkins 2.375.2默认启用CSRF保护且无法直接禁用，需给BitBucket的Webhook请求添加CSRF令牌：

   • 登录Jenkins，进入「管理Jenkins」->「配置全局安全」，找到「CSRF保护」区域，复制页面上的CRUMB值；或通过API获取：发送GET请求到https://你的Jenkins地址/crumbIssuer/api/json，提取crumb字段值。
   • 在BitBucket的Webhook编辑页面，添加自定义请求头：Jenkins-Crumb: 复制的CRUMB值。

3. 调整Jenkins权限设置

   • 匿名构建权限：若使用矩阵式授权策略，在「管理Jenkins」->「配置全局安全」->「授权策略」中，给「匿名用户」勾选「Job: 构建」权限；若为项目级授权，在对应项目的「配置」->「权限」中给匿名用户添加构建权限。
   • IP豁免：将BitBucket服务器的IP地址加入Jenkins「管理Jenkins」->「系统配置」->「代理设置」中的「绕过代理主机」列表，避免请求被拦截。

4. 确认请求方式匹配
   BitBucket默认发送POST请求，浏览器访问是GET请求。确保Jenkins触发URL支持POST：添加CSRF令牌后，POST请求即可正常触发构建，无需修改URL结构。

内容的提问来源于stack exchange，提问作者Richard