如何在GitHub Webhook负载URL中引用Jenkins密钥作为Token？

问题根源 #

你之前在GitHub Webhook URL中使用${{ Secret }}的语法是Jenkins内部的变量规则，但GitHub服务器发起请求时无法识别该语法，会直接把${{ Secret }}当作字符串传递，导致Jenkins无法匹配到正确的Token，触发构建失败。

正确解决方案 #

方式一：借助GitHub Secrets传递Token（推荐）

1. 进入GitHub仓库的 Settings > Secrets and variables > Actions 页面，点击 New repository secret，创建一个新密钥（比如命名为JENKINS_TRIGGER_TOKEN），值填入Jenkins中存储的Token内容。
2. 在GitHub Webhook配置页面，将Payload URL设置为：

   https://JENKINS_URL/generic-webhook-trigger/invoke?token=${{ secrets.JENKINS_TRIGGER_TOKEN }}
   

   GitHub发起请求时会自动替换变量为实际Token值，确保Jenkins能正确识别。

方式二：在Jenkins任务中绑定Token凭据，无需URL传参

1. 打开Jenkins对应任务的配置页面，找到 Generic Webhook Trigger 配置项。
2. 展开 Token Credential ID 下拉框，选择你在Jenkins中存储的目标密钥（即截图中的凭据）。
3. 将GitHub Webhook的Payload URL改为不带token参数的地址：

   https://JENKINS_URL/generic-webhook-trigger/invoke
   

4. 在GitHub Webhook配置中开启Basic Auth认证：用户名可任意填写，密码填入Jenkins中存储的Token值（也可以将密码存在GitHub Secrets中，用${{ secrets.xxx }}引用）。

内容的提问来源于stack exchange，提问作者devops-admin