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
|
keywords: docker hub, hub, security, PAT, personal access token
|
||||||
---
|
---
|
||||||
|
|
||||||
Docker Hub lets you create personal access tokens as alternatives to your password.
|
Docker Hub lets you create personal access tokens as alternatives to your password. You can use tokens to
|
||||||
You can use tokens to access Hub images from the Docker CLI.
|
access Hub images from the Docker CLI.
|
||||||
|
|
||||||
Using personal access tokens provides some advantages over a password:
|
Using personal access tokens provides some advantages over a password:
|
||||||
|
|
||||||
|
@ -14,7 +14,11 @@ Using personal access tokens provides some advantages over a password:
|
||||||
* When using an access token, you can't perform any admin activity on the account,
|
* 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.
|
including changing the password. It protects your account if your computer is compromised.
|
||||||
|
|
||||||
>**Important**
|
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**
|
||||||
>
|
>
|
||||||
> Treat access tokens like your password and keep them secret. Store your
|
> Treat access tokens like your password and keep them secret. Store your
|
||||||
> tokens securely (for example, in a credential manager).
|
> 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
|
multiple tokens – one for each integration – and revoke them at
|
||||||
any time.
|
any time.
|
||||||
|
|
||||||
>**Note**
|
> **Note**
|
||||||
>
|
>
|
||||||
> If you have [two-factor authentication (2FA)](2fa/index.md) enabled on
|
> If you have [two-factor authentication (2FA)](2fa/index.md) enabled on
|
||||||
> your account, you must create at least one personal access token. Otherwise,
|
> 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"}
|
{: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:
|
5. The table below lists the tokens available in each subscription:
|
||||||
|
|
||||||
|
|
||||||
| Feature | Personal | Pro | Team | Business |
|
| Feature | Personal | Pro | Team | Business |
|
||||||
| --------------------- | ---- | ----- | ----- |----- |
|
| --------------------- | ---- | ----- | ----- |----- |
|
||||||
| Personal Access Tokens (read, write, delete scope only)* | x | x | x | x |
|
| Personal Access Tokens (read, write, delete scope only)* ||  | ||
|
||||||
| Scoped Personal Access Tokens | | x | x | x |
|
| Scoped Personal Access Tokens | || ||
|
||||||
| Unlimited Personal Access Tokens | | | x | x |
|
| 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="_"}.
|
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
|
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"}
|
{:width="700px"}
|
||||||
|
|
||||||
3. After modifying the token, click the **Save** button to save your changes.
|
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 |