Skip to content

docs(admin): warn about Configuration Active before LDAP testing#14904

Open
skjnldsv wants to merge 2 commits into
masterfrom
fix/ldap-configuration-active-emphasis
Open

docs(admin): warn about Configuration Active before LDAP testing#14904
skjnldsv wants to merge 2 commits into
masterfrom
fix/ldap-configuration-active-emphasis

Conversation

@skjnldsv
Copy link
Copy Markdown
Member

☑️ Resolves

Summary

LDAP authentication silently fails with "wrong password" when Configuration Active is
not enabled, even if all other settings are correct. This checkbox lives under the Advanced
tab and is off by default — it's easy to miss and can waste hours of troubleshooting.

Added a .. warning:: block at the top of the "Testing the configuration" section to
surface this requirement before the user clicks Test Configuration.

🖼️ Screenshots

No visual layout change — text-only addition to an existing section.

✅ Checklist

  • I have built the documentation locally and reviewed the output
  • Screenshots are included for visual changes (N/A — text only)
  • I have not moved or renamed pages (or added a redirect if I did)
  • I have run codespell or similar and addressed any spelling issues

Add a warning block before the "Testing the configuration" section to
highlight that Configuration Active must be enabled under the Advanced
tab before testing. Without it authentication fails with a misleading
"wrong password" error even when all other settings are correct.

Fixes #912

Signed-off-by: skjnldsv <skjnldsv@protonmail.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 19, 2026

📖 Documentation Preview

🔍 Open preview →

📄 1 changed documentation page

Last updated: Wed, 20 May 2026 01:18:25 GMT

Copy link
Copy Markdown
Contributor

@come-nc come-nc left a comment

Choose a reason for hiding this comment

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

It’s not in the Advanced tab anymore, it’s right at the beginning:

Image

@skjnldsv
Copy link
Copy Markdown
Member Author

Thanks Come, we need to update the screenshots 🙈

…n Active

The checkbox is at the top of the LDAP config form, not under the Advanced tab.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
@skjnldsv skjnldsv requested a review from come-nc May 19, 2026 16:37
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.

LDAP "Configuration Active" should have more emphasis in Admin Manual

2 participants