个人访问令牌

创建和管理具有特定权限范围的长效 API 令牌,用于脚本编写和自动化。

个人访问令牌#

个人访问令牌(PAT)让您无需经过 OAuth 授权流程即可对 API 请求进行鉴权。它们非常适合脚本、CI 流水线以及无法进行交互式登录的集成场景。

PAT 在个人资料 → 访问令牌(/tokens)页面管理。

创建令牌#

  1. 点击新建令牌。

  2. 输入一个描述性的名称(例如 CI deploy script、Home automation)。

  3. 选择有效期:7、30、90 或 365 天——或留空表示永不过期。

  4. 勾选令牌所需的权限范围。请按最小权限原则授予。

  5. 点击生成令牌。

  6. 立即复制令牌——它仅显示一次,之后无法再次获取。

使用令牌#

PAT 与 OAuth 访问令牌使用相同的 Authorization: Bearer 请求头:

http
Authorization: Bearer prism_pat_<token>

使用 curl 的示例:

bash
curl https://your-prism-domain/api/oauth/me/profile \
  -H "Authorization: Bearer prism_pat_<token>"

权限范围参考#

完整的权限范围列表及各项说明,请参阅 OAuth → 权限范围。

注意:管理员范围(admin:*)对 PAT 可用,但仅在令牌所有者具有 role = admin 时生效。

撤销令牌#

在列表中点击任意令牌旁边的撤销按钮。撤销立即生效——任何使用该令牌的进行中请求都会以 403 失败。

安全建议#

  • 仅使用满足您用例所需的最小权限范围。

  • 尽可能设置有效期。无有效期的令牌将一直有效,直到被手动撤销。

  • 将令牌存储在环境变量或密钥管理器中,不要写入源代码。

  • 定期轮换令牌,尤其是在共享 CI 环境中。

  • 如果令牌泄露,请立即在个人资料 → 访问令牌页面将其撤销。

与 OAuth 访问令牌的区别#

个人访问令牌
OAuth 访问令牌
创建方式用户(通过 UI 或 API)OAuth 授权流程
前缀prism_pat_(无)
权限范围创建时由用户选择由用户在授权页面授予
刷新不支持——撤销后重新创建支持,通过 offline_access 范围
撤销方式个人资料 → 访问令牌页面个人资料 → 已连接应用页面
适用场景脚本、CI、自动化第三方应用