Jenkins API token

### 如何生成和使用 Jenkins API Token

#### 生成 Jenkins API Token

为了安全地与 Jenkins 进行交互，推荐使用 API Token 而不是用户名/密码组合。以下是创建新 API Token 的方法：

登录到 Jenkins 控制台后，导航至用户设置页面。通过点击左侧菜单中的 "People" 或者右上角的用户名链接进入个人配置界面。选择目标用户账户并找到 "Configure" 链接。

在用户配置页面中向下滚动直到看到 **API Tokens** 部分。这里可以选择生成新的令牌。单击 “Add API Token”，这会弹出对话框提示保存此令牌副本因为它只会在创建时显示一次[^1]。

# 使用 curl 命令测试 API 访问权限
curl -u 用户名:api-token-string http://your-jenkins-url/api/json

#### 使用 Jenkins API Token

一旦拥有了有效的 API Token 字符串，则可以在各种场景下利用它来代替明文密码执行远程调用操作。例如，在命令行工具里可以通过 `-u` 参数传递认证信息给 `curl` 工具；也可以将其嵌入脚本文件用于自动化任务调度等场合。

对于持续集成管道定义（如 Groovy），可以直接引用环境变量 `${env.JENKINS_API_TOKEN}` 来读取预先设定好的密钥值[^2]。

另外值得注意的是，当涉及到敏感数据传输时应当始终启用 HTTPS 协议加密通讯链路，并遵循最小特权原则分配必要的访问控制列表(ACL)，从而最大限度保障系统的安全性[^3]。