htpasswd - 管理用于基本认证的用户文件 - Apache HTTP Server Version 2.2 中文文档

htpasswd - 管理用于基本认证的用户文件

htpasswd建立和更新用于基本认证的存储用户名/密码的文本文件。如果htpasswd不能读写此文件，它返回一个出错代码，而不做任何修改。

服务器上的资源可以被限制为仅允许由htpasswd建立的文件中的用户所访问。此程序只能管理存储在文本文件中的用户名和密码，但是它可以加密并显示密码信息，从而可以为其他数据存储类型所利用。要使用DBM数据库，请参见dbmmanage 。

htpasswd使用专为Apache作了修改的MD5算法或系统函数crypt()加密密码。htpasswd所管理的文件可以包含两种类型的密码；有些用户的密码使用MD5加密的，而同一个文件中的其他用户密码则使用crypt()加密。

本手册页仅列出命令行参数，配置基本认证的相关指令的细节请参见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: 创建passwdfile文件。如果passwdfile已经存在，那么将被清空并改写。该选项不能和 -n 同时使用。
-n: 在标准输出上显示结果而不是更新文件。用于生成可以为Apache非文本输出存储格式所接受的密码记录。这个选项改变了命令行语法，因为passwdfile参数(通常是第一个)被忽略了。该选项不能和 -c 同时使用。
-m: 使用MD5加密密码。在Windows, Netware, TPF上这是默认方法。
-d: 使用crypt()对密码进行加密。在Windows, Netware, TPF以外的平台上这是默认方法。虽然有可能在所有的平台上被htpasswd支持，但是在Windows, Netware, TPF上，该方法不能被httpd所支持。
-s: 使用 SHA 对密码进行加密。这种方法易于通过LDAP目录交换格式和Netscape server进行交换。
-p: 使用明文密码(不加密)。虽然htpasswd在所有平台上都支持这种方法，但是httpd只能在Windows, Netware, TPF上支持这种方法。
-D: 如果username存在于passwdfile中，则删除该用户。
passwdfile: 包含用户名和密码的文本文件的名称。如果使用了 -c 选项，若文件已存在则更新它，若不存在则创建它。
username: 在passwdfile中添加或更新记录。若username不存在则添加一条记录，若存在则更新其密码。
password: 将被加密并存储到文件中的明文密码。必须和 -b 同时使用。

htpasswd仅在用户名和密码被成功存入passwdfile或成功更新的情况下返回"0"。若访问文件发生错误则返回"1"；若命令行语法错误则返回"2"；若密码验证失败则返回"3"；若正在进行中的操作被打断则返回"4"；若值(username, filename, password, 计算结果)长度超标则返回"5"；若用户名包含非法字符(参见限制)则返回"6"；若指定的文件不能被正确识别则返回"7"。