3.3. 个人访问令牌身份验证概述

Red Hat Satellite 支持可用于验证 API 请求的个人访问令牌，而不使用您的密码。您可以为个人访问令牌设置过期日期。如果您决定它应在过期日期前过期，可以撤销它。

3.3.1. 创建一个个人访问令牌

使用这个流程创建个人访问令牌。

流程

  1. 在 Satellite Web UI 中，进入到 Administer > Users。
  2. 选择您要为其创建个人访问令牌的用户。
  3. 在 Personal Access Tokens 选项卡中，点 Add Personal Access Token。
  4. 输入个人访问令牌的名称。
  5. 可选：选择 Expires 日期来设置过期日期。如果您没有设置过期日期，您的个人访问令牌将永远不会过期，除非被撤销。

  6. 点 Submit。到此，在 Personal Access Tokens 选项卡会包括您可用的个人访问令牌。

    重要

    确保存储您的个人访问令牌，因为您将无法在离开页面或创建新的个人访问令牌后再次访问它。您可以点 Copy to clipboard 复制个人访问令牌。

验证

  1. 向 Satellite 服务器发出 API 请求，并使用您的个人访问令牌进行身份验证： 

    # curl https://satellite.example.com/api/status --user My_Username:My_Personal_Access_Token

  2. 您应该收到状态为 200 的响应，例如： 

    {"satellite_version":"6.12.0","result":"ok","status":200,"version":"3.5.1.10","api_version":2}

    如果您再次返回 Personal Access Tokens 选项卡，您可以在个人访问令牌旁看到最后使用时间。

3.3.2. 撤销个人访问令牌

使用这个流程在过期日期前撤销个人访问令牌。

流程

  1. 在 Satellite Web UI 中，进入到 Administer > Users。
  2. 选择您要撤销个人访问令牌的用户。
  3. 在 Personal Access Tokens 选项卡中，找到您要撤销的个人访问令牌。
  4. 在您要撤销的个人访问令牌旁边的 Actions 列中点 Revoke。

验证

  1. 向 Satellite 服务器发出 API 请求，并尝试使用撤销的个人访问令牌进行身份验证： 

    # curl https://satellite.example.com/api/status --user My_Username:My_Personal_Access_Token

  2. 您会收到以下出错信息： 

    {
  "error": {"message":"Unable to authenticate user My_Username"}
}