diff --git a/docker-hub/access-tokens.md b/docker-hub/access-tokens.md index 1a6de2f9b0..210706df6e 100644 --- a/docker-hub/access-tokens.md +++ b/docker-hub/access-tokens.md @@ -4,11 +4,15 @@ description: Learn how to create and manage your personal Docker Hub access toke keywords: docker hub, hub, security, PAT, personal access token --- -Docker Hub lets you create personal access tokens as alternatives to your password. You can use tokens to access Hub images from the Docker CLI. +Docker Hub lets you create personal access tokens as alternatives to your password. +You can use tokens to access Hub images from the Docker CLI. Using personal access tokens provides some advantages over a password: -* You can investigate the last usage of the access token and disable or delete it if you find any suspicious activity. -* When using an access token, you can't perform any admin activity on the account, including changing the password. It protects your account if your computer is compromised. + +* You can investigate the last usage of the access token and disable or delete + it if you find any suspicious activity. +* When using an access token, you can't perform any admin activity on the account, + including changing the password. It protects your account if your computer is compromised. >**Important** > @@ -37,9 +41,9 @@ You can create as many tokens as you need. 3. Select **[Security](https://hub.docker.com/settings/security) > New Access Token**. -4. Add a description for your token. Use something that indicates where -the token will be used, or set a purpose for the token. -You can view the following access permissions from the drop-down: +4. Add a description for your token. Use something that indicates where the token + will be used, or set a purpose for the token. You can view the following access + permissions from the drop-down: ![PAT Menu](images/hub-create-token.png){:width="700px"} @@ -54,7 +58,8 @@ You can view the following access permissions from the drop-down: >*You can create 1 access token as part of the Docker Personal tier, 5 tokens as part of Docker Pro, and Unlimited tokens as part of Docker Team and Business tier. For more information, see [Docker Pricing](https://www.docker.com/pricing?utm_source=docker&utm_medium=webreferral&utm_campaign=docs_driven_upgrade){: target="_blank" rel="noopener" class="_"}. -5. Copy the token that appears on the screen and save it. You will not be able to retrieve the token once you close this prompt. +6. Copy the token that appears on the screen and save it. You will not be able + to retrieve the token once you close this prompt. ![Copy Token](images/hub-copy-token.png){:width="700px"} @@ -63,7 +68,9 @@ You can view the following access permissions from the drop-down: You can use an access token anywhere that requires your Docker Hub password. -When logging in from your Docker CLI client (`docker login --username `), omit the password in the login command. Instead, enter your token when asked for a password. +When logging in from your Docker CLI client (`docker login --username `), +omit the password in the login command. Instead, enter your token when asked for +a password. > **Note** > @@ -76,17 +83,22 @@ When logging in from your Docker CLI client (`docker login --username You can rename, activate, deactivate, or delete a token as needed. 1. Access your tokens under **[Account Settings > Security](https://hub.docker.com/settings/security){: target="_blank" rel="noopener" class="_"}**. + This page shows an overview of all your tokens. You can also view the number + of tokens that are activated and deactivated in the toolbar. + + ![Delete or Edit](images/hub-delete-edit-token.png){:width="700px"} 2. Select a token and click **Delete** or **Edit**, or use the menu on -the far right of a token row to bring up the edit screen. You can also -select multiple tokens to delete at once. - - ![Delete or Edit](images/hub-delete-edit-token.png){:width="700px"} - - > **Note** - > - > You can also view the number of tokens that are activated and deactivated in the toolbar. + the far right of a token row to bring up the edit screen. You can also + select multiple tokens to delete at once. ![Modify Token](images/hub-edit-token.png){:width="700px"} -Docker provides a [Docker Hub CLI](https://github.com/docker/hub-tool#readme){: target="_blank" rel="noopener" class="_"} tool (currently experimental) and an API that allows you to interact with Docker Hub. Browse through the [Docker Hub API](/docker-hub/api/latest/){: target="_blank" rel="noopener" class="_"} documentation to explore the supported endpoints. +3. After modifying the token, click the **Save** button to save your changes. + +> **Tip: Docker Hub CLI and API** +> +> Docker provides a [Docker Hub CLI](https://github.com/docker/hub-tool#readme){: target="_blank" rel="noopener" class="_"} +> tool (currently experimental) and an API that allows you to interact with Docker +> Hub. Browse through the [Docker Hub API](/docker-hub/api/latest/){: target="_blank" rel="noopener" class="_"} +> documentation to explore the supported endpoints.