管理访问权限和权限

流程

1. 点机构的名称。
2. 单击 Default permissions。
3. 单击 Create default permissions。此时会出现 toggle drawer。

4. 选择 Anyone 或 Specific 用户，以在创建存储库时创建默认权限。

   1. 如果选择 Anyone，则必须提供以下信息：

      • 应用到。搜索、邀请或添加用户/机器人/团队。
      • 权限.将权限设置为 Read、Write 或 Admin 之一。

   2. 如果选择特定用户，则必须提供以下信息：

      • 存储库创建者.提供用户或机器人帐户。
      • 应用到。提供用户名、机器人帐户或团队名称。
      • 权限.将权限设置为 Read、Write 或 Admin 之一。
5. 点 Create default permission。此时会出现确认框，返回以下警报： Successfully created default permissions for creator.

流程

1. 输入以下命令使用 POST /api/v1/organization/{orgname}/prototypes 端点创建默认权限：

   $ curl -X POST   -H "Authorization: Bearer <bearer_token>"   -H "Content-Type: application/json"   --data '{
       "role": "<admin_read_or_write>",
       "delegate": {
         "name": "<username>",
         "kind": "user"
       },
       "activating_user": {
         "name": "<robot_name>"
       }
     }'   https://<quay-server.example.com>/api/v1/organization/<organization_name>/prototypes

   Copy to Clipboard Toggle word wrap

   输出示例

   {"activating_user": {"name": "test-org+test", "is_robot": true, "kind": "user", "is_org_member": true, "avatar": {"name": "test-org+test", "hash": "aa85264436fe9839e7160bf349100a9b71403a5e9ec684d5b5e9571f6c821370", "color": "#8c564b", "kind": "robot"}}, "delegate": {"name": "testuser", "is_robot": false, "kind": "user", "is_org_member": false, "avatar": {"name": "testuser", "hash": "f660ab912ec121d1b1e928a0bb4bc61b15f5ad44d5efdc4e1c92a25e99b8e44a", "color": "#6b6ecf", "kind": "user"}}, "role": "admin", "id": "977dc2bc-bc75-411d-82b3-604e5b79a493"}

   Copy to Clipboard Toggle word wrap

2. 输入以下命令，使用 PUT /api/v1/organization/{orgname}/prototypes/{prototypeid} 端点更新默认权限，例如，如果要更改权限类型。您必须包含创建策略时返回的 ID。

   $ curl -X PUT \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Content-Type: application/json" \
     --data '{
       "role": "write"
     }' \
     https://<quay-server.example.com>/api/v1/organization/<organization_name>/prototypes/<prototypeid>

   Copy to Clipboard Toggle word wrap

   输出示例

   {"activating_user": {"name": "test-org+test", "is_robot": true, "kind": "user", "is_org_member": true, "avatar": {"name": "test-org+test", "hash": "aa85264436fe9839e7160bf349100a9b71403a5e9ec684d5b5e9571f6c821370", "color": "#8c564b", "kind": "robot"}}, "delegate": {"name": "testuser", "is_robot": false, "kind": "user", "is_org_member": false, "avatar": {"name": "testuser", "hash": "f660ab912ec121d1b1e928a0bb4bc61b15f5ad44d5efdc4e1c92a25e99b8e44a", "color": "#6b6ecf", "kind": "user"}}, "role": "write", "id": "977dc2bc-bc75-411d-82b3-604e5b79a493"}

   Copy to Clipboard Toggle word wrap

3. 您可以通过输入 DELETE /api/v1/organization/{orgname}/prototypes/{prototypeid} 命令删除权限：

   curl -X DELETE \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
     https://<quay-server.example.com>/api/v1/organization/<organization_name>/prototypes/<prototype_id>

   Copy to Clipboard Toggle word wrap

   此命令不会返回输出。您可以通过输入 GET /api/v1/organization/{orgname}/prototypes 命令来获取所有权限的列表：

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
     https://<quay-server.example.com>/api/v1/organization/<organization_name>/prototypes

   Copy to Clipboard Toggle word wrap

   输出示例

   {"prototypes": []}

   Copy to Clipboard Toggle word wrap

流程

1. 登录到 Red Hat Quay。
2. 在 v2 UI 上，单击 Repositories。
3. 单击存储库的名称，如 quayadmin/busybox。
4. 点 Settings 选项卡。

5. 可选。单击 User and robot permissions。您可以通过单击 权限 下的下拉菜单选项来调整用户或机器人帐户的设置。您可以将设置更改为 Read、Write 或 Admin。

   • 读取.用户或 Robot 帐户可以从存储库查看和拉取。
   • 写入。用户或 Robot 帐户可以从中读取（提取）并将其写入（推送）到存储库。
   • 管理.用户或 Robot 帐户有权访问从存储库拉取并推送到存储库，以及执行与存储库关联的管理任务。

流程

1. 输入以下 PUT /api/v1/repository/{repository}/permissions/user/{username} 命令更改用户权限：

   $ curl -X PUT \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Content-Type: application/json" \
     -d '{"role": "admin"}' \
     https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository>/permissions/user/<username>

   Copy to Clipboard Toggle word wrap

   输出示例

   {"role": "admin", "name": "quayadmin+test", "is_robot": true, "avatar": {"name": "quayadmin+test", "hash": "ca9afae0a9d3ca322fc8a7a866e8476dd6c98de543decd186ae090e420a88feb", "color": "#8c564b", "kind": "robot"}}

   Copy to Clipboard Toggle word wrap

2. 要删除当前权限，您可以输入 DELETE /api/v1/repository/{repository}/permissions/user/{username} 命令：

   $ curl -X DELETE \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
     https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository>/permissions/user/<username>

   Copy to Clipboard Toggle word wrap

   此命令不会返回 CLI 中的任何输出。反之，您可以通过输入 GET /api/v1/repository/{repository}/permissions/user/ 命令来检查权限是否已删除：

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
     https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository>/permissions/user/<username>/

   Copy to Clipboard Toggle word wrap

   输出示例

   {"message":"User does not have permission for repo."}

   Copy to Clipboard Toggle word wrap

流程

1. 在 Red Hat Quay UI 上，单击导航窗格中的 Repositories。
2. 点存储库的名称。
3. 单击导航窗格中的 Settings。
4. 单击 Repository visibility。
5. 单击 Make private。存储库是私有的，只有权限列表中的用户可以查看并与之交互。

流程

1. 在 v2 UI 上，单击 Organizations。
2. 单击您要为其创建机器人帐户的组织名称，如 test-org。
3. 点 Robot accounts 选项卡 → Create robot account。
4. 在 Provide a name for your robot account 框中，输入名称，如 robot1。您的 Robot 帐户的名称是您的用户名与机器人的名称的组合，如 quayadmin+robot1

5. 可选。如果需要，可以使用以下选项：

   1. 将机器人帐户添加到团队。
   2. 将机器人帐户添加到存储库。
   3. 调整机器人帐户的权限。

6. 在 Review and finish 页面中，检查您提供的信息，然后点 Review and finish。此时会出现以下警报： Successfully created robot account with robot name: <organization_name> + <robot_name>。

   或者，如果您尝试创建名称与另一个机器人帐户相同的机器人帐户，您可能会收到以下出错信息： Error create robot account。

7. 可选。您可以单击 Expand 或 Collapse 来显示有关机器人帐户的描述性信息。
8. 可选。您可以点击 kebab 菜单 → Set repository 权限来更改机器人帐户的权限。此时会出现以下信息： Successfully updated repository permission。

9. 可选。您可以点击机器人帐户的名称来获取以下信息：

   • 机器人帐户 ：选择此项获取机器人令牌。您可以点 Regenerate token 来重新 生成令牌。
   • Kubernetes Secret ：选择此项以 Kubernetes pull secret YAML 文件的形式下载凭证。
   • Podman: 选择它复制包含凭据的完整 podman login 命令行。
   • Docker Configuration ：选择此项复制包含凭据的完整 docker login 命令行。

流程

1. 在 Red Hat Quay v2 UI 登录页面上，单击导航窗格中的 Organizations。
2. 在 Organizations 页面上，选择具有多个存储库的组织名称。单个机构下的存储库数量可在 Repo Count 列下找到。
3. 在您的组织页面中，单击 Robot accounts。
4. 对于将添加到多个软件仓库中的机器人帐户，点 kebab 图标 → Set repository 权限。

5. 在 Set repository permissions 页面上，选中机器人帐户要添加到的存储库的框。例如：

   

6. 设置机器人帐户的权限，例如 None、Read、Write、Admin。
7. 单击保存。警告显示 Success alert: Successfully updated repository permission appears on Set repository permissions 页，确认更改。
8. 返回到 Organizations → Robot 帐户 页面。现在，机器人帐户的 Repositories 列会显示机器人帐户已添加到的存储库数量。

流程

1. 更新 config.yaml 字段以添加 ROBOTS_DISALLOW 变量，例如：

   ROBOTS_DISALLOW: true

   Copy to Clipboard Toggle word wrap
2. 重启 Red Hat Quay 部署。

验证：创建新的机器人帐户

1. 导航到您的 Red Hat Quay 存储库。
2. 点存储库的名称。
3. 在导航窗格中，单击 Robot Accounts。
4. 单击 Create Robot Account。
5. 输入机器人帐户的名称，例如 < organization-name/username>+<robot-name >。
6. 单击 Create robot account 以确认创建。此时会出现以下信息：Cannot create robot account。机器人帐户已被禁用。请联系您的管理员。

验证：登录到机器人帐户

1. 在命令行界面(CLI)中，输入以下命令尝试作为机器人帐户登录：

   $ podman login -u="<organization-name/username>+<robot-name>" -p="KETJ6VN0WT8YLLNXUJJ4454ZI6TZJ98NV41OE02PC2IQXVXRFQ1EJ36V12345678" <quay-server.example.com>

   Copy to Clipboard Toggle word wrap

   返回以下出错信息：

   Error: logging into "<quay-server.example.com>": invalid username/password

   Copy to Clipboard Toggle word wrap

2. 您可以传递 log-level=debug 标志，以确认机器人帐户已被停用：

   $ podman login -u="<organization-name/username>+<robot-name>" -p="KETJ6VN0WT8YLLNXUJJ4454ZI6TZJ98NV41OE02PC2IQXVXRFQ1EJ36V12345678" --log-level=debug <quay-server.example.com>

   Copy to Clipboard Toggle word wrap

   ...
   DEBU[0000] error logging into "quay-server.example.com": unable to retrieve auth token: invalid username/password: unauthorized: Robot accounts have been disabled. Please contact your administrator.

   Copy to Clipboard Toggle word wrap

流程

1. 登录到您的 Red Hat Quay registry：
2. 单击具有机器人帐户的组织名称。
3. 单击 Robot accounts。
4. 选中要删除的机器人帐户的框。
5. 点 kebab 菜单。
6. 点击 Delete。
7. 在文本框中键入 confirm，然后单击 Delete。

流程

1. 输入以下命令，使用 DELETE /api/v1/organization/{orgname}/robots/{robot_shortname} 端点删除机构的机器人帐户：

   curl -X DELETE \
     -H "Authorization: Bearer <bearer_token>" \
     "<quay-server.example.com>/api/v1/organization/<organization_name>/robots/<robot_shortname>"

   Copy to Clipboard Toggle word wrap

2. 在使用 API 删除机器人帐户时，CLI 不会返回信息。要确认删除操作，您可以检查 Red Hat Quay UI，或者您可以输入以下 GET /api/v1/organization/{orgname}/robots 命令，以查看是否为机器人帐户返回详情：

   $ curl -X GET   -H "Authorization: Bearer <bearer_token>"   "https://<quay-server.example.com>/api/v1/organization/<organization_name>/robots"

   Copy to Clipboard Toggle word wrap

   输出示例

   {"robots": []}

   Copy to Clipboard Toggle word wrap

3. 输入以下命令，使用 DELETE /api/v1/user/robots/{robot_shortname} 端点删除当前用户的机器人帐户：

   $ curl -X DELETE \
     -H "Authorization: Bearer <bearer_token>" \
     "<quay-server.example.com>/api/v1/user/robots/<robot_shortname>"

   Copy to Clipboard Toggle word wrap

4. 在使用 API 删除当前用户的机器人帐户时，CLI 不会返回信息。要确认删除操作，您可以检查 Red Hat Quay UI，或者您可以输入以下 GET /api/v1/user/robots/{robot_shortname} 命令，以查看是否为机器人帐户返回详情：

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     "<quay-server.example.com>/api/v1/user/robots/<robot_shortname>"

   Copy to Clipboard Toggle word wrap

   输出示例

   {"message":"Could not find robot with specified username"}

   Copy to Clipboard Toggle word wrap