granicus.if.org Git - apache/blob - docs/manual/mod/mod_dav.xml.ja

   1 <?xml version="1.0" encoding="UTF-8" ?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
   4 <!-- English Revision: 659902:1330980 (outdated) -->
   5
   6 <!--
   7  Licensed to the Apache Software Foundation (ASF) under one or more
   8  contributor license agreements.  See the NOTICE file distributed with
   9  this work for additional information regarding copyright ownership.
  10  The ASF licenses this file to You under the Apache License, Version 2.0
  11  (the "License"); you may not use this file except in compliance with
  12  the License.  You may obtain a copy of the License at
  13
  14      http://www.apache.org/licenses/LICENSE-2.0
  15
  16  Unless required by applicable law or agreed to in writing, software
  17  distributed under the License is distributed on an "AS IS" BASIS,
  18  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  19  See the License for the specific language governing permissions and
  20  limitations under the License.
  21 -->
  22
  23 <modulesynopsis metafile="mod_dav.xml.meta">
  24
  25 <name>mod_dav</name>
  26 <description>分散オーサリングとバージョン管理
  27 (<a href="http://www.webdav.org/">WebDAV</a>) 機能</description>
  28 <status>Extension</status>
  29 <sourcefile>mod_dav.c</sourcefile>
  30 <identifier>dav_module</identifier>
  31
  32 <summary>
  33     <p>このモジュールはクラス 1 とクラス 2 の
  34     <a href="http://www.webdav.org">WebDAV</a>
  35     ('ウェブベースの分散オーサリングとバージョン管理')
  36     機能を Apache に提供します。
  37     この HTTP プロトコルの拡張により、リモートのウェブサーバ上にある
  38     リソースやコレクションを
  39     作成、移動、複製、削除できるようになります。</p>
  40 </summary>
  41 <seealso><directive module="mod_dav_fs">DavLockDB</directive></seealso>
  42 <seealso><directive module="core">LimitXMLRequestBody</directive></seealso>
  43 <seealso><a href="http://www.webdav.org">WebDAV Resources</a></seealso>
  44
  45 <section id="example"><title>Enabling WebDAV</title>
  46     <p>mod_dav を有効にするには、<code>httpd.conf</code>
  47     ファイル中のコンテナに次を加えます:</p>
  48
  49     <example>Dav On</example>
  50
  51     <p>これは DAV ファイルシステムプロバイダを有効にします。DAV
  52     ファイルシステムプロバイダは <module>mod_dav_fs</module>
  53     モジュールで実装されています。ですから、このモジュールはコンパイル時に
  54     サーバに組み込まれているか、あるいは
  55     <directive module="mod_so">LoadModule</directive>
  56     を使用して実行時にロードされている必要があります。</p>
  57
  58     <p>さらに、DAV ロックデータベースの場所が
  59     <directive module="mod_dav_fs">DavLockDB</directive> ディレクティブを使って
  60     <code>httd.conf</code> ファイルのグローバルセクションに指定されている
  61     必要があります。</p>
  62
  63     <example>
  64       DavLockDB /usr/local/apache2/var/DavLock
  65     </example>
  66
  67     <p>ロックデータベースファイルのあるディレクトリは Apache が実行されている
  68     <directive module="mpm_common">User</directive> と <directive
  69     module="mpm_common" >Group</directive> に書き込み権限がある必要があります。</p>
  70
  71     <p><directive module="core" type="section">Limit</directive>
  72     節を <directive module="core" type="section">Location</directive>
  73     ディレクティブ内部に追加して、DAV が有効な場所への
  74     アクセスを制限することもできます。DAV クライアントが
  75     一度のリクエストで送信できる最大バイト数を指定したいときは、
  76     <directive module="core">LimitXMLRequestBody</directive>
  77     ディレクティブを使用する必要があります。「通常の」
  78     <directive module="core">LimitRequestBody</directive>
  79     ディレクティブは DAV リクエストに対しては効力を持ちません。</p>
  80
  81     <example><title>完全な例</title>
  82       DavLockDB /usr/local/apache2/var/DavLock<br />
  83       <br />
  84       &lt;Directory /usr/local/apache2/htdocs/foo&gt;<br />
  85       <indent>
  86         Order Allow,Deny<br />
  87         Allow from all<br />
  88         Dav On<br />
  89         <br />
  90         AuthType Basic<br />
  91         AuthName DAV<br />
  92         AuthUserFile user.passwd<br />
  93         <br />
  94         &lt;LimitExcept GET POST OPTIONS&gt;<br />
  95         <indent>
  96           Require user admin<br />
  97         </indent>
  98         &lt;/LimitExcept&gt;<br />
  99       </indent>
 100       &lt;/Directory&gt;<br />
 101     </example>
 102
 103 </section>
 104
 105 <section id="security"><title>セキュリティの問題</title>
 106
 107     <p>DAV のアクセスメソッドは遠隔クライアントがサーバのファイルを
 108     操作することを可能にしますので、 <module>mod_dav</module> を使用する
 109     前に、サーバが安全であることを特に注意して確認しなければなりません。</p>
 110
 111     <p>サーバ上の DAV が使用可能になっている場所はすべて認証で保護してください。
 112     HTTP 基本認証の使用は推奨できません。少なくとも
 113     <module>mod_auth_digest</module> モジュールで提供される HTTP
 114     ダイジェスト認証を用いるべきです。WebDAV クライアントのほとんどは
 115     この認証方法に対応しています。代わりに、<a href="../ssl/">SSL</a> が
 116     有効なコネクションを通した基本認証を使うこともできます。</p>
 117
 118     <p><module>mod_dav</module> がファイルを操作できるようにするためには、
 119     管理下のディレクトリとファイルとに Apache が実行されている <directive
 120     module="mpm_common">User</directive> と <directive
 121     module="mpm_common">Group</directive> で書き込み可能である必要があります。
 122     新しく作成されるファイルもこの <directive module="mpm_common">User</directive>
 123     と <directive module="mpm_common">Group</directive> に所有される
 124     ことになります。この理由から、そのアカウントへのアクセスを制御することは
 125     重要です。DAV リポジトリは Apache 専用のものだとみなされています。
 126     Apache 以外の方法でファイルを修正すること (例えば FTP やファイルシステム
 127     用のツールなどを使って) は許可されていません。</p>
 128
 129     <p><module>mod_dav</module> はいろいろな種類のサービス拒否攻撃にさらされる
 130     かもしれません。<directive
 131     module="core">LimitXMLRequestBody</directive> ディレクティブを使うと
 132     大きな DAV リクエストを解析するときに消費されるメモリの量を制限することが
 133     できます。<directive
 134     module="mod_dav">DavDepthInfinity</directive> ディレクティブは
 135     <code>PROPFIND</code> リクエストが巨大リポジトリで大量のメモリを消費するのを
 136     防ぐことができます。他のサービス拒否攻撃には単純に使用可能なディスク領域を
 137     多くの大きなファイルで埋めてしまうんものがあります。これを直接防ぐ方法は
 138     Apache にはありませんので、信用できないユーザに DAV アクセスを提供するのは
 139     避けた方が良いでしょう。</p>
 140 </section>
 141
 142 <section id="complex"><title>複雑な設定</title>
 143
 144     <p>よくある要求に、<module>mod_dav</module> を使って動的なファイル
 145     (PHP スクリプト、CGI スクリプトなど) を操作したいというものがあります。
 146     これの実現は、<code>GET</code> リクエストはスクリプトの内容をダウンロードさせる
 147     代わりに、スクリプトを常に実行させてしまうので難しくなっています。
 148     これを回避する方法には、二つの違う URL を同じコンテンツにマップし、
 149     一つはスクリプトを実行させ、もう一つはダウンロードさせたり、DAV から
 150     操作されたりするように設定するというものがあります。</p>
 151
 152 <example>
 153 Alias /phparea /home/gstein/php_files<br />
 154 Alias /php-source /home/gstein/php_files<br />
 155 &lt;Location /php-source&gt;
 156 <indent>
 157     DAV On<br />
 158     ForceType text/plain<br />
 159 </indent>
 160 &lt;/Location&gt;
 161 </example>
 162
 163     <p>この設定により、<code>http://example.com/phparea</code> を PHP スクリプトの
 164     出力をアクセスするために使うことができ、
 165     <code>http://example.com/php-source</code> を DAV クライアントによる
 166     が操作のために使うことができます。</p>
 167 </section>
 168
 169 <directivesynopsis>
 170 <name>Dav</name>
 171 <description>WebDAV HTTP メソッドを有効にします</description>
 172 <syntax>Dav On|Off|<var>provider-name</var></syntax>
 173 <default>Dav Off</default>
 174 <contextlist><context>directory</context></contextlist>
 175
 176 <usage>
 177     <p>与えられたコンテナで WebDAV HTTP メソッドが使えるようにするには
 178     次のようにします。</p>
 179
 180     <example>
 181       &lt;Location /foo&gt;<br />
 182       <indent>
 183         Dav On<br />
 184       </indent>
 185       &lt;/Location&gt;
 186     </example>
 187
 188     <p><code>On</code> という指定は実際には <module>mod_dav_fs</module>
 189     で提供されているデフォルトのプロバイダ、<code>filesystem</code>
 190     へのエイリアスになっています。一度あるロケーションで DAV
 191     を有効にした後は、そのサブロケーションで<em>無効化することはできない</em>
 192     ということに注意してください。完全な設定例は<a
 193     href="#example">上記のセクション</a> をご覧下さい。</p>
 194
 195     <note type="warning">
 196       サーバのセキュリティが確保できるまで WebDAV を有効にしないでください。
 197       そうしなければ誰でもそのサーバでファイルを配布することができるように
 198       なってしまいます。
 199     </note>
 200 </usage>
 201 </directivesynopsis>
 202
 203 <directivesynopsis>
 204 <name>DavMinTimeout</name>
 205 <description>サーバが DAV リソースのロックを維持する最小時間です。
 206 </description>
 207 <syntax>DavMinTimeout <var>seconds</var></syntax>
 208 <default>DavMinTimeout 0</default>
 209 <contextlist><context>server config</context><context>virtual host</context>
 210 <context>directory</context></contextlist>
 211
 212 <usage>
 213     <p>クライアントが DAV リソースロックを要求した場合、
 214     ロックがサーバによって自動的に解除されるまでの時間を
 215     同時に指定することができます。この値は単なるリクエストであって、
 216     サーバはこれを無視することもできますし、
 217     任意の値をクライアントに通知することもできます。</p>
 218
 219     <p>クライアントに戻すロックタイムアウトの最小時間を、
 220     秒で、指定するために <directive>DavMinTimeout</directive>
 221     ディレクティブを使います。
 222     マイクロソフトのウェブフォルダのデフォルトでは 120 秒ですが；
 223     ネットワークの遅延のせいでクライアントがロックを失うのを減らすために、
 224     <directive>DavMinTimeout</directive> を使って
 225     これをもっと大きな値 (例えば 600 秒) に上書きできます。</p>
 226
 227     <example><title>例</title>
 228       &lt;Location /MSWord&gt;<br />
 229       <indent>
 230         DavMinTimeout 600<br />
 231       </indent>
 232       &lt;/Location&gt;
 233     </example>
 234 </usage>
 235 </directivesynopsis>
 236
 237 <directivesynopsis>
 238 <name>DavDepthInfinity</name>
 239 <description>PROPFIND, Depth: Infinity リクエストを許可します</description>
 240 <syntax>DavDepthInfinity on|off</syntax>
 241 <default>DavDepthInfinity off</default>
 242 <contextlist><context>server config</context><context>virtual host</context>
 243 <context>directory</context></contextlist>
 244
 245 <usage>
 246     <p>'Depth: Infinity' を含んでいる
 247     <code>PROPFIND</code> リクエストを処理できるようにするには、
 248     <directive>DavDepthInfinity</directive>
 249     ディレクティブを使います。このタイプのリクエストは
 250     denial-of-service アタックとなりうるので、
 251     デフォルトでは許可されていません。</p>
 252 </usage>
 253 </directivesynopsis>
 254
 255 </modulesynopsis>
 256
 257