模組 ngx_http_auth_basic_module

ngx_http_auth_basic_module 模組允許使用「HTTP 基本身份驗證」協定驗證使用者名稱和密碼，以限制對資源的存取。

也可以透過位址、透過子請求的結果或透過JWT來限制存取。同時透過位址和密碼限制存取由 satisfy 指令控制。

location / {
    auth_basic           "closed site";
    auth_basic_user_file conf/htpasswd;
}

語法	`auth_basic string \| off;`
預設值	auth_basic off;
上下文	`http`, `server`, `location`, `limit_except`

啟用使用「HTTP 基本身份驗證」協定驗證使用者名稱和密碼。指定的參數用作 realm。參數值可以包含變數 (1.3.10, 1.2.7)。特殊值 off 取消從先前的組態層級繼承的 auth_basic 指令的效果。

語法	`auth_basic_user_file file;`
預設值	—
上下文	`http`, `server`, `location`, `limit_except`

指定一個檔案，其中保留使用者名稱和密碼，格式如下

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

file 名稱可以包含變數。

支援以下密碼類型

使用 crypt() 函數加密；可以使用 Apache HTTP Server 發行版的 “htpasswd” 工具或 “openssl passwd” 命令產生；
使用 Apache 變體的 MD5 密碼演算法 (apr1) 雜湊；可以使用相同的工具產生；
由 RFC 2307 中描述的 “{scheme}data” 語法 (1.0.3+) 指定；目前實作的方案包括 PLAIN (範例之一，不應使用)、SHA (1.3.13) (純 SHA-1 雜湊，不應使用) 和 SSHA (加鹽 SHA-1 雜湊，某些軟體套件使用，特別是 OpenLDAP 和 Dovecot)。
新增對 SHA 方案的支援僅是為了幫助從其他 Web 伺服器進行移轉。它不應用於新密碼，因為它使用的未加鹽 SHA-1 雜湊容易受到彩虹表攻擊。