### Apache HTTP Server Version 1.3

# Manual Page: htpasswd

    名称
         htpasswd - ユーザ認証ファイルの作成と更新

    書式
         htpasswd [ -c ] [ -m | -d | -s | -p ] passwdfile username
         htpasswd -b [ -c ] [ -m | -d | -s | -p ] passwdfile username
         password
         htpasswd -n [ -m | -d | -s | -p ] username
         htpasswd -nb [ -m | -d | -s | -p ] username password

    解説
         htpasswd は、HTTP ユーザの基本認証のためユーザ名と
           パスワードを記録するためのフラットファイルの作成と更新に使用されます。
           htpasswdが出力ファイルに書き込めない、また更新するために
           読みとることができないなど、ファイルにアクセスすることができない場合、
           エラーステータスを返し、変更を行いません。

           httpd Apache ウェブサーバは リソースの使用を htpasswd
           によって作成されるファイルにリストされたユーザだけに制限する
           ことができます。このプログラムはフラットファイルに記録された
           ユーザ名とパスワードの管理のみを行なうことができます。
           とは言っても、他のタイプのデータの記録のために使用しても
           パスワード情報を暗号化して表示することができます。
           DBM データベースを使用するためには dbmmanage を見てください。

           htpasswd は Apache 用に改造されたバージョンの MD5 かまたは
           システムの crypt() ルーチンを使用してパスワードを暗号化します。
           htpasswd で管理されたファイルは両方のタイプのパスワード
           を含むかもしれません; あるユーザレコードが MD5 で暗号化された
           パスワードであるのに対し、同じファイルの他のユーザは crypt() により
           暗号化されたパスワードであるかもしれません。

           このマニュアルページはコマンドラインの引数を挙げているだけです。
           httpd のユーザ認証設定に必要なディレクティブ の詳細は、
           Apache 配布物や <URL:http://www.apache.org/> で見つけることができる
           Apache マニュアルを参照してください。

    オプション
         -b   バッチモードの使用 すなわち 、プロンプトではなく
              コマンドラインからパスワードを得ます。パスワードが
              コマンドライン上で明確に目に見えるので、
              このオプションは極めて注意して使用されるべきです。

         -c   パスワードファイルを作成します。パスワードファイル
              がすでにある場合、上書きされて切り捨てられます。 このオプションは
              -n オプションと組み合わせることができません。

         -n   ファイルを更新するのではなく標準出力に結果を表示します。
              非テキストデータが含まれていて Apache に受け入れられる
              パスワードレコードを生成するのに有益です。
              このオプションはパスワードファイルの引数
              (通常は最初のもの)が省略されるので、コマンドラインの文法が
              切り替わります。
              -c オプションと組み合わせることはできません。

         -m   パスワードに Apache 用に改造された MD5 アルゴリズムを使用
              します。このアルゴリズムにより暗号化されたパスワードは、
              Apache 1.3.9 またはそれ以降が動いているあらゆるプラット
              ホーム (Windows, Unix, BeOS, その他) に移植可能です。
              Windows と TPF ではこのフラグがデフォルトです。

         -d   パスワードに crypt() 暗号化を使用します。Windows と TPF
              以外のすべてのプラットフォームでデフォルトです。
              おそらくすべてのプラットフォームでの htpasswd
              によりサポートされますが、Windows と TPF の httpd
              サーバによるサポートはありません。

         -s   パスワードに SHA 暗号化を使用します。LDAP ディレクトリ
              変換フォーマット (ldif) を使用する Netscape サーバ
              からの/への 移行を容易にします。

         -p   プレーンテキストパスワードを使用します。 htpasswd
              がすべてのプラットフォームでの作成をサポートしても httpd
              デーモンは Windows と TPF 上では、プレーンテキストのパスワード
              のみ受付けるでしょう。

         passwdfile
              ユーザ名とパスワードが含まれているファイル名です。
              もし -c が与えられた場合、ファイルが存在しないならば
              ファイルを作成し、また存在しているなら、上書きされます。

         username
              passwdfile に作成または更新するユーザ名です。
              username が存在しない場合はエントリを追加します。
              存在する場合にはパスワードを変更します。

         password
              ファイルに暗号化されて記録されるプレーンテキストの
              パスワードです。 -b フラグでのみ使用されます。

    終了ステータス
         ユーザ名とパスワードが首尾よく passwdfile に追加または更新
         された場合、htpasswd はゼロステータス ("真") を返します。
         htpasswd は、ファイルアクセスの問題に遭遇した場合は 1、
         コマンドラインに関する文法の問題があった場合は 2、
         対話式でパスワードを入力した際に確認のエントリがマッチしなかった場合は 3、
         操作が中断された場合は 4、(ユーザ名、ファイル名、パスワード、または
         最後に計算されたレコード) において値が長すぎる場合は 5、
         ユーザ名に不正な文字が含まれている(RESTRICTIONS
         セクションを見てください) 場合は 6 を返します。

    例
         htpasswd /usr/local/etc/apache/.htpasswd-users jsmith

              ユーザ jsmith のパスワードを追加または修正します。
              ユーザはパスワードの入力を促されます。Windows システム上で
              実行された場合、パスワードは Apache MD5 アルゴリズムを使用して
              暗号化されるでしょう。他の場合は、システムの crypt()
              ルーチンが使用されるでしょう。ファイルが存在しない場合、
              htpasswd はエラーを返す以外には何もしないでしょう。

         htpasswd -c /home/doe/public_html/.htpasswd jane

              新しいファイルを作成し、ユーザ jane のレコードを記録します。
              ユーザはパスワードの入力を促されます。
              ファイルが存在するけれど読めないまたは書き込みができない場合は
              変更されず、htpasswd はメッセージを表示して
              エラーステータスを返すでしょう。

         htpasswd -mb /usr/web/.htpasswd-all jones Pwd4Steve

              MD5 アルゴリズムを使ってコマンドラインからのパスワード
              (Pwd4Steve) を暗号化し、指定されたファイルに記録します。

    セキュリティの重要性
           htpasswd によって管理されるようなウェブパスワードファイル
           はウェブサーバの URI の場所内にあるべきではありません。--
           すなわち、ウェブブラウザによって呼び出し可能とするべきではありません。

           -b オプションの使用する方法は、暗号化されていないパスワードが
           コマンドラインに現れたときから抑止されます。

    制限
           Windows と MPE プラットフォームで htpasswd で暗号化された
           パスワードは 255 文字の長さだけに制限されています。
           より長いパスワードは 255 文字に切り捨てられるでしょう。

           htpasswd によって使用される MD5 アルゴリズムは Apache
           ソフトウェアに特有で、それを用いて暗号化されたパスワードは
           他のウェブサーバでは使用できないでしょう。

           ユーザ名は 255 バイトに制限され、キャラクタ ':' を含まれな
           いかもしれません。

    関連項目
           SHA1 サポートの httpd(8) とスクリプトは配布物と共に
           出来上がります。

### Apache HTTP Server Version 1.3