在筆者之前的博文《關(guān)于httpd 2.x,mod_auth_MySQL模塊的安裝配置以及對(duì)aes加密的支持》中,所提及到的mod_auth_mysql模塊,是專門用于Apache httpd的第三方認(rèn)證模塊。在本文中,將介紹在Nginx上面相對(duì)應(yīng)的一個(gè)模塊,nginx_auth_mysql。
創(chuàng)新互聯(lián)公司是專業(yè)的環(huán)江網(wǎng)站建設(shè)公司,環(huán)江接單;提供成都網(wǎng)站制作、網(wǎng)站建設(shè),網(wǎng)頁(yè)設(shè)計(jì),網(wǎng)站設(shè)計(jì),建網(wǎng)站,PHP網(wǎng)站建設(shè)等專業(yè)做網(wǎng)站服務(wù);采用PHP框架,可快速的進(jìn)行環(huán)江網(wǎng)站開(kāi)發(fā)網(wǎng)頁(yè)制作和功能擴(kuò)展;專業(yè)做搜索引擎喜愛(ài)的網(wǎng)站,專業(yè)的做網(wǎng)站團(tuán)隊(duì),希望更多企業(yè)前來(lái)合作!
準(zhǔn)備工作
下載nginx_auth_mysql的源代碼
CentOS7服務(wù)器,nginx源碼包(筆者使用nginx1.12.0穩(wěn)定版)
支持nginx的編譯環(huán)境,并安裝有openssl開(kāi)發(fā)包
存在libmysqlclient以及l(fā)ibmysqld動(dòng)態(tài)庫(kù)
nginx_auth_mysql的源代碼文件如下所示:
$ ls config crypt_private.c crypt_private.h LICENSE ngx_http_auth_mysql_module.c README
查看一下config配置文件,其內(nèi)容如下所示:
$ cat config.bak ngx_addon_name=ngx_http_auth_mysql_module HTTP_MODULES="$HTTP_MODULES ngx_http_auth_mysql_module" NGX_ADDON_SRCS="$NGX_ADDON_SRCS $ngx_addon_dir/ngx_http_auth_mysql_module.c $ngx_addon_dir/crypt_private.c" CORE_LIBS="$CORE_LIBS -lcrypto -lmysqlclient" USE_MD5=YES
由上述配置文件的格式,可以看出是專門進(jìn)行靜態(tài)編譯的第三方模塊。由于在Nginx 1.9.11版本之后,已經(jīng)支持以動(dòng)態(tài)模塊的方式來(lái)支持第三方擴(kuò)展,并且由上述配置文件的內(nèi)容,初步判定可以將其修改為動(dòng)態(tài)模塊的編譯配置,因此這里將其編譯為動(dòng)態(tài)庫(kù),以供Nginx進(jìn)行加載。
關(guān)于配置文件的修改以及動(dòng)靜模塊的轉(zhuǎn)換,參照如下兩篇文章:
Converting Static Modules to Dynamic Modules
New Config Shell File
經(jīng)過(guò)修改之后的config文件內(nèi)容如下所示:
ngx_addon_name=ngx_http_auth_mysql_module if test -n "$ngx_module_link"; then ngx_module_type=HTTP ngx_module_name=$ngx_addon_name ngx_module_srcs="$ngx_addon_dir/ngx_http_auth_mysql_module.c $ngx_addon_dir/crypt_private.c" ngx_module_incs="/usr/include/mysql" ngx_module_libs="-lcrypto -lmysqlclient -lmysqld -L/usr/lib64/mysql" . auto/module else HTTP_MODULES="$HTTP_MODULES ngx_http_auth_mysql_module" NGX_ADDON_SRCS="$NGX_ADDON_SRCS $ngx_addon_dir/ngx_http_auth_mysql_module.c $ngx_addon_dir/crypt_private.c" CORE_LIBS="$CORE_LIBS -lcrypto -lmysqlclient" USE_MD5=YES fi
在編譯的時(shí)候,添加上--add-dynamic-module選項(xiàng),將模塊添加進(jìn)來(lái)。筆者這里使用的是--add-dynamic-module=/root/nginx-1.12.0/nginx_auth_mysql,其中的nginx_auth_mysql目錄用于存放模塊的源代碼。
在進(jìn)行編譯的過(guò)程中,筆者遇到了如下錯(cuò)誤:
/root/nginx-1.12.0/nginx_auth_mysql/ngx_http_auth_mysql_module.c: In function ‘ngx_http_auth_mysql_check_md5’: /root/nginx-1.12.0/nginx_auth_mysql/ngx_http_auth_mysql_module.c:488:19: error: ‘MD5_DIGEST_LENGTH’ undeclared (first use in this function) u_char md5_str[2*MD5_DIGEST_LENGTH + 1]; ^ /root/nginx-1.12.0/nginx_auth_mysql/ngx_http_auth_mysql_module.c:488:19: note: each undeclared identifier is reported only once for each function it appears in /root/nginx-1.12.0/nginx_auth_mysql/ngx_http_auth_mysql_module.c:489:9: error: unused variable ‘md5_digest’ [-Werror=unused-variable] u_char md5_digest[MD5_DIGEST_LENGTH]; ^ /root/nginx-1.12.0/nginx_auth_mysql/ngx_http_auth_mysql_module.c:488:9: error: unused variable ‘md5_str’ [-Werror=unused-variable] u_char md5_str[2*MD5_DIGEST_LENGTH + 1];
從上面的報(bào)錯(cuò)結(jié)果來(lái)看,可以發(fā)現(xiàn),是MD5_DIGEST_LENGTH沒(méi)有定義,甚是奇怪……
經(jīng)過(guò)排查,在ngx_http_auth_mysql_module.c文件里面,所引用的頭文件當(dāng)中,似乎確實(shí)并未包含MD5_DIGEST_LENGTH的定義,ngx_md5.h的全部?jī)?nèi)容如下所示:
$ cat ngx_md5.h
/*
* Copyright (C) Igor Sysoev
* Copyright (C) Nginx, Inc.
*/
#ifndef _NGX_MD5_H_INCLUDED_
#define _NGX_MD5_H_INCLUDED_
#include <ngx_config.h>
#include <ngx_core.h>
typedef struct {
uint64_t bytes;
uint32_t a, b, c, d;
u_char buffer[64];
} ngx_md5_t;
void ngx_md5_init(ngx_md5_t *ctx);
void ngx_md5_update(ngx_md5_t *ctx, const void *data, size_t size);
void ngx_md5_final(u_char result[16], ngx_md5_t *ctx);
#endif /* _NGX_MD5_H_INCLUDED_ */通過(guò)對(duì)比一個(gè)老版本的nginx源代碼,發(fā)現(xiàn)確實(shí)有所不同,下面的是老版本的nginx的頭文件,可以看出,引用了openssl的md5頭文件定義:
...... ...... #if (NGX_HAVE_MD5) #if (NGX_HAVE_OPENSSL_MD5_H) #include <openssl/md5.h> #else #include <md5.h> #endif ...... ......
通過(guò)查閱md5頭文件,得到其定義的值為16,因此,在nginx-1.12.0的ngx_md5.h里面,添加如下定義:
#define MD5_DIGEST_LENGTH 16
保存之后,重新編譯,成功通過(guò)。
編譯完成之后,在objs文件夾里面生成了所需要的模塊:
$ ls objs/ | grep auth ngx_http_auth_mysql_module_modules.c ngx_http_auth_mysql_module_modules.o ngx_http_auth_mysql_module.so
將ngx_http_auth_mysql_module.so拷貝到對(duì)應(yīng)的模塊目錄里面,至此完成了初步的模塊安裝任務(wù)。
配置內(nèi)容
在nginx.conf文件中的main段里面添加如下一行,代表需要加載該模塊:
load_module modules/ngx_http_auth_mysql_module.so;
筆者使用默認(rèn)主機(jī)/auth路徑下的auth.html進(jìn)行測(cè)試:
$ cat /opt/nginx/html/auth/auth.html <h2>auth page</h2>
在該模塊的README文檔中,詳細(xì)介紹了模塊使用的配置參數(shù),如下所示:
== CONFIGURATION ==
It is activated by adding several configuration options:
auth_mysql_realm: HTTP basic authentiaction realm. Required.
auth_mysql_host: the host of the MySQL server. Default is 127.0.0.1.
auth_mysql_port: on which port to connect to the MySQL server. Default is 3306.
auth_mysql_user: username for connection to the MySQL server. Default is root.
auth_mysql_password: password for connection to the MySQL server. Default is empty.
auth_mysql_database: name of the database. Required.
auth_mysql_table: name of the table, which holds the user record.
You can have more than one table separated by comas. Default is users.auth_mysql_user_column: name of the username column. Default is username.
auth_mysql_password_column: name of the password column. Default is password.
auth_mysql_conditions: Additional SQL conditions. They will be placed after and AND.
Default is empty string.auth_mysql_group_table: name of the table, which holds the groups information.
You can have more than one table separated by comas. Default is the users table.auth_mysql_group_column: name of the group name column. Default is name.
auth_mysql_group_conditions: Additional SQL conditions applied only in group queries.
They will be placed after an AND. Default is empty string.auth_mysql_encryption_type: the format of the password field. Should be one of:
none: the password is stored in plaintext in the database;
md5: in the database is stored a md5 hash of the password;
phpass: a portable php hash of the password is stored. See:
http://www.openwall.com/phpass/ for more information.
The default is md5.auth_mysql_allowed_users: whitespace delimited list of allowed users.
auth_mysql_allowed_groups: whitespace delimited list of allowed groups.
If both allowed_users and allowed_groups are defined, either of them has to satisfied.
筆者這里使用mysql數(shù)據(jù)庫(kù)創(chuàng)建認(rèn)證用戶的內(nèi)容如下所示,創(chuàng)建nginx數(shù)據(jù)庫(kù),在nginx數(shù)據(jù)庫(kù)里面添加一個(gè)nginx_auth的數(shù)據(jù)表,存放user字段和password字段,并且password字段用md5進(jìn)行加密:
$ mysql Welcome to the MariaDB monitor. Commands end with ; or \g. Your MariaDB connection id is 3337 Server version: 5.5.44-MariaDB MariaDB Server Copyright (c) 2000, 2015, Oracle, MariaDB Corporation Ab and others. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. MariaDB [(none)]> use nginx; Reading table information for completion of table and column names You can turn off this feature to get a quicker startup with -A Database changed MariaDB [nginx]> show tables; +-----------------+ | Tables_in_nginx | +-----------------+ | nginx_auth | +-----------------+ 1 row in set (0.00 sec) MariaDB [nginx]> select * from nginx_auth; +------+----------------------------------+ | user | password | +------+----------------------------------+ | tom | d077f244ddf8r70e5ea758bd8352fcd8 | +------+----------------------------------+ 1 row in set (0.00 sec)
在nginx.conf配置文件當(dāng)中使用的配置如下所示:
......
......
location /auth {
root /opt/nginx/html;
index auth.html;
auth_mysql_realm "authentication";
auth_mysql_host "192.168.5.181";
auth_mysql_port "3306";
auth_mysql_user "nginx";
auth_mysql_password "nginx";
auth_mysql_database "nginx";
auth_mysql_table "nginx_auth";
auth_mysql_user_column "user";
auth_mysql_password_column "password";
auth_mysql_encryption_type "md5";
}
......
......reload一下nginx,利用curl命令進(jìn)行測(cè)試,得到的結(jié)果如下所示,可見(jiàn)模塊正常運(yùn)行:
$ curl -u tom:right_password http://192.168.5.181/auth/ <h2>auth page</h2> $ curl -u tom:wrong_password http://192.168.5.181/auth/ <html> <head><title>401 Authorization Required</title></head> <body bgcolor="white"> <center><h2>401 Authorization Required</h2></center> <hr><center>nginx/1.12.0</center> </body> </html>
其他事項(xiàng)
在httpd上面使用的mod_auth_mysql模塊,自帶了aes加密算法,但是在nginx上面使用的此模塊,默認(rèn)卻沒(méi)有添加該項(xiàng)功能,不過(guò)該模塊的作者在README中提到:
== WRITING A NEW ECNRYPTION TYPE ==
Add an entry in thengx_http_auth_mysql_enctypesarray. It has to be a struct
with two elements:
ngx_str_t id
The name under which it should be referenced in the config file
ngx_uint_t (*checker)(ngx_http_request_t *r, ngx_str_t sent_password, ngx_str_t actual_password)
A function, which given the request (mostly used for logging and memory allocation through its r->pool),
the password sent by the user and the password in the database has to determine whether they match.
If they match it should return NGX_OK, if they don’t it should return NGX_DECLINED. If other error
occures, it should log it and return NGX_ERR.Currently salts aren't supported, but if there are schemes, which require them it is quite easy.Questions/patches may be sent to Nikolay Bachiyski, nikolay@automattic.com
似乎只能等待牛人進(jìn)行二次開(kāi)發(fā)了......
網(wǎng)站標(biāo)題:關(guān)于nginx_auth_mysql認(rèn)證模塊
網(wǎng)頁(yè)鏈接:http://chinadenli.net/article34/pgjgse.html
成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供關(guān)鍵詞優(yōu)化、標(biāo)簽優(yōu)化、App設(shè)計(jì)、網(wǎng)頁(yè)設(shè)計(jì)公司、建站公司、微信小程序
聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請(qǐng)盡快告知,我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng),如需處理請(qǐng)聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時(shí)需注明來(lái)源: 創(chuàng)新互聯(lián)