cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder<?xml version="1.0" encoding="UTF-8" ?>
e9458b1a7a19a63aa4c179f9ab20f4d50681c168Jens Elkner<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder<?xml-stylesheet type="text/xsl" href="/style/manual.ja.xsl"?>
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder<!-- English Revision: 574882:1561569 (outdated) -->
98890889ffb2e8f6f722b00e265a211f13b5a861Corneliu-Claudiu Prodescu
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder<!--
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder Licensed to the Apache Software Foundation (ASF) under one or more
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder contributor license agreements. See the NOTICE file distributed with
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder this work for additional information regarding copyright ownership.
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder The ASF licenses this file to You under the Apache License, Version 2.0
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder (the "License"); you may not use this file except in compliance with
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder the License. You may obtain a copy of the License at
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder http://www.apache.org/licenses/LICENSE-2.0
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder Unless required by applicable law or agreed to in writing, software
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder distributed under the License is distributed on an "AS IS" BASIS,
4844d1fc69c65efa42828b171ca46dd1a8d33790Christian Maeder WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
4844d1fc69c65efa42828b171ca46dd1a8d33790Christian Maeder See the License for the specific language governing permissions and
5e676901d058a9d172a43e38b48d07651ebce91cChristian Maeder limitations under the License.
4844d1fc69c65efa42828b171ca46dd1a8d33790Christian Maeder-->
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder
5e676901d058a9d172a43e38b48d07651ebce91cChristian Maeder<modulesynopsis metafile="mod_authn_dbm.xml.meta">
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder<name>mod_authn_dbm</name>
c208973c890b8f993297720fd0247bc7481d4304Christian Maeder<description>DBM ファイルを用いたユーザ認証</description>
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder<status>Extension</status>
55c5e901b5c3466300009135585bc70bd576dcb6Christian Maeder<sourcefile>mod_authn_dbm.c</sourcefile>
2c3c120f3098198e8c235915c34026e19ad58805Christian Maeder<identifier>authn_dbm_module</identifier>
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder<compatibility>Apache 2.1 以降</compatibility>
4b358620557f0644fb8908b63bcd1ccec7c79c20Christian Maeder
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder<summary>
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder <p>本モジュールは <module>mod_auth_digest</module> や
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder <module>mod_auth_basic</module> といった認証フロントエンドに対して、
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder <dfn>dbm</dfn> パスワードファイル内からのユーザ検索による
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder ユーザ認証機能を提供します。似たような機能は <module>mod_authn_file</module>
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder でも提供されています。</p>
4b358620557f0644fb8908b63bcd1ccec7c79c20Christian Maeder
d58809391d5b755935766befb1726aed7c02c4d2Christian Maeder <p><module>mod_auth_basic</module> や <module>mod_auth_digest</module>
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder を使用する際には、このモジュールは
4b358620557f0644fb8908b63bcd1ccec7c79c20Christian Maeder <directive module="mod_auth_basic">AuthBasicProvider</directive> や
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder <directive module="mod_auth_digest">AuthDigestPrivider</directive>
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder で <code>dbm</code> と指定することで起動されます。</p>
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder</summary>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder<seealso><directive module="mod_authn_core">AuthName</directive></seealso>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder<seealso><directive module="mod_authn_core">AuthType</directive></seealso>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder<seealso>
4f3a84cb1b7e55ce38df8f4ac71d06b574b23cb1mscodescu <directive module="mod_auth_basic">AuthBasicProvider</directive>
b8d9955b50a96db03997a4946b07826be018b17cChristian Maeder</seealso>
b8d9955b50a96db03997a4946b07826be018b17cChristian Maeder<seealso>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder <directive module="mod_auth_digest">AuthDigestProvider</directive>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder</seealso>
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder
e49fd57c63845c7806860a9736ad09f6d44dbaedChristian Maeder<directivesynopsis>
60bf7f52638962c93ec43da9aad8cafc9f09c318Christian Maeder<name>AuthDBMUserFile</name>
720eeee7c9d8442093c8d05bed743193eee906e0Christian Maeder<description>認証用のユーザとパスワードのリストを保持している
60bf7f52638962c93ec43da9aad8cafc9f09c318Christian Maederデータベースファイル名を設定する</description>
4b358620557f0644fb8908b63bcd1ccec7c79c20Christian Maeder<syntax>AuthDBMUserFile <var>file-path</var></syntax>
4b358620557f0644fb8908b63bcd1ccec7c79c20Christian Maeder<contextlist><context>directory</context><context>.htaccess</context>
4b358620557f0644fb8908b63bcd1ccec7c79c20Christian Maeder</contextlist>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder<override>AuthConfig</override>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder<usage>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder <p><directive>AuthDBMUserFile</directive> ディレクティブは
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder 認証用のユーザとパスワードのリストを保持している DBM ファイルの
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder 名前を設定します。<var>File-path</var> はユーザファイルへの
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder 絶対パスです。</p>
cadfe9e161680261ac9d3aa5bb4a0bd4518a6164Christian Maeder
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder <p>ユーザファイルのキーはユーザ名です。ユーザに対して返される値は
ee190ade7f827254dc037a352c39338105eca6dcChristian Maeder 暗号化されたパスワードで、その後に、コロンに続いて任意のデータが
ee190ade7f827254dc037a352c39338105eca6dcChristian Maeder 続いていることもあります。コロンとその後のデータはサーバは
ee190ade7f827254dc037a352c39338105eca6dcChristian Maeder 無視します。</p>
ee190ade7f827254dc037a352c39338105eca6dcChristian Maeder
4b358620557f0644fb8908b63bcd1ccec7c79c20Christian Maeder <note type="warning"><title>セキュリティ</title>
d58809391d5b755935766befb1726aed7c02c4d2Christian Maeder <p><directive>AuthDBMUserFile </directive> は、
d58809391d5b755935766befb1726aed7c02c4d2Christian Maeder ウェブサーバのドキュメントツリーの外側に保管するようにしてください。
d58809391d5b755935766befb1726aed7c02c4d2Christian Maeder 保護しようとしているディレクトリ以下には
d58809391d5b755935766befb1726aed7c02c4d2Christian Maeder <strong>置かないで下さい</strong>。
d58809391d5b755935766befb1726aed7c02c4d2Christian Maeder そうしないとクライアントが <directive>AuthUserFile</directive> を
d58809391d5b755935766befb1726aed7c02c4d2Christian Maeder ダウンロードできてしまいます。</p>
d58809391d5b755935766befb1726aed7c02c4d2Christian Maeder </note>
c987b508fc8375617a8da1e183f0db56a21bd30dChristian Maeder
c987b508fc8375617a8da1e183f0db56a21bd30dChristian Maeder <p>重要な互換性に関する注意: apache module の <code>dbmopen</code> の実装は
c987b508fc8375617a8da1e183f0db56a21bd30dChristian Maeder 文字列が NULL で終わっていることに依存するのではなく、DBM データストラクチャ
d58809391d5b755935766befb1726aed7c02c4d2Christian Maeder のハッシュ値の文字列の長さを読み取ります。Netscape ウェブサーバなど、
d58809391d5b755935766befb1726aed7c02c4d2Christian Maeder アプリケーションの中には文字列が NULL で終わっていることに依存している
e49fd57c63845c7806860a9736ad09f6d44dbaedChristian Maeder ものがあります。ですから、異なるアプリケーション間での DBM ファイルの
e93366d209da6275613facbccff59ee0314a8b82Christian Maeder 使用に問題がある場合は、これが原因になっている可能性があります。</p>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder <p>Apache には <program>dbmmanage</program> という
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder perl スクリプトが含まれています。このプログラムを使ってこの
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder モジュールが使用する DBM フォーマットのパスワードファイルを作成したり
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder 更新したりすることができます。</p>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder</usage>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder</directivesynopsis>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder<directivesynopsis>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder<name>AuthDBMType</name>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder<description>パスワードを保存するために必要なデータベースファイルの種類を
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder設定する</description>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder<syntax>AuthDBMType default|SDBM|GDBM|NDBM|DB</syntax>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder<default>AuthDBMType default</default>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder<contextlist><context>directory</context><context>.htaccess</context>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder</contextlist>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder<override>AuthConfig</override>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder<usage>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder <p>パスワードを保存するために使用するデータベースファイルの種類を
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder 設定します。デフォルトのデータベースの種類はコンパイル時に決まります。
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder 他の種類のデータベースが使用可能かどうかも <a href="/install.html#dbm"
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder >コンパイル時の設定</a>に依存します。</p>
e49fd57c63845c7806860a9736ad09f6d44dbaedChristian Maeder
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder <p>パスワードファイルを作成するのに使用するプログラムが同じ種類のデータベースを
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder 使用するように設定することは非常に重要です。</p>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder</usage>
c1d06b3018b34ede2b3fb6c7fe2ad28cd5ce5b68Christian Maeder</directivesynopsis>
dc0ae81895771bff125b735927e1fd7f5c0b594bChristian Maeder
5e676901d058a9d172a43e38b48d07651ebce91cChristian Maeder</modulesynopsis>
4844d1fc69c65efa42828b171ca46dd1a8d33790Christian Maeder