PHPackages                             yippy/flarum-ext-auth-ldap - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication &amp; Authorization](/categories/authentication)
4. /
5. yippy/flarum-ext-auth-ldap

ActiveFlarum-extension[Authentication &amp; Authorization](/categories/authentication)

yippy/flarum-ext-auth-ldap
==========================

Allow users to log in through LDAP.

v2.0.2(1y ago)25091MITTypeScript

Since Mar 5Pushed 1y agoCompare

[ Source](https://github.com/Yippy/flarum-ext-auth-ldap)[ Packagist](https://packagist.org/packages/yippy/flarum-ext-auth-ldap)[ Fund](https://www.buymeacoffee.com/yippy)[ RSS](/packages/yippy-flarum-ext-auth-ldap/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (4)Dependencies (2)Versions (11)Used By (0)

Flarum LDAP authentication
==========================

[](#flarum-ldap-authentication)

[![MIT license](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://github.com/Yippy/flarum-ext-auth-ldap/blob/master/LICENSE) [![Latest Stable Version](https://camo.githubusercontent.com/02eab37506dc864b6e1c6f10033905dfb8e63ee3517cd059cea404a696448db1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f79697070792f666c6172756d2d6578742d617574682d6c6461702e737667)](https://packagist.org/packages/yippy/flarum-ext-auth-ldap) [![Total Downloads](https://camo.githubusercontent.com/15d4d8a8df632f18eb9334cc59cebef6f0d30cb3933c2baa095cab5855c73370/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f79697070792f666c6172756d2d6578742d617574682d6c6461702e737667)](https://packagist.org/packages/yippy/flarum-ext-auth-ldap) [![Donate](https://camo.githubusercontent.com/b33fbc711bf26764ca7c465b1f5c09ed1235c549617f7814435861f6af7fcb2f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2d4275792532304d6525323061253230436f666665652d6666356635663f6c6f676f3d6b6f2d6669266c6f676f436f6c6f723d7768697465)](https://www.buymeacoffee.com/yippy)

Based on [tituspijean/flarum-ext-auth-ldap](https://github.com/tituspijean/flarum-ext-auth-ldap)

This extension enables users to log into [Flarum](https://github.com/flarum/core) through LDAP, there has been new improvement with this fork. With multiple LDAP server support, and optional email field.

How to install
--------------

[](#how-to-install)

`composer require yippy/flarum-ext-auth-ldap`

You must run this command for this extension to work, this is because the assets command will include select2 for the dropdown menu to work.

```
`php flarum assets:publish`

```

[![Run Flarum Assets Command](https://github.com/Yippy/flarum-ext-auth-ldap/raw/master/assets/images/run_flarum_assets_command.png)](https://github.com/Yippy/flarum-ext-auth-ldap/raw/master/assets/images/run_flarum_assets_command.png)

If you are unable to run that command, and the dropdown menu is still not working. You can copy the [asset manually](https://github.com/Yippy/flarum-ext-auth-ldap/tree/master/assets) and move it to the \[FLARUM\_DATA\_DIRECTORY\]\\assets\\extensions\\yippy-auth-ldap\\ folder.

Activate it in Flarum's administration panel.

Languages
---------

[](#languages)

This extension support English.

Configuration
-------------

[](#configuration)

[![Screenshot](https://github.com/Yippy/flarum-ext-auth-ldap/raw/master/assets/images/ldap_login_settings.png)](https://github.com/Yippy/flarum-ext-auth-ldap/raw/master/assets/images/ldap_login_settings.png)

- `LDAP server name`: sets the end of the `Login with` link at the top of the forum: [![image](https://github.com/Yippy/flarum-ext-auth-ldap/raw/master/assets/images/ldap_login_header.png)](https://github.com/Yippy/flarum-ext-auth-ldap/raw/master/assets/images/ldap_login_header.png)
- `LDAP domains or server IP adresses (comma separated)`: list of LDAP servers to use.
- `Port`: LDAP server port
- `LDAP Version`: LDAP server version
- `Base DNs (semicolon separated)`: list of base DNs to search users in.
- `Filter to apply (optional)`: Additional filtering, for example require users to be in a specific group.
- `Follow referrals`, `Use SSL`, `Use TLS`: LDAP server settings
- `LDAP admin distinguished name` and `LDAP admin password (leave empty for anonymous binding)` : if needed, specific the DN and password of the user allowed to perform searches in the LDAP server.
- `LDAP user search fields (comma separated)`: list of the LDAP fields used to look for the users. The extension will try all combinations of base DNs and search fields.
- `LDAP username field`: name of the field containing the username that uniquely identifies the user. Can be `uid` or `sAMAccountname`, for example.
- `LDAP email field (optional)`: name of the field containing the user's email address. The extension will use the first email found for the user's registration in Flarum.
- `LDAP nickname search fields, enable Nicknames extension (comma separated)`
- `Disable Flarum login and only use LDAP authentication`: merely hides the standard login links and buttons. Users can still use the standard login method through the API.
- `Display detailed LDAP errors for failed login attempts`: enable this option to help troubleshoot LDAP account errors for failed login, this will display a error whether the account isn't found, disabled or password expired.
- `Assign specific Permissions`: Automatically add User Permission Groups to newly created Users from this LDAP Server: [![image](https://github.com/Yippy/flarum-ext-auth-ldap/raw/master/assets/images/ldap_new_user_confirmation_popup.png)](https://github.com/Yippy/flarum-ext-auth-ldap/raw/master/assets/images/ldap_new_user_confirmation_popup.png)
- `Enable LDAP Server`: Toggle LDAP Domain server, when disabled (Unticked) this setting will be skipped.

Development (With docker)
-------------------------

[](#development-with-docker)

- Clone the repository
- Copy docker.conf : `cp docker/.docker.conf.dist docker/.docker.conf`
- Change UID in `docker/.docker.conf` if needed.
- Start dockers : `./install.sh install`
- Open
    - MySQL host: mysql
    - MySQL DB: flarum
    - MySQL user: flarum
    - MySQL password: flarum
- Go to Admin panel and enable extension
    - LDAP domain: ldap
    - LDAP DN: dc=flarum,dc=com
    - Check connect with Ldap admin
    - LDAP admin: cn=admin,dc=flarum,dc=com
    - LDAP admin password: flarum
    - LDAP search user fields: cn,mail
    - LDAP user mail: mail
    - LDAP user username: cn
- Add and user on :
    - Login: cn=admin,dc=flarum,dc=com
    - Password: flarum
    - Create a new entry -&gt; Default -&gt; inetOrgPerson

Support
-------

[](#support)

This extension is under **minimal maintenance**.

Links
-----

[](#links)

- [GitHub](https://github.com/Yippy/flarum-ext-auth-ldap)
- [Packagist](https://packagist.org/packages/yippy/flarum-ext-auth-ldap)
- [Discuss](https://discuss.flarum.org/d/34414-ldap-login-extension-with-multiple-ldap-server-support)

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance48

Moderate activity, may be stable

Popularity18

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 54.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~60 days

Recently: every ~2 days

Total

8

Last Release

379d ago

Major Versions

v0.0.2 → v1.0.02025-06-02

v1.0.0 → v2.0.02025-06-04

v1.0.1 → v2.0.12025-06-04

v1.0.2 → v2.0.22025-06-12

### Community

Maintainers

![](https://www.gravatar.com/avatar/c12cc82637b94f677abc44274ac88925548498533528c13683dbb3aab836c972?d=identicon)[Yippy](/maintainers/Yippy)

---

Top Contributors

[![Yippy](https://avatars.githubusercontent.com/u/6518915?v=4)](https://github.com/Yippy "Yippy (32 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (16 commits)")[![CodazziS](https://avatars.githubusercontent.com/u/8134250?v=4)](https://github.com/CodazziS "CodazziS (10 commits)")[![QF0xB](https://avatars.githubusercontent.com/u/37348361?v=4)](https://github.com/QF0xB "QF0xB (1 commits)")

---

Tags

Authenticationldapflarum

### Embed Badge

![Health badge](/badges/yippy-flarum-ext-auth-ldap/health.svg)

```
[![Health](https://phpackages.com/badges/yippy-flarum-ext-auth-ldap/health.svg)](https://phpackages.com/packages/yippy-flarum-ext-auth-ldap)
```

###  Alternatives

[directorytree/ldaprecord-laravel

LDAP Authentication &amp; Management for Laravel.

5742.2M17](/packages/directorytree-ldaprecord-laravel)[flarum-lang/russian

Russian language pack for Flarum.

12127.5k](/packages/flarum-lang-russian)[maicol07/flarum-ext-sso

SSO for Flarum

468.7k](/packages/maicol07-flarum-ext-sso)[causal/ig_ldap_sso_auth

This extension provides LDAP support for TYPO3 by delegating the authentication of frontend and/or backend users to the centrally-managed directory of your organization. It fully supports OpenLDAP and Active Directory and is capable of connecting securely to the authentication server using either TLS or SSL (ldaps://). In case of use in an intranet environment, this extension is a perfect match since it natively brings Single Sign-On (SSO) capability to TYPO3 without any complex configuration.

32388.0k1](/packages/causal-ig-ldap-sso-auth)[flarum-lang/french

French language pack to localize the Flarum forum software plus its official and third-party extensions.

1936.5k](/packages/flarum-lang-french)[nomiscz/flarum-ext-auth-wechat

Allow users to log in with WeChat

142.6k](/packages/nomiscz-flarum-ext-auth-wechat)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
