Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Implement LDAP server functionality#420

Merged
notquitenothing merged 6 commits into
voidauth:mainvoidauth/voidauth:mainfrom
Malasaur:feature/ldap-serverMalasaur/voidauth:feature/ldap-serverCopy head branch name to clipboard
May 22, 2026
Merged

Implement LDAP server functionality#420
notquitenothing merged 6 commits into
voidauth:mainvoidauth/voidauth:mainfrom
Malasaur:feature/ldap-serverMalasaur/voidauth:feature/ldap-serverCopy head branch name to clipboard

Conversation

@Malasaur
Copy link
Copy Markdown
Contributor

Description

Added optional LDAP directory server functionality, as requested and discussed here and here.

The image now accepts new LDAP_* environment variables to enable and configure the LDAP server.

If enabled, a separate LDAP server starts on another port (3890 by default) to listen to LDAP queries.

The LDAP server is currently read-only and this PR is mostly a PoC, as I'm no expert in LDAP (learned it last night) and additional functionality may be added. It tries to implement most of the common LDAP endpoints and functionality, possibly working as a full replacement for LLDAP. It supports service-account bind, user DN bind, search, compare, RootDSE discoveries, user and group entries, and membership attributes.

It only implements the LDAP endpoints functionality discussed here, allowing other services to use VoidAuth as an LDAP server. It does not implement connecting to an LDAP server and using it as a source for users/groups in VoidAuth.

Documentation was updated too. The frontend is untouched.

Changes

  • Add optional LDAP server controlled by LDAP_ENABLED.
  • Add LDAP configuration for host, port, base DN, people/groups OUs, service bind DN/password, anonymous search, and LDAPS cert/key files.
  • Expose users under ou=people,{LDAP_BASE_DN}.
  • Expose groups under ou=groups,{LDAP_BASE_DN}.
  • Support LDAP operations:
    • simple bind
    • search
    • compare
    • unbind
    • RootDSE base search
  • Support common object classes and attributes:
    • inetOrgPerson
    • posixAccount
    • groupOfNames
    • groupOfUniqueNames
    • posixGroup
    • memberOf
    • member
    • uniqueMember
    • memberUid
  • Filter LDAP-visible users using existing VoidAuth user state checks.
  • Use VoidAuth password verification for LDAP user binds.
  • Add LDAP server documentation and environment variable descriptions.
  • Expose default LDAP port 3890 in the Dockerfile.

Related Tickets & Documents

@notquitenothing
Copy link
Copy Markdown
Collaborator

Thank you for opening a PR! I will take a look at this when I get the chance

@notquitenothing
Copy link
Copy Markdown
Collaborator

I have spent my free time over the past few days going though this PR and reading up on the LDAP spec. I will probably merge this in soon, though I will likely change some of the configuration options before it is released. I have been mostly testing locally with ldap-utils (ldapwhoami and ldapsearch) so further testing will need to be done with real client apps. Possibly even a LDAP Client Guides docs page similar to the OIDC App Guides page.

@Malasaur
Copy link
Copy Markdown
Contributor Author

That's great! Take all the time you need!
I'm in for giving a hand with the LDAP Clients Guide if needed, I personally wanted to use this for Stalwart

@notquitenothing notquitenothing merged commit ee0ae19 into voidauth:main May 22, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

Morty Proxy This is a proxified and sanitized view of the page, visit original site.