Skip to content

Commit 892c86b

Browse files
Merge pull request #21333 from sarahsanders-docker/ENGDOCS-2297
Update PAT guide to include expiration feature
2 parents 7963973 + 27f854f commit 892c86b

File tree

1 file changed

+11
-5
lines changed

1 file changed

+11
-5
lines changed

content/manuals/security/for-developers/access-tokens.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,7 @@ Compared to passwords, PATs provide the following advantages:
1414

1515
- You can investigate when the PAT was last used and then disable or delete it if you find any suspicious activity.
1616
- When using an access token, you can't perform any administrative activity on the account, including changing the password. It protects your account if your computer is compromised.
17-
18-
Access tokens are also valuable for building integrations, as you can issue multiple tokens, one for each integration, and revoke them at
17+
- Access tokens are valuable for building integrations, as you can issue multiple tokens, one for each integration, and revoke them at
1918
any time.
2019

2120
## Create an access token
@@ -24,6 +23,8 @@ any time.
2423
>
2524
> Treat access tokens like your password and keep them secret. Store your tokens securely in a credential manager for example.
2625
26+
Use the Docker Admin Console to create an access token.
27+
2728
1. Sign in to your [Docker account](https://app.docker.com/login).
2829

2930
2. Select your avatar in the top-right corner and from the drop-down menu select **Account settings**.
@@ -34,14 +35,15 @@ any time.
3435

3536
5. Add a description for your token. Use something that indicates the use case or purpose of the token.
3637

37-
6. Set the access permissions.
38+
6. Select the expiration date for the token.
39+
40+
7. Set the access permissions.
3841
The access permissions are scopes that set restrictions in your
3942
repositories. For example, for Read & Write permissions, an automation
4043
pipeline can build an image and then push it to a repository. However, it
4144
can't delete the repository.
4245

43-
7. Select **Generate** and then copy the token that appears on the screen and save it. You won't be able
44-
to retrieve the token once you close this prompt.
46+
8. Select **Generate** and then copy the token that appears on the screen and save it. You won't be able to retrieve the token once you close this prompt.
4547

4648
## Use an access token
4749

@@ -63,6 +65,10 @@ When prompted for a password, enter your personal access token instead of a pass
6365
6466
## Modify existing tokens
6567

68+
> [!NOTE]
69+
>
70+
> You can't edit the expiration date on an existing token. You must create a new PAT if you need to set a new expiration date.
71+
6672
You can rename, activate, deactivate, or delete a token as needed. You can manage your tokens in your account settings.
6773

6874
1. Sign in to your [Docker account](https://app.docker.com/login).

0 commit comments

Comments
 (0)