Auth PAM#

The module checks the user name and password that the client sends with HTTP Basic authentication through PAM. The PAM service that the module uses decides how the credentials are verified, for example against an LDAP server.

Installation#

To install the module, use one of the following packages:

  • Angie: angie-module-auth-pam

  • Angie PRO: angie-pro-module-auth-pam

Loading the Module#

Load the module in the main{} context:

load_module modules/ngx_http_auth_pam_module.so;

Configuration Example#

location /secure {
    auth_pam              "Secure Zone";
    auth_pam_service_name "angie";
}

As an example, to authenticate users on an LDAP server (using the pam_ldap.so module), the /etc/pam.d/angie file may contain the following:

auth    required     /lib/security/pam_ldap.so
account required     /lib/security/pam_ldap.so

Additional Information#

Version: v1.5.5

Detailed documentation and source code are available at: sto/ngx_http_auth_pam_module