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

2024-12-27 00:23:44作者：伍希望

本文档将详细介绍如何在 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;
    }
}