原文鏈接: 何曉東 博客
應用場景:大概是在內部網站需要外部用戶訪問到,同時不能給訪問者網站賬號權限,所以在 nginx 層面進行限制。例如外包項目,內部員工有賬號進行文檔的操作,外包員工沒有內部賬號,但需要讓他們能夠看到文檔,所以在 nginx 層面設置用戶驗證是最佳最簡單的選擇,多數情況下僱主方不會給外包員工開一個基礎訪問權限的賬號。
在 nginx 層面進行進行用戶認證的前置條件:需要有對應的密碼創建程序,如apache2-utils
(Debian,Ubuntu)或 httpd-tools
(RHEL / CentOS / Oracle Linux),不同操作系統是不同的軟件。
創建賬戶密碼文件
- 使用命令
sudo htpasswd -c /etc/apache2/.htpasswd user1
創建第一個賬戶,然後按下 Enter 鍵輸入密碼,同樣的命令,沒有-c
參數創建第二個用戶及密碼,-c
參數爲創建文件,在第二次及以後的命令中不需要再次創建文件。 - 確認一下文件及賬號信息生成成功,使用命令
cat /etc/apache2/.htpasswd
查看文件內容,應該爲賬號及加密後的密碼,如:user1:$apr1$/woC1jnP$KAh0SsVn5qeSMjTtn0E9Q0
等。
配置 nginx 進行 http 基礎用戶驗證
使用 auth_basic
指令指定設置受保護區域的名稱,此名稱會顯示在賬號密碼彈窗上,使用 auth_basic_user_file
指令設置帶有賬戶密碼信息的 .htpasswd
路徑。例如配置:
location /api {
auth_basic "Administrator's Area";
auth_basic_user_file /etc/apache2/.htpasswd;
}
此外,如果某個區塊不想繼承整個認證體系,可以在區塊內設置 auth_basic off
,即用戶認證關閉狀態。例如配置:
server {
...
auth_basic "Administrator's Area";
auth_basic_user_file conf/htpasswd;
location /public/ {
auth_basic off;
}
}
通過 ip 地址將認證與訪問限制相結合
HTTP基本認證可以通過IP地址有效地與訪問限制相結合。您可以實現至少兩種方案:
- 用戶需要通過身份驗證並且具有 ip 訪問權限
- 用戶需要通過身份驗證或者具有 ip 訪問權限
1.使用 allow
和 deny
指令來允許或限制指定 ip 的訪問,例如配置:
location /api {
#...
deny 192.168.1.2;
allow 192.168.1.1/24;
allow 127.0.0.1;
deny all;
}
在 192.168.1.2
地址以外的網絡,僅授予 192.168.1.1/24
的訪問權限。注意:allow
和 deny
指令將按照定義的順序應用。
2.通過ip 和 http 身份驗證將限制與 satisfy
指令相結合。如果將指令設置爲all
,則在客戶端滿足這兩個條件時授予訪問權限。如果將指令設置爲 any
,則如果客戶端滿足至少一個條件,則授予訪問權限,例如配置:
location /api {
#...
satisfy all;
deny 192.168.1.2;
allow 192.168.1.1/24;
allow 127.0.0.1;
deny all;
auth_basic "Administrator's Area";
auth_basic_user_file conf/htpasswd;
}
綜上可以組織成一個完整的例子:
http {
server {
listen 192.168.1.23:8080;
root /usr/share/nginx/html;
location /api {
api;
satisfy all;
deny 192.168.1.2;
allow 192.168.1.1/24;
allow 127.0.0.1;
deny all;
auth_basic "Administrator's area";
auth_basic_user_file /etc/apache2/.htpasswd;
}
}
}
最終效果如圖:
© 原創文章,翻譯自 官方文檔,部分做了語義調整。
老規矩,繼續推薦一些本人看過的精品課程,用我的二維碼購買享受八折優惠。 -> 去瞅瞅