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文件的格式。