Skip to content

[docs-scanner] Misleading instruction about PayloadOrganization field #25971

Description

@docker-agent

File: content/manuals/enterprise/security/enforce-sign-in/methods.md

Issue

The configuration profile setup instructions incorrectly state that the PayloadOrganization field needs to be lowercase:

  1. Replace placeholders:
    • Change com.yourcompany.docker.config to your company identifier
    • Replace Your company name with your organization name making sure it is all lowercase
    • Replace PayloadUUID with a randomly generated UUID
    • Update the allowedOrgs value with your organization names (separated by semicolons)

The PayloadOrganization field is just a display name for the configuration profile itself (shown in System Settings), not the Docker organization name. It doesn't need to be lowercase. The Docker organization names are specified in the allowedOrgs field, which correctly requires lowercase.

Why this matters

Users following these instructions will unnecessarily lowercase their company display name in the configuration profile, and may be confused about which field actually controls Docker sign-in enforcement. The instruction conflates two different fields with different purposes.

Suggested fix

Clarify the instruction to distinguish between the display name and the actual Docker organization names:

1. Replace placeholders:
   - Change `com.yourcompany.docker.config` to your company identifier
   - Replace `Your company name` with your company's display name
   - Replace `PayloadUUID` with a randomly generated UUID
   - Update the `allowedOrgs` value with your Docker organization names (separated by semicolons, all lowercase)
   - Replace `company.proxy:port` with http/https proxy server host (or IP address) and port

Found by nightly documentation quality scanner

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions