Skip to content

Document Active Directory LDAP referral workaround - #12473

Open
br413 wants to merge 6 commits into
inventree:masterfrom
br413:docs/12224-ldap-ad
Open

Document Active Directory LDAP referral workaround#12473
br413 wants to merge 6 commits into
inventree:masterfrom
br413:docs/12224-ldap-ad

Conversation

@br413

@br413 br413 commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the Active Directory LDAP workaround from #12224: set OPT_REFERRALS: OPT_OFF in ldap.global_options when login fails with failed to map the username to a DN.

Changes

  • docs/docs/start/advanced.md — new "Active Directory" subsection under LDAP with example config.yaml and debugging tip

Test plan

Fixes #12224

Fixes inventree#12224 by documenting OPT_REFERRALS: OPT_OFF for AD login failures.
@br413
br413 requested a review from SchrodingersGat as a code owner July 27, 2026 00:07
@netlify

netlify Bot commented Jul 27, 2026

Copy link
Copy Markdown

Deploy Preview for inventree-web-pui-preview canceled.

Name Link
🔨 Latest commit 8e73de8
🔍 Latest deploy log https://app.netlify.com/projects/inventree-web-pui-preview/deploys/6a6fab012f1a660008ed33ec

Comment thread docs/docs/start/advanced.md Outdated
@br413

br413 commented Jul 27, 2026

Copy link
Copy Markdown
Contributor Author

Good catch — that \Fixes #12224\ line should only be in the PR description, not in the rendered docs. Removed in the latest commit.

@SchrodingersGat

Copy link
Copy Markdown
Member

Reviewed against the reporter's working config

Has this been confirmed?

@matmair matmair added setup Relates to the InvenTree setup / installation process documentation labels Jul 30, 2026
@matmair matmair added this to the 1.5.0 milestone Jul 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation setup Relates to the InvenTree setup / installation process

Projects

None yet

Development

Successfully merging this pull request may close these issues.

LDAP login with Active Directory fails until OPT_REFERRALS is disabled

3 participants