个人访问令牌
创建和管理具有特定权限范围的长效 API 令牌,用于脚本编写和自动化。
个人访问令牌#
个人访问令牌(PAT)让您无需经过 OAuth 授权流程即可对 API 请求进行鉴权。它们非常适合脚本、CI 流水线以及无法进行交互式登录的集成场景。
PAT 在个人资料 → 访问令牌(/tokens)页面管理。
创建令牌#
点击新建令牌。
输入一个描述性的名称(例如 CI deploy script、Home automation)。
选择有效期:7、30、90 或 365 天——或留空表示永不过期。
勾选令牌所需的权限范围。请按最小权限原则授予。
点击生成令牌。
立即复制令牌——它仅显示一次,之后无法再次获取。
使用令牌#
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 访问令牌的区别#
| 创建方式 | 用户(通过 UI 或 API) | OAuth 授权流程 |
| 前缀 | prism_pat_ | (无) |
| 权限范围 | 创建时由用户选择 | 由用户在授权页面授予 |
| 刷新 | 不支持——撤销后重新创建 | 支持,通过 offline_access 范围 |
| 撤销方式 | 个人资料 → 访问令牌页面 | 个人资料 → 已连接应用页面 |
| 适用场景 | 脚本、CI、自动化 | 第三方应用 |