[docs-scanner] SSO overview omits OAT as CLI authentication option
维护者通常 1 天内回复
评估
- 难度
- 1/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 92/100
- Issue 类型
- 文档
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- markdown
调研方向
阅读 content/manuals/security/authentication/single-sign-on/_index.md，并将其中的 Important 提示与同一目录下的 connect.md 进行比较。更新概述以提及 PAT 和 OAT，或引导读者查看设置指南；当概述清楚地呈现两种身份验证选项时，工作即告完成。
由索引模型根据 Issue 内容生成。
描述
File: content/manuals/security/authentication/single-sign-on/_index.md
Issue
The SSO overview mentions only PAT for CLI authentication when SSO is enforced, but omits OAT (organization access token) as an option:
When SSO is enforced, the Docker CLI rejects password sign-in. Use a personal access token (PAT) to sign in to the CLI.
However, connect.md in the same directory correctly mentions both options:
Before enforcing SSO, users accessing Docker through the CLI must create a personal access token (PAT). The PAT replaces their password for authentication. For CI/CD and other automation, replace passwords with a PAT or an organization access token (OAT).
Why this matters
Readers of the overview page learn they need a PAT but don't discover that OAT exists as an option. For organizational and CI/CD use cases, OAT is often the more appropriate choice. This omission affects decision-making about which token type to use.
Suggested fix
Update the Important callout in _index.md to mention both PAT and OAT:
When SSO is enforced, the Docker CLI rejects password sign-in. Use a personal access token (PAT) or organization access token (OAT) to sign in to the CLI. For CI/CD and automation, OAT is often more appropriate.
Or add a sentence after the existing callout that references the fuller explanation in the setup guide.
Found by nightly documentation quality scanner
- 主要语言
- Markdown
- 星标
- 4.7k
- 派生
- 8.5k
- 平均合并
- 1 天 22 小时
- 30 天内合并 PR
- 148
环境准备
- 提供 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
docker/docs 的其他 Issue
-
难度 1/5 1 小时以内 新手友好度 88/100
维护者通常 1 天内回复
-
status/triage
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
-
status/triage
难度 1/5 1 小时以内 新手友好度 88/100
维护者通常 1 天内回复
相似的 Issue
-
sync-en
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 78/100
维护者通常 1 天内回复
-
enhancement
难度 1/5 1 小时以内 新手友好度 86/100
维护者通常 1 天内回复
-
Support .aac audio uploads可能已有人在做 @julien731 今天认领。 未关闭feature
难度 2/5 1-3 小时 新手友好度 78/100
nimblehq/audio-transcriber#153 ·
-
[DOCS]: enforce_admins description understates what it covers and omits push restrictions可能已有人在做 @dav-tb 今天认领。 未关闭
难度 1/5 1 小时以内 新手友好度 78/100
integrations/terraform-provider-github#3707 · 1 条评论 ·
维护者通常 1 天内回复