Nginx LDAP 认证模块使用与安装指南

本文档将详细介绍如何在 Nginx 中安装和使用 LDAP 认证模块，以支持与多个 LDAP 服务器进行认证。

1. 安装指南

FreeBSD 系统安装

首先，切换到 Nginx 端口目录并执行以下命令：

cd /usr/ports/www/nginx && make config install clean

然后检查 HTTP_AUTH_LDAP 选项：

[*] HTTP_AUTH_LDAP        3rd party http_auth_ldap module

Linux 系统安装

在 Linux 系统上，首先克隆 GitHub 上的模块代码：

cd ~ && git clone https://github.com/kvspb/nginx-auth-ldap.git

接着，在 Nginx 源码目录中，执行以下命令：

./configure --add-module=path_to_http_auth_ldap_module
make install

确保替换 path_to_http_auth_ldap_module 为实际的模块路径。

2. 项目使用说明

以下是一个配置示例，展示如何在 Nginx 中定义 LDAP 服务器列表及其用户/组要求：

http {
  ldap_server test1 {
    url ldap://192.168.0.1:3268/DC=test,DC=local?sAMAccountName?sub?(objectClass=person);
    binddn "TEST\\LDAPUSER";
    binddn_passwd LDAPPASSWORD;
    group_attribute uniquemember;
    group_attribute_is_dn on;
    require valid_user;
  }

  ldap_server test2 {
    url ldap://192.168.0.2:3268/DC=test,DC=local?sAMAccountName?sub?(objectClass=person);
    binddn "TEST\\LDAPUSER";
    binddn_passwd LDAPPASSWORD;
    group_attribute uniquemember;
    group_attribute_is_dn on;
    require valid_user;
  }
}

然后，在 location 或 server 指令中添加所需的服务器：

server {
    listen       8000;
    server_name  localhost;

    auth_ldap "Forbidden";
    auth_ldap_servers test1;
    auth_ldap_servers test2;

    location / {
        root   html;
        index  index.html index.htm;
    }
}

3. 项目 API 使用文档

以下列出了一些可用的配置参数及其预期值：

• url: 字符串，支持的 URL 协议有 ldap:// 和 ldaps://
• binddn: 字符串
• binddn_passwd: 字符串
• group_attribute: 字符串
• group_attribute_is_dn: on 或 off，默认 off
• require: valid_user, user, group
• satisfy: all, any
• max_down_retries: 数字，默认 0
• connections: 大于 0 的数字
• ssl_check_cert: on 或 off，默认 off
• ssl_ca_file: 文件路径
• ssl_ca_dir: 目录路径
• referral: on, off

4. 项目安装方式

请参考上述的安装指南进行安装。确保替换相应的路径和配置参数以适应您的环境。