百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
L

luminary

> 编程语言
开源

一个基于 PHP 的 Web 界面,用于管理 LDAP 用户帐户和自助更改密码。

539 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

一个基于 PHP 的 Web 界面,用于管理 LDAP 用户帐户和自助更改密码。

Luminary

Note: This project was previously known as ldap-user-manager. If you're looking for the ldap-user-manager project, you're in the right place - it's now called Luminary!

A web-based interface for managing LDAP user accounts and groups, with self-service password management and multi-factor authentication support.

Overview

Luminary is a web application designed to simplify LDAP directory management through an intuitive web interface. It's built to work seamlessly with OpenLDAP and runs as a Docker container, making it easy to deploy alongside LDAP servers like osixia/openldap.

This project complements openvpn-server-ldap-otp by providing a user-friendly way for administrators to manage accounts and for users to self-enrol in multi-factor authentication.

Features

  • Setup wizard: Automatically creates the necessary LDAP structure and initial admin user
  • User management: Create, edit, and delete user accounts with ease
  • Group management: Organise users into groups with flexible membership controls
  • Self-service password change: Users can securely update their own passwords
  • Multi-factor authentication: Self-service TOTP enrolment with QR code generation
  • Email notifications: Optional email delivery for new account credentials
  • Password tools: Secure password generator and strength indicator
  • Account requests: Allow users to request accounts via a web form
  • Customisable: Brand the interface with your organisation's logo and styling

Quick start

This example shows how to run Luminary for testing, using osixia/openldap:

1. Start OpenLDAP

bash
docker run \
  --detach \
  --name openldap \
  --hostname openldap \
  -p 389:389 \
  -e LDAP_ORGANISATION="Example Ltd" \
  -e LDAP_DOMAIN="example.com" \
  -e LDAP_ADMIN_PASSWORD="admin_password" \
  -e LDAP_TLS_VERIFY_CLIENT="never" \
  -e LDAP_RFC2307BIS_SCHEMA="true" \
  osixia/openldap:latest

Note: if you want to enable MFA support then follow the quick set-up guide for ldap-totp-schema which provides instructions for running the osixia/openldap container with support for the TOTP schema (which stores MFA information in LDAP).

2. Start Luminary

bash
docker run \
  --detach \
  --name luminary \
  -p 8080:80 \
  -p 8443:443 \
  -e SERVER_HOSTNAME="localhost" \
  -e LDAP_URI="ldap://openldap:389" \
  -e LDAP_BASE_DN="dc=example,dc=com" \
  -e LDAP_REQUIRE_STARTTLS="true" \
  -e LDAP_ADMIN_BIND_DN="cn=admin,dc=example,dc=com" \
  -e LDAP_ADMIN_BIND_PWD="admin_password" \
  -e LDAP_IGNORE_CERT_ERRORS="true" \
  --link openldap:openldap \
  wheelybird/luminary:v2.2.1

3. Run the setup wizard

Visit https://localhost:8443/setup (accept the self-signed certificate warning) and follow the wizard to:

  • Verify LDAP connectivity
  • Create the organisational units for users and groups
  • Create the admins group
  • Create your first admin user

4. Log in

Once setup is complete, you can log in at https://localhost:8443 with your admin credentials.

Configuration

Luminary is configured entirely through environment variables. The main categories are:

Documentation Description
Configuration reference Complete list of all environment variables with descriptions and defaults
Multi-factor authentication Setting up and using MFA/TOTP authentication
Advanced topics HTTPS certificates, custom attributes, email setup, and more

Essential configuration

The following environment variables are required:

  • LDAP_URI - LDAP server URI (e.g., ldap://ldap.example.com)
  • LDAP_BASE_DN - Base DN for your organisation (e.g., dc=example,dc=com)
  • LDAP_ADMIN_BIND_DN - DN of the admin user (e.g., cn=admin,dc=example,dc=com)
  • LDAP_ADMIN_BIND_PWD - Password for the admin user

All other settings have sensible defaults. For example, the admin group defaults to admins and can be changed with LDAP_ADMINS_GROUP.

Using secrets

For sensitive values like passwords, you can use Docker secrets or mounted files. Append _FILE to any variable name and point it to a file containing the value:

bash
-e LDAP_ADMIN_BIND_PWD_FILE=/run/secrets/ldap_admin_password

Multi-factor authentication

Luminary includes comprehensive MFA support with LDAP-backed TOTP (Time-based One-Time Passwords):

  • Users can self-enrol using QR codes with their authenticator apps
  • Administrators can enforce MFA for specific groups
  • Grace periods allow time for users to set up MFA
  • Backup codes for account recovery
  • Integrates seamlessly with openvpn-server-ldap-otp

For detailed setup instructions, see the MFA documentation.

Integration with OpenVPN

This project is designed to work alongside openvpn-server-ldap-otp:

  1. Use Luminary to create and manage user accounts
  2. Users enrol in MFA through the web interface
  3. TOTP secrets are stored in LDAP
  4. OpenVPN server reads the same LDAP directory for authentication
  5. Users connect to VPN with password+TOTP code

Together, these projects provide a complete, centralised authentication solution.

Development and contributions

This is an open-source project. Contributions, bug reports, and feature requests are welcome via GitHub issues and pull requests.

Building from source

bash
git clone https://github.com/wheelybird/luminary.git
cd luminary
docker build -t luminary .

Support

  • Documentation: See the docs/ directory for detailed guides
  • Issues: Report bugs or request features on GitHub Issues
  • Discussions: Ask questions in GitHub Discussions

Licence

This project is licensed under the MIT Licence. See the LICENCE file for details.

Related projects

  • openvpn-server-ldap-otp - OpenVPN server with LDAP authentication and MFA support
  • ldap-totp-schema - LDAP schema for storing TOTP configuration
  • osixia/openldap - Popular OpenLDAP Docker image

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

PHP

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言