LDAP authentication documentation: add paragraph about group creation required. #2451

Closed
opened 2025-12-29 18:18:57 +01:00 by adam · 0 comments
Owner

Originally created by @nicobbg on GitHub (Mar 11, 2019).

Change Type

[X] Addition
[ ] Correction
[ ] Deprecation
[ ] Cleanup (formatting, typos, etc.)

Proposed Changes

On the netbox ldap configuration page it would be great to explain that the three users groups (is_active, is_staff, is_superuser) must exist in the LDAP directory otherwise authentication will fail while trying to retrieve the user group mapping.

Reason; Netbox is trying to retrieve permissions using an LDAP compareRequest, however if one of the group is not present in the LDAP directory, the LDAP server may reply with a success response instead of compareResponse. Because of the implementation of the Python ldap module, such a response would lead to an exception and authentication will fail.

Originally created by @nicobbg on GitHub (Mar 11, 2019). ### Change Type [X] Addition [ ] Correction [ ] Deprecation [ ] Cleanup (formatting, typos, etc.) ### Proposed Changes On [the netbox ldap configuration page](https://netbox.readthedocs.io/en/stable/installation/4-ldap/) it would be great to explain that the three users groups (is_active, is_staff, is_superuser) must exist in the LDAP directory otherwise authentication will fail while trying to retrieve the user group mapping. Reason; Netbox is trying to retrieve permissions using an LDAP compareRequest, however if one of the group is not present in the LDAP directory, the LDAP server may reply with a success response instead of compareResponse. Because of the implementation of the Python ldap module, such a response would lead to an exception and authentication will fail.
adam added the status: acceptedtype: documentation labels 2025-12-29 18:18:57 +01:00
adam closed this issue 2025-12-29 18:18:57 +01:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/netbox#2451