HTTP Auth Basic模块是个很好用的模块,使用它可以零编码实现一个用户认证体系.
Auth Basic模块有个缺点,就是它是用htpasswd文件方式来实现认证的,在更新频繁的环境或跨服务器时,文件方式操作起来就非常麻烦,因此,就催生出了新的方式:PAM,用PAM可以直接从数据库验证用户名密码,这样就不用折腾那htpasswd文件了。
PAM可看作一个用户、权限认证方面的接口,利用它可以在认证程序和密码存储程序之间建立起一个桥梁。类似于fastcgi,它并不局限于某个软件,不单只能连接nginx和mysql,还可以让nginx连接到postgres或 oracle,也可以连接到LDAP这样的公用服务器。
nginx本身并不支持PAM,由PAM模块提供此项功能,PAM模块是一个第三方模块,需要另外下载安装。
一、安装软件
需要安装的软件有:nginx、 ngx_http_auth_pam_module、pam-mysql、mysql
1)nginx和ngx_http_auth_pam_module
ngx_http_auth_pam_module在:
http://web.iti.upv.es/~sto/nginx/
下载.
我测试的nginx版本是0.7.63,在配置选项之后多加一个:
--add-module=../ngx_http_auth_pam_module-1.1
(nginx在/home/download/nginx-0.7.63/)
(ngx_http_auth_pam_module在/home/download/ngx_http_auth_pam_module-1.1/)
编译安装就完成了,编译过程中如果有pam方面的错误,那一般是系统缺少pam-dev,我用的是 debian,需要安装libpam0g-dev这个包:
apt-get install libpam0g-dev
2)mysql
在debian系统下简单的安装:
apt-get install mysql-server-5.0
3)pam-mysql
这一步就是取得/lib/security/pam_mysql.so这个文件,我用:
apt-get install libpam-mysql
就可以,其它系统的下载源码,make一下即可。
二、配置
1)配置mysql
mysql这块需要配置的不多,建一个库、一个表来存储密码,然后配置好访问mysql的访问账号,就可以了:
create database pam;
user pam;
create table user (userid varchar(16),passwd varchar(50),primary key (userid))type=innodb default charset=utf8;
GRANT SELECT ON pam.* TO pamuser@localhost IDENTIFIED BY '123456';
执行完上面语句之后,得到:
库:pam
表:user
字段:userid, passwd
访问账号:pamuser
访问密码:123456
2)配置pam-mysql
在/etc/pam.d/ 下建一个文件nginx-mysql
/etc/pam.d/nginx-mysql
内容:
auth required /lib/security/pam_mysql.so user=pamuser passwd=123456 host=localhost db=pam table=user usercolumn=userid passwdcolumn=passwd crypt=2
account required /lib/security/pam_mysql.so user=pamuser passwd=123456 host=localhost db=pam table=user usercolumn=userid passwdcolumn=passwd crypt=2
这个文件的文件名可以自己取,只要和后面的nginx配置对应上即可。配置文件里把mysql的配置对应拷进去,两句话除了开头的一个单词 auth和account外,都是一样的。
配置中的crypt:
0=plain: 明码
1=Y: crypt()函数
2=mysql: mysql的 password()函数
3=md5: mysql的 md5()函数
详细配置可见:
http://pam-mysql.sourceforge.net/Documentation/package-readme.php
3)配置nginx
server {
listen 80;
server_name pam.ws.netease.com;
location / {
auth_pam "mysql pam";
auth_pam_service_name "nginx-mysql";
root /data/html/;
}
}
auth_pam:提示语
auth_pam_service_name:/etc/pam.d/下对应文件的名字
测试:
在mysql插入一条记录:
insert into user values ('abc',password('12345'));
在/data/html/下建一个文件:
echo "test" > /data/html/test.html
然后打开页面,输入账号密码,看到test就说明成功了。
-------------------------------
注意:
1) 因为每次请求都会访问mysql认证权限,会对效率有影响,所以不必要的请求,如图片css这些就尽量不要通过认证之后再访问。
2) 可根据版本支持新旧password函数,在mysql5也可用配置参数old_passwords=1强制使用旧函数.
Auth Basic模块有个缺点,就是它是用htpasswd文件方式来实现认证的,在更新频繁的环境或跨服务器时,文件方式操作起来就非常麻烦,因此,就催生出了新的方式:PAM,用PAM可以直接从数据库验证用户名密码,这样就不用折腾那htpasswd文件了。
PAM可看作一个用户、权限认证方面的接口,利用它可以在认证程序和密码存储程序之间建立起一个桥梁。类似于fastcgi,它并不局限于某个软件,不单只能连接nginx和mysql,还可以让nginx连接到postgres或 oracle,也可以连接到LDAP这样的公用服务器。
nginx本身并不支持PAM,由PAM模块提供此项功能,PAM模块是一个第三方模块,需要另外下载安装。
一、安装软件
需要安装的软件有:nginx、 ngx_http_auth_pam_module、pam-mysql、mysql
1)nginx和ngx_http_auth_pam_module
ngx_http_auth_pam_module在:
http://web.iti.upv.es/~sto/nginx/
下载.
我测试的nginx版本是0.7.63,在配置选项之后多加一个:
--add-module=../ngx_http_auth_pam_module-1.1
(nginx在/home/download/nginx-0.7.63/)
(ngx_http_auth_pam_module在/home/download/ngx_http_auth_pam_module-1.1/)
编译安装就完成了,编译过程中如果有pam方面的错误,那一般是系统缺少pam-dev,我用的是 debian,需要安装libpam0g-dev这个包:
apt-get install libpam0g-dev
2)mysql
在debian系统下简单的安装:
apt-get install mysql-server-5.0
3)pam-mysql
这一步就是取得/lib/security/pam_mysql.so这个文件,我用:
apt-get install libpam-mysql
就可以,其它系统的下载源码,make一下即可。
二、配置
1)配置mysql
mysql这块需要配置的不多,建一个库、一个表来存储密码,然后配置好访问mysql的访问账号,就可以了:
create database pam;
user pam;
create table user (userid varchar(16),passwd varchar(50),primary key (userid))type=innodb default charset=utf8;
GRANT SELECT ON pam.* TO pamuser@localhost IDENTIFIED BY '123456';
执行完上面语句之后,得到:
库:pam
表:user
字段:userid, passwd
访问账号:pamuser
访问密码:123456
2)配置pam-mysql
在/etc/pam.d/ 下建一个文件nginx-mysql
/etc/pam.d/nginx-mysql
内容:
auth required /lib/security/pam_mysql.so user=pamuser passwd=123456 host=localhost db=pam table=user usercolumn=userid passwdcolumn=passwd crypt=2
account required /lib/security/pam_mysql.so user=pamuser passwd=123456 host=localhost db=pam table=user usercolumn=userid passwdcolumn=passwd crypt=2
这个文件的文件名可以自己取,只要和后面的nginx配置对应上即可。配置文件里把mysql的配置对应拷进去,两句话除了开头的一个单词 auth和account外,都是一样的。
配置中的crypt:
0=plain: 明码
1=Y: crypt()函数
2=mysql: mysql的 password()函数
3=md5: mysql的 md5()函数
详细配置可见:
http://pam-mysql.sourceforge.net/Documentation/package-readme.php
3)配置nginx
server {
listen 80;
server_name pam.ws.netease.com;
location / {
auth_pam "mysql pam";
auth_pam_service_name "nginx-mysql";
root /data/html/;
}
}
auth_pam:提示语
auth_pam_service_name:/etc/pam.d/下对应文件的名字
测试:
在mysql插入一条记录:
insert into user values ('abc',password('12345'));
在/data/html/下建一个文件:
echo "test" > /data/html/test.html
然后打开页面,输入账号密码,看到test就说明成功了。
-------------------------------
注意:
1) 因为每次请求都会访问mysql认证权限,会对效率有影响,所以不必要的请求,如图片css这些就尽量不要通过认证之后再访问。
2) 可根据版本支持新旧password函数,在mysql5也可用配置参数old_passwords=1强制使用旧函数.