Skip to content

Commit 101db0d

Browse files
security: update IAM/RAM docs for OATs compatibility (#22915)
## Description - IAM and RAM do not work with OATs - This adds callouts/clarification on incompatibility ## Related issues or tickets https://docker.atlassian.net/browse/ENGDOCS-2759?atlOrigin=eyJpIjoiMWY0ODA5ZmRlMzNjNDlkZTlhYjZmY2NlY2M1NWU1MjUiLCJwIjoiaiJ9 ## Reviews - [ ] Technical review - [ ] Editorial review - [ ] Product review
1 parent 0487e93 commit 101db0d

File tree

3 files changed

+11
-2
lines changed

3 files changed

+11
-2
lines changed

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

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,10 @@ linkTitle: Organization access tokens
1010

1111
> [!WARNING]
1212
>
13-
> Organization access tokens (OATs) are incompatible with Docker Desktop.
13+
> Organization access tokens (OATs) are incompatible with Docker Desktop,
14+
> [Image Access Management (IAM)](/manuals/security/for-admins/hardened-desktop/image-access-management.md), and [Registry Access Management (RAM)](/manuals/security/for-admins/hardened-desktop/registry-access-management.md).
1415
>
15-
> If you use Docker Desktop, you must use personal
16+
> If you use Docker Desktop, IAM, or RAM, you must use personal
1617
> access tokens instead.
1718
1819
An organization access token (OAT) is like a [personal access token

content/manuals/security/for-admins/hardened-desktop/image-access-management.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,10 @@ For example, a developer, who is part of an organization, building a new contain
2121

2222
You first need to [enforce sign-in](/manuals/security/for-admins/enforce-sign-in/_index.md) to ensure that all Docker Desktop developers authenticate with your organization. Since Image Access Management requires a Docker Business subscription, enforced sign-in guarantees that only authenticated users have access and that the feature consistently takes effect across all users, even though it may still work without enforced sign-in.
2323

24+
> [!IMPORTANT]
25+
>
26+
> You must use [personal access tokens (PATs)](/manuals/security/for-developers/access-tokens.md) with Image Access Management. Organization access tokens (OATs) are not compatible.
27+
2428
## Configure
2529

2630
{{< tabs >}}

content/manuals/security/for-admins/hardened-desktop/registry-access-management.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,10 @@ always authenticate to your organization, even though they can authenticate
4343
without it and the feature will take effect. Enforcing sign-in guarantees the
4444
feature always takes effect.
4545

46+
> [!IMPORTANT]
47+
>
48+
> You must use [personal access tokens (PATs)](/manuals/security/for-developers/access-tokens.md) with Registry Access Management. Organization access tokens (OATs) are not compatible.
49+
4650
## Configure Registry Access Management permissions
4751

4852
{{< tabs >}}

0 commit comments

Comments
 (0)