mirror of https://github.com/docker/docs.git
access-tokens: markdown touch-ups, and some copy edits
- wrap lines to ~80 characters - indent second lines for bullets to make them look slightly more as bullet-lists (also when looking at the source) - Split the "Modify existing tokens" into three steps. Doing so, we could include the "You can also view the number of tokens that are activated and deactivated in the toolbar." note as regular text. The bullet already had 2 images _and_ a note, which made it a bit "cluttered" - Added a step to "save" the changes. It's trivial, but felt like it made the topic "finished". - Changed the mention of the "Docker Hub CLI and API" to a note, so that it's standing out a bit more, and somewhat clearer that it's not really part of the instructions. Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
This commit is contained in:
parent
a8f9b373b2
commit
6ed8c2b133
|
@ -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:
|
||||
|
||||
{: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.
|
||||
|
||||
{: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 <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 <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 <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.
|
||||
|
||||
{: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.
|
||||
|
||||
{: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.
|
||||
|
||||
{: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.
|
||||
|
|
Loading…
Reference in New Issue