Skip to content

Connections#25336

Draft
akristen wants to merge 3 commits into
docker:mainfrom
akristen:o-connections
Draft

Connections#25336
akristen wants to merge 3 commits into
docker:mainfrom
akristen:o-connections

Conversation

@akristen

Copy link
Copy Markdown
Contributor

Draft PR

akristen added 3 commits June 11, 2026 14:22
Introduce a new Enterprise > Security section for Docker OIDC, positioned
between Enforce sign-in and Roles and permissions. Adds overview,
connection management, and rulesets/subject claims pages, including
GitHub Actions workflow setup and Admin Console management guidance.
Also adds a Docker OIDC card to the Security landing page and registers
the feature in summary.yaml for summary-bar metadata.
Correct links and wording, align login-action with repo convention, and
update the Security grid icon.
@akristen akristen requested a review from dotjoshrc June 11, 2026 20:00
@akristen akristen self-assigned this Jun 11, 2026
@netlify

netlify Bot commented Jun 11, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 28cbdab
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a2b13f15883f60008b8df34
😎 Deploy Preview https://deploy-preview-25336--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@akristen akristen changed the title O connections Connections Jun 11, 2026

@docker-agent docker-agent left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Assessment: 🟡 NEEDS ATTENTION

New Docker OIDC documentation is well-structured and technically clear. One high-severity inconsistency between the prose and the rendered summary-bar subscription badge needs resolution before merge, plus several medium style issues.

Comment thread content/manuals/enterprise/security/docker-oidc/_index.md
Comment thread content/manuals/enterprise/security/docker-oidc/rulesets-claims.md
Comment thread content/manuals/enterprise/security/docker-oidc/rulesets-claims.md
Comment thread content/manuals/enterprise/security/docker-oidc/_index.md

Each ruleset contains the following fields:

- **Label**: A name for the ruleset.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[MEDIUM] Bold used for conceptual list labels — may not qualify as UI elements

STYLE.md reserves bold exclusively for UI elements (buttons, menus, field labels). **Label**, **Rules**, **Resources**, and **Scopes** appear in a conceptual definition list. If these are the exact names of labeled fields in the Admin Console form UI, bold is correct. If they're conceptual terms describing what a ruleset contains, bold should be removed and the list rewritten as plain prose bullets.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These are the exact names of the UI elements

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for confirming! In that case, the bold formatting is correct per STYLE.md. Resolved.

Comment thread content/manuals/enterprise/security/docker-oidc/_index.md
Comment thread content/manuals/enterprise/security/docker-oidc/create-manage.md
- While a connection is deactivated:
- It cannot issue Docker access tokens.
- Without Docker access tokens, the `docker/oidc-action` step references will fail at the token-exchange step until you activate the connection.
- Deactivation is useful when rotating credentials: pause the existing connection while you configure its replacement.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is inaccurate and updated locally; hold over from the november draft

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants