Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

OpenLDAP Web 管理服务

将 OpenLDAP 的常用管理操作全部 Web 化:目录树浏览、全局搜索、用户管理(增删改、重置密码、启用/禁用)、组管理、OU 管理,并通过 LDAP 账号登录(管理员可管理全库,普通用户可自助查看/修改自己的密码)。

技术栈

  • 后端:Node.js + Express + ldapjs
  • 前端:原生 HTML/JS/CSS 单页应用
  • 测试环境:Docker(osixia/openldap)

快速开始

# 1. 准备环境配置
cp .env.example .env   # 按实际环境修改 LDAP 连接信息

# 2. 启动 OpenLDAP 测试环境(已有服务器可跳过)
docker compose up -d

# 3. (测试环境可选)启用 ppolicy 账号锁定支持 + 初始化示例数据
bash scripts/setup-ldap.sh

# 4. 安装依赖并启动
npm install
npm start

访问 http://localhost:3000,使用 LDAP 账号登录:

  • 测试环境管理员:用户名 admin,密码 admin123
  • 普通用户:如测试数据中的 zhangsan / Passw0rd!

环境变量

变量 说明 默认值
LDAP_URL LDAP 服务器地址 ldap://localhost:389
LDAP_BIND_DN 管理服务绑定的 DN cn=admin,dc=example,dc=org
LDAP_BIND_PASSWORD 管理绑定密码 admin123
LDAP_BASE_DN 管理范围 Base DN dc=example,dc=org
LDAP_USER_SEARCH_BASE 用户登录搜索基础 同 BASE_DN
LDAP_USER_SEARCH_FILTER 登录用户搜索过滤器 (uid={0})
LDAP_ADMIN_UIDS 拥有管理权限的 uid 列表 admin
LDAP_ADMINS 拥有管理权限的 DN 列表 -
PORT Web 服务端口 3000
SESSION_SECRET 会话密钥(务必修改) -

API 一览

方法 路径 说明 权限
POST /api/auth/login LDAP 账号登录 -
POST /api/auth/logout 退出 登录
GET /api/auth/me 当前用户信息 登录
POST /api/auth/me/password 自助修改密码 登录
GET /api/directory/children 目录树子节点(懒加载) 登录
GET /api/directory/search 全局搜索 登录
GET /api/directory/entry 条目详情 登录
POST /api/directory/ou 创建 OU 管理员
DELETE /api/directory/entry 删除条目(?recursive=true 递归) 管理员
POST /api/directory/entry/rename 重命名/移动 管理员
GET /api/users/list 用户列表(支持关键字) 管理员
POST /api/users 创建用户 管理员
GET/PUT/DELETE /api/users/detail 用户详情/更新/删除 管理员
POST /api/users/detail/password 重置密码(generate=true 随机生成) 管理员
POST /api/users/detail/enable 启用/禁用账号 管理员
GET /api/groups/list 组列表 管理员
POST /api/groups 创建组 管理员
PUT /api/groups/detail 更新组信息 管理员
POST /api/groups/detail/members 成员增删 管理员
DELETE /api/groups/detail 删除组 管理员

关于"禁用账号"

禁用账号通过 shadowAccount 的 shadowExpire=1(1970-01-01,恒为过期)实现,使用 OpenLDAP 默认自带 schema,无需额外 overlay。本服务登录时会拒绝已禁用账号;依赖 NSS/PAM shadow 语义的系统同样会视其为过期账号。

测试环境首次启动后可运行 bash scripts/setup-ldap.sh 初始化 OU、示例用户和组。

生产部署建议

  1. 修改 SESSION_SECRET 为随机值
  2. 前置 Nginx 做 HTTPS
  3. .env 中 LDAP_ADMINS / LDAP_ADMIN_UIDS 精确指定管理员
  4. 如需限制管理范围,将 LDAP_BASE_DN 设为子树

测试

# 端到端 API 测试(需先启动 OpenLDAP 测试容器与本服务)
node scripts/test-api.mjs

覆盖:登录/会话、目录树、用户 CRUD、重置密码、禁用/启用、组管理、OU 管理、中英文搜索、自助改密、权限隔离、越界 DN 防护等 29 项。

已知问题:ldapjs 的 LDAP 子串过滤器对非 ASCII 字符存在编码 bug,中文关键字搜索已自动降级为"服务端拉取 + 应用层过滤",功能不受影响。

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages