<!-- review: finished -->

<a id="external-ldap"></a>

# Auth LDAP

The LDAP module supports authentication across multiple LDAP servers.

<a id="installation-1"></a>

## Installation

To [install](https://en.angie.software//angie/docs/installation/index.md#install-packages) the module, use one of the
following packages:

- Angie: `angie-module-auth-ldap`
- Angie PRO: `angie-pro-module-auth-ldap`

<a id="loading-the-module-1"></a>

## Loading the module

Load the module in the `main{}` context:

```nginx
load_module modules/ngx_http_auth_ldap_module.so;
```

<a id="configuration-example-79"></a>

## Configuration example

```nginx
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;
    }

    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;
        }
    }
}
```

<a id="additional-information-1"></a>

## Additional information

Detailed documentation and source code are available at:
[https://github.com/kvspb/nginx-auth-ldap](https://github.com/kvspb/nginx-auth-ldap)
