9.3. 管理个人访问令牌
通过个人访问令牌，您可以在不使用您的密码的情况下对 API 请求进行身份验证。您可以为个人访问令牌设置过期日期。如果您决定它应在过期日期前过期，可以撤销它。
9.3.1. 创建一个个人访问令牌
使用这个流程创建个人访问令牌。
流程
- 在 Satellite Web UI 中，进入到 Administer > Users。
- 选择您要为其创建个人访问令牌的用户。
- 在 Personal Access Tokens 选项卡中，点 Add Personal Access Token。
- 输入个人访问令牌的名称。
- 可选：选择 Expires 日期来设置过期日期。如果您没有设置过期日期，您的个人访问令牌将永远不会过期，除非被撤销。
点 Submit。到此，在 Personal Access Tokens 选项卡会包括您可用的个人访问令牌。
重要确保存储您的个人访问令牌，因为您将无法在离开页面或创建新的个人访问令牌后再次访问它。您可以点 Copy to clipboard 复制个人访问令牌。
验证
向 Satellite 服务器发出 API 请求，并使用您的个人访问令牌进行身份验证：
# curl https://satellite.example.com/api/status --user My_Username:My_Personal_Access_Token
您应该收到状态为
200的响应，例如：{"satellite_version":"6.14.0","result":"ok","status":200,"version":"3.5.1.10","api_version":2}如果您再次返回 Personal Access Tokens 选项卡，您可以在个人访问令牌旁看到最后使用时间。
9.3.2. 撤销个人访问令牌
使用这个流程在过期日期前撤销个人访问令牌。
流程
- 在 Satellite Web UI 中，进入到 Administer > Users。
- 选择您要撤销个人访问令牌的用户。
- 在 Personal Access Tokens 选项卡中，找到您要撤销的个人访问令牌。
- 在您要撤销的个人访问令牌旁边的 Actions 列中点 Revoke。
验证
向 Satellite 服务器发出 API 请求，并尝试使用撤销的个人访问令牌进行身份验证：
# curl https://satellite.example.com/api/status --user My_Username:My_Personal_Access_Token
您会收到以下出错信息：
{ "error": {"message":"Unable to authenticate user My_Username"} }
