Apache HTTP Server 版本2.2
Apache HTTP Server 版本2.2
| 說(shuō)明 | 使用純文本文件為認(rèn)證提供支持 |
|---|---|
| 狀態(tài) | 基本(B) |
| 模塊名 | authn_file_module |
| 源文件 | mod_authn_file.c |
| 兼容性 | 僅在 Apache 2.1 及以后的版本中可用 |
該模塊為認(rèn)證前端(mod_auth_digest和mod_auth_basic)使用純文本文件進(jìn)行用戶(hù)認(rèn)證提供支持。mod_authn_dbm模塊也提供類(lèi)似的功能。
使用mod_auth_basic或mod_auth_digest的時(shí)候，可以通過(guò)在AuthBasicProvider或AuthDigestProvider指令中使用file值調(diào)用該模塊。
| 說(shuō)明 | 設(shè)定一個(gè)含有認(rèn)證使用的用戶(hù)名/密碼列表的純文本文件 |
|---|---|
| 語(yǔ)法 | AuthUserFile file-path |
| 作用域 | directory, .htaccess |
| 覆蓋項(xiàng) | AuthConfig |
| 狀態(tài) | 基本(B) |
| 模塊 | mod_authn_file |
AuthUserFile指令設(shè)定一個(gè)純文本文件的名稱(chēng)，其中包含用于認(rèn)證的用戶(hù)名/密碼的列表，File-path是該文件的路徑。如果不是絕對(duì)路徑(也就是說(shuō)，如果不是以斜杠開(kāi)始的)，則是相對(duì)于ServerRoot的相對(duì)路徑。
用戶(hù)文件的每一行包含一個(gè)用戶(hù)名，后跟一個(gè)冒號(hào)，再跟一個(gè)加密過(guò)的密碼。如果文件中含有重復(fù)的用戶(hù)名，mod_authn_file模塊會(huì)用排在最前面的那行定義來(lái)驗(yàn)證該用戶(hù)的密碼。
在二進(jìn)制文件安裝包中附帶的(或者在"src/support"中)命令行工具htpasswd可以用來(lái)維護(hù)僅用于HTTP基本認(rèn)證的密碼文件。參閱手冊(cè)頁(yè)面以獲得更詳細(xì)的說(shuō)明。
以一個(gè)初始帳戶(hù)username創(chuàng)建一個(gè)密碼文件Filename 。它會(huì)提示輸入密碼：
htpasswd -c Filename username
增加或修改密碼文件Filename中的帳號(hào)username2 ：
htpasswd Filename username2
注意：搜索很大的文本文件是非常慢的；應(yīng)該使用AuthDBMUserFile來(lái)替代它。
如果使用HTTP摘要認(rèn)證，就不能使用htpasswd工具，而要使用htdigest工具。注意：不能在同一個(gè)文件中同時(shí)包含用于基本認(rèn)證和摘要認(rèn)證的用戶(hù)數(shù)據(jù)。
必須確保AuthUserFile文件存放在WEB服務(wù)器目錄之外，千萬(wàn)不要放在它所保護(hù)的目錄中，否則可能會(huì)被客戶(hù)端下載。