Nginx 基本身份认证模块 ngx_http_auth_basic_module

  ngx_http_auth_basic_module允许通过使用"HTTP基本身份认证"协议验证用户名和密码来限制对资源的访问。坦白点来说，如果想对某目录设置访问权限，可以使用ngx_http_auth_basic_module提供的功能。

  基本身份认证模块 语法及语义

  auth_basic

   语法：auth_basic string | off;

   语义：使用"HTTP基本身份认证"协议启用用户名和密码的验证。指定的参数用作realm，参数值可以包含变量（1.3.10、1.2.7）。设置特殊值off将关闭身份认证。

   参数值会作为提示显示在认证对话框标题栏中。

  auth_basic_user_file

   语法：auth_basic_user_file file;

   语义：

   指定存储用户名和密码的文件格式：

# comment
name1:password1
name2:password2:comment
name3:password3

   密码支持以下类型：

   · 使用crypt()函数加密。可以使用Apache Http Server发行版中的“htpasswd”实用程序或“openssl passwd”命令生成。

   · 使用基于MD5的密码算法（apr1）的Apache变体进行散列；可以使用相同的工具生成。

   · 由RFC2307中描述的"{scheme}data"语法（1.0.3+）指定。当前实现方案包括文本（用于示例，不应使用）、SHA(1.3.13)(SHA-1哈希文本，不应使用)、SSHA（SHA-1加盐哈希，被OpenLDAP、Dovecot等软件包使用）。

  htpasswd 生成密码文件

  htpasswd是开源Http服务器Apache Http Server的一个命令工具，所以本机如果没有该命令，需要先安装。

yum install httpd-tools -y

  htpasswd指令用来创建和更新用于基本认证的用户认证密码文件。htpasswd指令必须对密码文件有读写权限，否则会返回错误码。

  htpasswd参数列表：

参数	参数说明
-b	密码直接写在命令行中，而非使用提示输入的方式
-c	创建密码文件，若文件存在，则覆盖文件重新写入
-n	不更新密码文件，将用户名密码进行标准输出
-m	使用MD5算法对密码进行处理
-d	使用CRYPT算法对密码进行处理
-s	使用SHA算法对密码进行处理
-p	不对密码进行加密处理，使用明文密码
-D	从密码文件中删除指定用户记录

  htpasswd生成Nginx密码文件：

htpasswd -bc /usr/local/nginx/conf/nginxpasswd Securitit 000000

  此时查看/usr/local/nginx/conf/nginxpasswd文件：

Securitit:$apr1$nuJ/GIEt$nH8z8kk0EFVq5oo9.qRzI/

  若要在已有Nginx密码文件中追加用户，则无需-c参数：

htpasswd -b /usr/local/nginx/conf/nginxpasswd Csdn 111111

  此时查看/usr/local/nginx/conf/nginxpasswd文件：

Securitit:$apr1$nuJ/GIEt$nH8z8kk0EFVq5oo9.qRzI/
Csdn:$apr1$1IWZsiJl$q1K5CwAboegG1LO18Jdta0

  基本身份认证模块 示例

  基于默认nginx.conf进行修改，使用上面生成的密码文件进行认证：

worker_processes  1;

error_log  logs/error.log;

events {
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;

    sendfile        on;

    keepalive_timeout  65;

    server {
        listen       80;
        server_name  securitit;

        location / {
	    	auth_basic "Please Input UserName And Password!";
		
	    	auth_basic_user_file nginxpasswd;
        }

    }

}

  通过./nginx -s reload平滑重启Nginx，通过浏览器访问http://192.168.20.9/，会出现如下的效果：

  注：图标红色标记的即是auth_basic配置的参数值。

  此时，需输入用户名和密码访问资源，若点击"取消"，则会提示访问受限：

  输入正确的用户名和密码，可以正确访问目标资源：

  基本身份认证模块 目录检索示例

  参照Nginx 目录浏览模块 中文乱码 访问认证 ngx_http_autoindex_module，进行配置，Nginx可以进行目录检索，针对不同的目录，设置不同的权限，实现资源访问控制。

​  访问时，进行身份认证：

​

  身份认证成功后，可以访问对应的目录及资源：

  此时，对于目录的分层、分类、权限分离就显得很重要了。

  总结

  应用系统中，对于目录的访问权限设置同样重要，但是一般不会使用"HTTP基本身份认证"这种方式。首先，面对大众用户，其表现形式显得很不友好，与现代Web UI的富表现技术相比，过于单薄。再者，使用密码文件的方式管理权限，过于笨重，当待管理的权限体量过大时，会造成很大的不变。

  若文中存在错误和不足，欢迎指正！