Apache HTTP Server 版本2.2
Apache HTTP Server 版本2.2
htpasswd建立和更新用于基本認(rèn)證的存儲(chǔ)用戶(hù)名/密碼的文本文件。如果htpasswd不能讀寫(xiě)此文件，它返回一個(gè)出錯(cuò)代碼，而不做任何修改。
服務(wù)器上的資源可以被限制為僅允許由htpasswd建立的文件中的用戶(hù)所訪問(wèn)。此程序只能管理存儲(chǔ)在文本文件中的用戶(hù)名和密碼，但是它可以加密并顯示密碼信息，從而可以為其他數(shù)據(jù)存儲(chǔ)類(lèi)型所利用。要使用DBM數(shù)據(jù)庫(kù)，請(qǐng)參見(jiàn)dbmmanage 。
htpasswd使用專(zhuān)為Apache作了修改的MD5算法或系統(tǒng)函數(shù)crypt()加密密碼。htpasswd所管理的文件可以包含兩種類(lèi)型的密碼；有些用戶(hù)的密碼使用MD5加密的，而同一個(gè)文件中的其他用戶(hù)密碼則使用crypt()加密。
本手冊(cè)頁(yè)僅列出命令行參數(shù)，配置基本認(rèn)證的相關(guān)指令的細(xì)節(jié)請(qǐng)參見(jiàn)mod_auth_basic文檔。
htpasswd
[ -c ]
[ -m ]
[ -D ] passwdfile username
htpasswd -b
[ -c ]
[ -m |
-d |
-p |
-s ]
[ -D ] passwdfile username
password
htpasswd -n
[ -m |
-d |
-s |
-p ] username
htpasswd -nb
[ -m |
-d |
-s |
-p ] username password
-b-c-n 同時(shí)使用。-n-c 同時(shí)使用。-m-dcrypt()對(duì)密碼進(jìn)行加密。在Windows, Netware, TPF以外的平臺(tái)上這是默認(rèn)方法。雖然有可能在所有的平臺(tái)上被htpasswd支持，但是在Windows, Netware, TPF上，該方法不能被httpd所支持。-s-phtpasswd在所有平臺(tái)上都支持這種方法，但是httpd只能在Windows, Netware, TPF上支持這種方法。-Dusername存在于passwdfile中，則刪除該用戶(hù)。passwdfile-c 選項(xiàng)，若文件已存在則更新它，若不存在則創(chuàng)建它。usernamepassword-b 同時(shí)使用。htpasswd僅在用戶(hù)名和密碼被成功存入passwdfile或成功更新的情況下返回"0"。若訪問(wèn)文件發(fā)生錯(cuò)誤則返回"1"；若命令行語(yǔ)法錯(cuò)誤則返回"2"；若密碼驗(yàn)證失敗則返回"3"；若正在進(jìn)行中的操作被打斷則返回"4"；若值(username, filename, password, 計(jì)算結(jié)果)長(zhǎng)度超標(biāo)則返回"5"；若用戶(hù)名包含非法字符(參見(jiàn)限制)則返回"6"；若指定的文件不能被正確識(shí)別則返回"7"。
htpasswd /usr/local/etc/apache/.htpasswd-users jsmith
添加或修改用戶(hù)jsmith的密碼。密碼將被提示輸入。在Windows平臺(tái)上，密碼將使用Apache修改過(guò)的MD5算法進(jìn)行加密；在其它平臺(tái)上將使用crypt()進(jìn)行加密。如果指定的文件不存在，htpasswd將只返回一個(gè)錯(cuò)誤代碼，而不做其它任何事。
htpasswd -c /home/doe/public_html/.htpasswd jane
創(chuàng)建一個(gè)新文件并在其中添加一條用戶(hù)jane的記錄。密碼將被提示輸入。如果文件存在但是不能被讀取或?qū)懭�，則不會(huì)有任何記錄被修改，同時(shí)htpasswd將會(huì)顯示一個(gè)錯(cuò)誤信息并返回一個(gè)錯(cuò)誤代碼。
htpasswd -mb /usr/web/.htpasswd-all jones Pwd4Steve
將來(lái)自命令行的密碼(Pwd4Steve)使用MD5算法加密，并將其存入指定的文件。
Web密碼文件(比如由htpasswd管理)不應(yīng)當(dāng)存在于網(wǎng)絡(luò)空間中，即不能被客戶(hù)端有機(jī)會(huì)訪問(wèn)。
我們反對(duì)使用 -b 選項(xiàng)，因?yàn)槊艽a將以明文的形式出現(xiàn)在命令行中。
在Windows和MPE平臺(tái)上，用htdbm加密的密碼最大長(zhǎng)度是255字符。超出部分將被截?cái)唷?/p>
htdbm使用的MD5加密算法已經(jīng)被Apache修改過(guò)了，僅能夠被Apache識(shí)別，不能被其它Web服務(wù)器識(shí)別。
用戶(hù)最大長(zhǎng)度是255字節(jié)，并且不能包含冒號(hào)(:)。