Updated PAT (#13663)
* updated scopes * updated images * Minor format changes Added missing * and moved info on Hub CLI tool and API below the overview Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
|
@ -4,8 +4,8 @@ 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:
|
||||
|
||||
|
@ -13,8 +13,12 @@ Using personal access tokens provides some advantages over a password:
|
|||
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.
|
||||
|
||||
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.
|
||||
|
||||
>**Important**
|
||||
> **Important**
|
||||
>
|
||||
> Treat access tokens like your password and keep them secret. Store your
|
||||
> tokens securely (for example, in a credential manager).
|
||||
|
@ -24,7 +28,7 @@ Access tokens are valuable for building integrations, as you can issue
|
|||
multiple tokens – one for each integration – and revoke them at
|
||||
any time.
|
||||
|
||||
>**Note**
|
||||
> **Note**
|
||||
>
|
||||
> If you have [two-factor authentication (2FA)](2fa/index.md) enabled on
|
||||
> your account, you must create at least one personal access token. Otherwise,
|
||||
|
@ -47,15 +51,21 @@ You can create as many tokens as you need.
|
|||
|
||||
{:width="700px"}
|
||||
|
||||
The access permissions are scopes that set restrictions in your
|
||||
repositories. For example, for Read & Write permissions, an automation
|
||||
pipeline can build an image and then push it to a repository. However, it
|
||||
can not delete the repository.
|
||||
|
||||
5. The table below lists the tokens available in each subscription:
|
||||
|
||||
|
||||
| Feature | Personal | Pro | Team | Business |
|
||||
| --------------------- | ---- | ----- | ----- |----- |
|
||||
| Personal Access Tokens (read, write, delete scope only)* | x | x | x | x |
|
||||
| Scoped Personal Access Tokens | | x | x | x |
|
||||
| Unlimited Personal Access Tokens | | | x | x |
|
||||
| Personal Access Tokens (read, write, delete scope only)* ||  | ||
|
||||
| Scoped Personal Access Tokens | || ||
|
||||
| Unlimited Personal Access Tokens | | | ||
|
||||
|
||||
>*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.
|
||||
*You can create 1 access token as part of the Docker Personal subscription, 5 tokens as part of Docker Pro, and Unlimited tokens as part of Docker Team and Business subscriptions.
|
||||
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="_"}.
|
||||
|
||||
6. Copy the token that appears on the screen and save it. You will not be able
|
||||
|
@ -95,10 +105,3 @@ You can rename, activate, deactivate, or delete a token as needed.
|
|||
{:width="700px"}
|
||||
|
||||
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.
|
||||
|
|
Before Width: | Height: | Size: 141 KiB After Width: | Height: | Size: 30 KiB |
Before Width: | Height: | Size: 51 KiB After Width: | Height: | Size: 29 KiB |
Before Width: | Height: | Size: 54 KiB After Width: | Height: | Size: 15 KiB |
Before Width: | Height: | Size: 64 KiB After Width: | Height: | Size: 29 KiB |