Docs corrections from the #985 research (statements in v0.6.352 docs that were wrong or incomplete) #995

Closed
opened 2026-10-24 16:13:43 +00:00 by Cordy · 1 comment
Owner

The #985 research checked the claims in the v0.6.352 handbook pages against primary sources. These lines are wrong or incomplete and are fixed together (research-985-5 consolidated table, research-985-4 §5, research-985-1 §9).

File:line Change Status
tls-certificates.md:91-94, :362; configuration-reference.md:415-416; updates.md:143-145; CHANGELOG.md:36, :63 SSL_CERT_FILE replaces only the bundle file; Go still reads the default directories (/etc/ssl/certs, which holds the full bundle on Cairn's images). Public roots disappear only when SSL_CERT_DIR also points elsewhere. SSL_CERT_DIR replaces the directory list (on these images the effect is "adds"). distroless sets SSL_CERT_FILE itself. VERIFIED (Go source)
directory-ldap-ad.md:114-116, :483; ldap.go:212 (comment) Windows Server 2025 requires LDAP signing by default only on new deployments; upgraded domains keep their setting. "Windows Server 2025 refuses it" is overstated. VERIFIED (Microsoft)
directory-ldap-ad.md:144-147 The Global Catalog holds members of universal groups only; domain local and global memberships are missing. Replace the Windows 2000 link. VERIFIED
directory-ldap-ad.md:174-176 Samba in-chain: add bug 15515 ACL caveat (#990). 389-ds: the In Chain plugin exists, off by default, ACL-gated. OpenLDAP: nested groups via dynlist only. VERIFIED / INFERRED (OpenLDAP)
directory-ldap-ad.md (sub-code table) "534" is wrong: logon type not granted is 0x569. Add a sub-code table with "shown to the person" and "counts as failure"; Protected Users (52f) limitation; Samba old-password grace. VERIFIED
directory-ldap-ad.md:202 vs login.html:220 Docs say "wrong user name or password", page says "Invalid credentials." Align with the new #985 texts. VERIFIED
directory-entra-id.md:43-47, 56-58, 66, 70-71, 108-113 Group assignment needs Entra ID P1 or P2 and does not cascade to nested groups; "Groups assigned to the application" drops nested groups; "roles have no such limit" is not stated by Microsoft (soften); client secrets max 24 months, Microsoft says not for production, AADSTS7000222 on expiry; preferred_username is mutable and must not be used for authorization (stronger wording, Cairn keys the home on it); local credentials (app passwords) survive unassignment. VERIFIED
deploy-kubernetes.md:435; values.yaml:277-278, 296-298; CHANGELOG.md:42 Gotenberg (uid 1001) needs a writable root because Chromium writes /home/gotenberg; LibreOffice's profile is in /tmp. Pinning comment vs the floating 8 tag. VERIFIED
deploy-kubernetes.md:271-272 ESO: external-secrets.io/v1 only since v0.17; Vault 1.21+ Kubernetes-auth roles need serviceAccountRef.audiences; OpenBao provider is "alpha". VERIFIED
deploy-kubernetes.md:337-353; values.yaml:44-47 Agent injector: see #994 (cannot work as shipped; OpenBao prefix per version; drop "OpenBao's documents its own"). VERIFIED
values.yaml:218-220; deploy-kubernetes.md:575 Memory /tmp with sizeLimit: tmpfs is sized to the limit, so a full /tmp gives "no space left on device", not an OOM kill (OOM only without a limit). VERIFIED
cmd/cairnd/tlsserve.go:61-62 (comment) "Linux default TCP receive buffer maximum (6 MiB)" is wrong: tcp_rmem max scales with RAM. Note the HTTP2Config doc ceiling "less than 4MiB" vs the implementation accepting 8 MiB (the wire test guards it). VERIFIED

Lands with the #985 release.

The #985 research checked the claims in the v0.6.352 handbook pages against primary sources. These lines are wrong or incomplete and are fixed together (research-985-5 consolidated table, research-985-4 §5, research-985-1 §9). | File:line | Change | Status | |---|---|---| | tls-certificates.md:91-94, :362; configuration-reference.md:415-416; updates.md:143-145; CHANGELOG.md:36, :63 | `SSL_CERT_FILE` replaces only the bundle **file**; Go still reads the default directories (`/etc/ssl/certs`, which holds the full bundle on Cairn's images). Public roots disappear only when `SSL_CERT_DIR` also points elsewhere. `SSL_CERT_DIR` replaces the directory list (on these images the effect is "adds"). distroless sets `SSL_CERT_FILE` itself. | VERIFIED (Go source) | | directory-ldap-ad.md:114-116, :483; ldap.go:212 (comment) | Windows Server 2025 requires LDAP signing by default only on **new** deployments; upgraded domains keep their setting. "Windows Server 2025 refuses it" is overstated. | VERIFIED (Microsoft) | | directory-ldap-ad.md:144-147 | The Global Catalog holds members of **universal** groups only; domain local **and global** memberships are missing. Replace the Windows 2000 link. | VERIFIED | | directory-ldap-ad.md:174-176 | Samba in-chain: add bug 15515 ACL caveat (#990). 389-ds: the In Chain plugin exists, off by default, ACL-gated. OpenLDAP: nested groups via `dynlist` only. | VERIFIED / INFERRED (OpenLDAP) | | directory-ldap-ad.md (sub-code table) | "534" is wrong: logon type not granted is `0x569`. Add a sub-code table with "shown to the person" and "counts as failure"; Protected Users (52f) limitation; Samba old-password grace. | VERIFIED | | directory-ldap-ad.md:202 vs login.html:220 | Docs say "wrong user name or password", page says "Invalid credentials." Align with the new #985 texts. | VERIFIED | | directory-entra-id.md:43-47, 56-58, 66, 70-71, 108-113 | Group assignment needs Entra ID P1 or P2 and **does not cascade to nested groups**; "Groups assigned to the application" drops nested groups; "roles have no such limit" is not stated by Microsoft (soften); client secrets max 24 months, Microsoft says not for production, AADSTS7000222 on expiry; `preferred_username` is mutable and must not be used for authorization (stronger wording, Cairn keys the home on it); local credentials (app passwords) survive unassignment. | VERIFIED | | deploy-kubernetes.md:435; values.yaml:277-278, 296-298; CHANGELOG.md:42 | Gotenberg (uid 1001) needs a writable root because **Chromium** writes `/home/gotenberg`; LibreOffice's profile is in `/tmp`. Pinning comment vs the floating `8` tag. | VERIFIED | | deploy-kubernetes.md:271-272 | ESO: `external-secrets.io/v1` only since v0.17; Vault 1.21+ Kubernetes-auth roles need `serviceAccountRef.audiences`; OpenBao provider is "alpha". | VERIFIED | | deploy-kubernetes.md:337-353; values.yaml:44-47 | Agent injector: see #994 (cannot work as shipped; OpenBao prefix per version; drop "OpenBao's documents its own"). | VERIFIED | | values.yaml:218-220; deploy-kubernetes.md:575 | Memory `/tmp` with `sizeLimit`: tmpfs is sized to the limit, so a full `/tmp` gives "no space left on device", not an OOM kill (OOM only without a limit). | VERIFIED | | cmd/cairnd/tlsserve.go:61-62 (comment) | "Linux default TCP receive buffer maximum (6 MiB)" is wrong: `tcp_rmem` max scales with RAM. Note the `HTTP2Config` doc ceiling "less than 4MiB" vs the implementation accepting 8 MiB (the wire test guards it). | VERIFIED | Lands with the #985 release.
Author
Owner

Done in v0.6.354 (PR #1004). Every row of the table is corrected in the handbook, the CHANGELOG (v0.6.352 lines fixed in place), values.yaml and the two Go texts:

  • the plain-LDAP refusal message now names signing-required DCs and new WS2025 domains;
  • the TCP buffer comment in tlsserve.go.

Also done: the sub-code table, 0x569, Samba 15515, GC universal-only, the Entra corrections with the new "Assignment required and app roles" heading, Gotenberg/Chromium, ESO/Vault audiences, and the /tmp sizeLimit behaviour. Closing.

Done in v0.6.354 (PR #1004). Every row of the table is corrected in the handbook, the CHANGELOG (v0.6.352 lines fixed in place), values.yaml and the two Go texts: - the plain-LDAP refusal message now names signing-required DCs and new WS2025 domains; - the TCP buffer comment in tlsserve.go. Also done: the sub-code table, 0x569, Samba 15515, GC universal-only, the Entra corrections with the new "Assignment required and app roles" heading, Gotenberg/Chromium, ESO/Vault audiences, and the `/tmp` sizeLimit behaviour. Closing.
Cordy closed this issue 2026-10-25 21:29:35 +00:00
Sign in to join this conversation.
No labels
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: Cordy/Cairn#995
No description provided.