Chapter 2. Red Hat Quay user accounts overview

Procedure

1. Log in to your Red Hat Quay repository as the superuser.
2. In the navigation pane, select your account name, and then click Super User Admin Panel.
3. Click the Users icon in the column.
4. Click the Create User button.
5. Enter the new user’s Username and Email address, and then click the Create User button.

6. You are redirected to the Users page, where there is now another Red Hat Quay user.

   Note

   You might need to refresh the Users page to show the additional user.

7. On the Users page, click the Options cogwheel associated with the new user. A drop-down menu appears, as shown in the following figure:

   

8. Click Change Password.

9. Add the new password, and then click Change User Password.

   The new user can now use that username and password to log in using the web UI or through their preferred container client, like Podman.

Procedure

1. Enter the following command to create a new user using the POST /api/v1/superuser/users/ endpoint:

   $ curl -X POST -H "Authorization: Bearer <bearer_token>" -H "Content-Type: application/json" -d '{
     "username": "newuser",
     "email": "newuser@example.com"
   }' "https://<quay-server.example.com>/api/v1/superuser/users/"

   Example output

   {"username": "newuser", "email": "newuser@example.com", "password": "IJWZ8TIY301KPFOW3WEUJEVZ3JR11CY1", "encrypted_password": "9Q36xF54YEOLjetayC0NBaIKgcFFmIHsS3xTZDLzZSrhTBkxUc9FDwUKfnxLWhco6oBJV1NDBjoBcDGmsZMYPt1dSA4yWpPe/JKY9pnDcsw="}

2. Navigate to your Red Hat Quay registry endpoint, for example, quay-server.example.com and login with the username and password generated from the API call. In this scenario, the username is newuser and the password is IJWZ8TIY301KPFOW3WEUJEVZ3JR11CY1. Alternatively, you can log in to the registry with the CLI. For example:

   $ podman login <quay-server.example.com>

   Example output

   username: newuser
   password: IJWZ8TIY301KPFOW3WEUJEVZ3JR11CY1

3. Optional. You can obtain a list of all users, including superusers, by using the GET /api/v1/superuser/users/ endpoint:

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

   Example output

   {"users": [{"kind": "user", "name": "quayadmin", "username": "quayadmin", "email": "quay@quay.com", "verified": true, "avatar": {"name": "quayadmin", "hash": "b28d563a6dc76b4431fc7b0524bbff6b810387dac86d9303874871839859c7cc", "color": "#17becf", "kind": "user"}, "super_user": true, "enabled": true}, {"kind": "user", "name": "newuser", "username": "newuser", "email": "newuser@example.com", "verified": true, "avatar": {"name": "newuser", "hash": "f338a2c83bfdde84abe2d3348994d70c34185a234cfbf32f9e323e3578e7e771", "color": "#9edae5", "kind": "user"}, "super_user": false, "enabled": true}]}

Procedure

1. Log in to your Red Hat Quay repository as the superuser.
2. In the navigation pane, select your account name, and then click Super User Admin Panel.
3. Click the Users icon in the navigation pane.
4. Click the Options cogwheel beside the user to be deleted.
5. Click Delete User, and then confirm deletion by clicking Delete User.

Procedure

1. Enter the following DELETE /api/v1/superuser/users/{username} command to delete a user from the command line:

   $ curl -X DELETE -H "Authorization: Bearer <insert token here>" https://<quay-server.example.com>/api/v1/superuser/users/<username>

2. The CLI does not return information when deleting a user from the CLI. To confirm deletion, you can check the Red Hat Quay UI by navigating to Superuser Admin Panel Users, or by entering the following GET /api/v1/superuser/users/ command. You can then check to see if they are present.

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