dbmmanage - 管理DBM格式的用戶認證文件 · Apache 2.2 中文官方文檔

# dbmmanage - 管理DBM格式的用戶認證文件 `dbmmanage`建立和更新存儲用戶名和密碼的DBM格式的文件，以用于`mod_authn_dbm`對HTTP用戶進行基本認證。Apache HTTP服務器上的有效資源可以被限制為僅允許由`dbmmanage`建立的文件中的用戶所訪問。此程序僅用于用戶名是存儲在一個DBM文件中的情況下，如果使用文本數據庫，請參見`htpasswd` 。本手冊頁僅列出命令行參數，配置用戶認證的相關信息請參見`認證、授權、訪問控制`文檔。 ## 語法 `**dbmmanage** [ encoding ] filename add|adduser|check|delete|update username [ encpasswd [ group[,group...] [ comment ] ] ]` `**dbmmanage** filename view [ username ]` `**dbmmanage** filename import` ## 選項 `filename` DBM格式文件的文件名。一般不帶 `.db`, `.pag`, `.dir` 后綴。 `username` 操作所針對的用戶。username中不能有冒號(`:`)。 `encpasswd` 這是已經加密的密碼，用于`update`和`add`命令。使用一個連字符(`-`)可以顯示輸入密碼的提示，然后輸入。另外，在用于`update`命令時，使用一個句號(`.`)可以保持原有密碼不變。 `group` 用戶所屬的組名，組名中不能有冒號(`:`)。如果不希望指定該用戶所屬的組，可以使用一個連字符(`-`)，但是需要填寫comment項。另外，在用于`update`命令時，使用一個句號(`.`)可以保持原來所屬的組不變。 `comment` 這是對該用戶的說明，如真實姓名、郵件地址之類。服務器本身并不使用此信息。 ### 編碼 `-d` crypt 加密(在Windows和Netware以外平臺上的默認值) `-m` MD5 加密(在Windows和Netware平臺上的默認值) `-s` SHA1 加密 `-p` 純文本(_不推薦_) ### 命令 `add` 在filename中增加一個包含了username和已加密密碼encpasswd的項。 ``` dbmmanage passwords.dat add rbowen foKntnEF3KSXA ``` `adduser` 要求輸入密碼，然后在filename中增加一個username項。 ``` dbmmanage passwords.dat adduser krietz ``` `check` 要求輸入密碼，然后檢查filename中是否存在username并且其密碼與輸入的相同。 ``` dbmmanage passwords.dat check rbowen ``` `delete` 在filename中刪除username項。 ``` dbmmanage passwords.dat delete rbowen ``` `import` 從`STDIN`讀取 `username:password` 的信息(每行一對)，然后增加到filename中。其中的密碼必須是已加密的。 `update` 類似`adduser`命令，但是它可以確認username已經存在于filename中。 ``` dbmmanage passwords.dat update rbowen ``` `view` 僅顯示DBM文件的內容。如果指定了username則僅顯示該用戶的信息。 ``` dbmmanage passwords.dat view ``` ## Bugs 注意，實際上存在有許多不同的DBM文件格式，你的系統中也可能存在不止一種的支持庫，常見的有SDBM, NDBM, GDBM, Berkeley DB 2 。麻煩的是，所有這些庫都使用了不同的文件格式，因而你必須確保filename所采用的格式能夠為`dbmmanage`所接受。目前，`dbmmanage`無法自己確定所查找的文件的DBM類型。如果使用了錯誤的格式，則簡單返回nothing ，或者建立一個不同名稱的不同的DBM文件，而最壞的情況是，在試圖寫入這個文件時，可能會破壞該DBM文件。 `dbmmanage`有一個DBM格式參數選擇列表，在程序前部由 `@AnyDBM::ISA` 數組定義。由于我們更喜歡 Berkeley DB 2 格式，`dbmmanage`查找系統庫的順序是：Berkeley DB 2, NDBM, GDBM, SDBM 。`dbmmanage`會使用第一個找到的庫來處理所有的DBM文件操作。此順序與perl中標準的 `@AnyDBM::ISA` 的順序略微不同，所以，如果要使用任何其他工具來管理DBM文件，則必須確保該工具是按此順序處理的。在用其他語言比如C的程序來處理這些文件時，也要考慮這一點。在大多數Unix系統中，都可以用`file`程序來查看DBM文件的格式。