rubbos/app/apache2/manual/mod/mod_access.html.ja.utf8

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>mod_access - Apache HTTP サーバ</title>
   9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13 <body>
  14 <div id="page-header">
  15 <p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
  16 <p class="apache">Apache HTTP サーバ バージョン 2.0</p>
  17 <img alt="" src="../images/feather.gif" /></div>
  18 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  19 <div id="path">
  20 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP サーバ</a> &gt; <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> &gt; <a href="../">バージョン 2.0</a> &gt; <a href="./">モジュール</a></div>
  21 <div id="page-content">
  22 <div id="preamble"><h1>Apache モジュール mod_access</h1>
  23 <div class="toplang">
  24 <p><span>Available Languages: </span><a href="../en/mod/mod_access.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  25 <a href="../ja/mod/mod_access.html" title="Japanese">&nbsp;ja&nbsp;</a></p>
  26 </div>
  27 <div class="outofdate">This translation may be out of date. Check the
  28             English version for recent changes.</div>
  29 <table class="module"><tr><th><a href="module-dict.html#Description">説明:</a></th><td>クライアントのホスト名、IP アドレス、その他のクライアント
  30 のリクエストの特徴に基づいたアクセス制御機能を提供する</td></tr>
  31 <tr><th><a href="module-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
  32 <tr><th><a href="module-dict.html#ModuleIdentifier">モジュール識別子:</a></th><td>access_module</td></tr>
  33 <tr><th><a href="module-dict.html#SourceFile">ソースファイル:</a></th><td>mod_access.c</td></tr>
  34 <tr><th><a href="module-dict.html#Compatibility">互換性:</a></th><td>2.1 より前のバージョンのみで使用可能</td></tr></table>
  35 <h3>概要</h3>
  36
  37     <p><code class="module"><a href="../mod/mod_access.html">mod_access</a></code> により提供されるディレクティブはサーバの特定の部分への
  38     アクセスを制御するために <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code>, <code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code>, <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code>
  39     と <code><a href="core.html#accessfilename">.htaccess</a></code> ファイルで使用されます。クライアントのホスト名、IP
  40     アドレスや <a href="../env.html">環境変数</a>として取得された、その他のリクエストの特徴に基づいて
  41     アクセス制御を行なうことができます。<code class="directive"><a href="#allow">Allow</a></code> と
  42     <code class="directive"><a href="#deny">Deny</a></code> ディレクティブは
  43     どのようなクライアントにアクセスを
  44     許可する、しないかを指定するために使用されます。一方、
  45     <code class="directive"><a href="#order">Order</a></code> ディレクティブは
  46     デフォルトのアクセス状態と、
  47     <code class="directive"><a href="#allow">Allow</a></code> ディレクティブと
  48     <code class="directive"><a href="#deny">Deny</a></code>
  49     ディレクティブとのお互いへの影響の仕方を設定します。
  50     </p>
  51
  52     <p>ホストによるアクセス制限とパスワードによる認証を同時に
  53     行なうことが可能です。その場合、その二つの制限の関係を指定するために
  54     <code class="directive"><a href="../mod/core.html#satisfy">Satisfy</a></code>
  55     ディレクティブを使用します。</p>
  56
  57     <p>一般的には、アクセス制限ディレクティブはすべてのアクセスメソッド
  58     (<code>GET</code>, <code>PUT</code>, <code>POST</code> など)
  59     に適用されます。そして、ほとんどの場合これが望ましい動作です。
  60     しかし、<code class="directive"><a href="../mod/core.html#limit">&lt;Limit&gt;</a></code>
  61     セクションの中にディレクティブを書くことで、
  62     一部のメソッドにのみ制限をかけることもできます。</p>
  63 </div>
  64 <div id="quickview"><h3 class="directives">ディレクティブ</h3>
  65 <ul id="toc">
  66 <li><img alt="" src="../images/down.gif" /> <a href="#allow">Allow</a></li>
  67 <li><img alt="" src="../images/down.gif" /> <a href="#deny">Deny</a></li>
  68 <li><img alt="" src="../images/down.gif" /> <a href="#order">Order</a></li>
  69 </ul>
  70 <h3>参照</h3>
  71 <ul class="seealso">
  72 <li><code class="directive"><a href="../mod/core.html#satisfy">Satisfy</a></code></li>
  73 <li><code class="directive"><a href="../mod/core.html#require">Require</a></code></li>
  74 </ul></div>
  75
  76 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  77 <div class="directive-section"><h2><a name="Allow" id="Allow">Allow</a> <a name="allow" id="allow">ディレクティブ</a></h2>
  78 <table class="directive">
  79 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバのある領域にアクセスできるホストを制御する</td></tr>
  80 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code> Allow from
  81     all|<var>host</var>|env=<var>env-variable</var>
  82     [<var>host</var>|env=<var>env-variable</var>] ...</code></td></tr>
  83 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ, .htaccess</td></tr>
  84 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Limit</td></tr>
  85 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
  86 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_access</td></tr>
  87 </table>
  88
  89     <p><code class="directive">Allow</code> ディレクティブはどのホストが
  90     サーバのある領域をアクセスできるかに影響を与えます。
  91     アクセスはホスト名、IP アドレス、IP アドレスの範囲や、
  92     環境変数として取得された、その他のクライアントのリクエストの
  93     特徴によって制御することができます。</p>
  94
  95     <p>このディレクティブの最初の引数は常に <code>from</code> です。
  96     それに続く引数は三つの違った形式があります。<code>Allow from
  97     all</code> が指定されていれば、すべてのホストにアクセスを許可し、
  98     アクセス制限は下で説明されているように、
  99     <code class="directive"><a href="#deny">Deny</a></code>
 100     ディレクティブと <code class="directive"><a href="#order">Order</a></code>
 101     ディレクティブの設定で決まります。
 102     特定のホストやホスト群にのみサーバへのアクセスを許可するためには、
 103     以下のどれかの形式で <var>host</var> を指定することができます:</p>
 104
 105     <dl>
 106       <dt>ドメイン名 (の一部)</dt>
 107
 108       <dd>
 109       <div class="example"><h3>例:</h3><p><code>
 110         Allow from apache.org
 111       </code></p></div>
 112       <p>この文字列に合うか、これで終わる名前のホストのアクセスが許可されます。
 113       各部分が完全に合うものだけに適用されますので、上の例は
 114       <code>foo.apache.org</code> にはマッチしますが、
 115       <code>fooapache.org</code> にはマッチしません。
 116       この設定をすると、Apache は
 117       <code class="directive"><a href="../mod/core.html#hostnamelookups">HostnameLookups</a></code>
 118       の設定に関わらず、クライアントの IP アドレスに対して
 119       二重の DNS の逆引きを行ないます。まず IP アドレスに対して DNS の
 120       逆引きを行なってホスト名を得、そのホスト名に対して正引きを
 121       行ない、元の IP アドレスと一致するかを調べます。DNS の正引きと
 122       逆引きが無矛盾かつホスト名が一致するときにのみ
 123       アクセスが許可されます。</p></dd>
 124
 125       <dt>完全な IP アドレス</dt>
 126
 127       <dd>
 128       <div class="example"><h3>例:</h3><p><code>
 129         Allow from 10.1.2.3
 130       </code></p></div>
 131       <p>アクセスを許可する IP アドレスです。</p></dd>
 132
 133       <dt>IP アドレスの一部</dt>
 134
 135       <dd>
 136       <div class="example"><h3>例:</h3><p><code>
 137         Allow from 10.1
 138       </code></p></div>
 139       <p>サブネットの制限用の、IP
 140       アドレスの最初の一つから三つまでのバイトです。</p></dd>
 141
 142       <dt>ネットワーク/ネットマスク の対</dt>
 143
 144       <dd>
 145       <div class="example"><h3>例:</h3><p><code>
 146         Allow from 10.1.0.0/255.255.0.0
 147       </code></p></div>
 148       <p>ネットワーク a.b.c.d とネットマスク w.x.y.z です。
 149       より細粒度のサブネット制限用です。</p></dd>
 150
 151       <dt>ネットワーク/nnn CIDR 指定</dt>
 152
 153       <dd>
 154       <div class="example"><h3>例:</h3><p><code>
 155         Allow from 10.1.0.0/16
 156       </code></p></div>
 157       <p>ネットマスクが nnn の上位ビットが 1
 158       となっているものからなること以外は前のものと同じです。</p></dd>
 159     </dl>
 160
 161     <p>注: 最後の三つの例はまったく同じホストに合います。</p>
 162
 163
 164     <p>IPv6 アドレスと IPv6 のサブネットは以下のように指定できます:</p>
 165
 166     <div class="example"><p><code>
 167        Allow from 2001:db8::a00:20ff:fea7:ccea<br />
 168        Allow from 2001:db8::a00:20ff:fea7:ccea/10
 169     </code></p></div>
 170
 171     <p><code class="directive">Allow</code> ディレクティブの引数の三つ目の形式は、
 172     <a href="../env.html">環境変数</a>
 173     の存在によりアクセスの制御を行なえるようにするものです。
 174     <code>Allow from env=<var>env-variable</var></code>
 175     が指定されていると、環境変数 <var>env-variable</var>
 176     が存在した場合にリクエストはアクセスを許可されます。サーバは
 177     <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code>
 178     のディレクティブにより、クライアントのリクエスト
 179     の特徴に基づいて柔軟に環境変数を設定する機能を提供します。
 180     ですから、このディレクティブはクライアントの
 181     <code>User-Agent</code> (ブラウザの種類)、<code>Referer</code>
 182     や他の HTTP リクエストのヘッダフィールドなどに基づいて
 183     アクセス許可をするために使うことができます。
 184     </p>
 185
 186     <div class="example"><h3>例:</h3><p><code>
 187       SetEnvIf User-Agent ^KnockKnock/2\.0 let_me_in<br />
 188       &lt;Directory /docroot&gt;<br />
 189       <span class="indent">
 190         Order Deny,Allow<br />
 191         Deny from all<br />
 192         Allow from env=let_me_in<br />
 193       </span>
 194       &lt;/Directory&gt;
 195     </code></p></div>
 196
 197     <p>この場合、user-agent の文字列が <code>KnockKnock/2.0</code>
 198     で始まるブラウザのみがアクセスを許可され、
 199     他のものはアクセスを拒否されます。</p>
 200
 201 </div>
 202 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 203 <div class="directive-section"><h2><a name="Deny" id="Deny">Deny</a> <a name="deny" id="deny">ディレクティブ</a></h2>
 204 <table class="directive">
 205 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバがアクセスを拒否するホストを制御する</td></tr>
 206 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code> Deny from
 207     all|<var>host</var>|env=<var>env-variable</var>
 208     [<var>host</var>|env=<var>env-variable</var>] ...</code></td></tr>
 209 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ, .htaccess</td></tr>
 210 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Limit</td></tr>
 211 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 212 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_access</td></tr>
 213 </table>
 214     <p>このディレクティブはホスト名、IP
 215     アドレス、環境変数に基づいてサーバへのアクセスを制限します。
 216     <code class="directive">Deny</code> ディレクティブの引数は <code class="directive"><a href="#allow">Allow</a></code>
 217     ディレクティブとまったく同じです。</p>
 218
 219 </div>
 220 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 221 <div class="directive-section"><h2><a name="Order" id="Order">Order</a> <a name="order" id="order">ディレクティブ</a></h2>
 222 <table class="directive">
 223 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>デフォルトのアクセス可能な状態と、<code class="directive">Allow</code> と
 224 <code class="directive">Deny</code> が評価される順番を制御する</td></tr>
 225 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code> Order <var>ordering</var></code></td></tr>
 226 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>Order Deny,Allow</code></td></tr>
 227 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ, .htaccess</td></tr>
 228 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Limit</td></tr>
 229 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 230 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_access</td></tr>
 231 </table>
 232
 233     <p><code class="directive">Order</code> ディレクティブはデフォルトのアクセスの状態と
 234     <code class="directive"><a href="#allow">Allow</a></code> ディレクティブと
 235     <code class="directive"><a href="#deny">Deny</a></code>
 236     ディレクティブが評価される順番を制御します。
 237     <var>Ordering</var> は以下のどれかです。</p>
 238
 239     <dl>
 240       <dt><code>Deny,Allow</code></dt>
 241
 242       <dd><code class="directive"><a href="#deny">Deny</a></code> ディレクティブが
 243       <code class="directive"><a href="#allow">Allow</a></code>
 244       ディレクティブの前に評価されます。
 245       アクセスはデフォルトで許可されます。<code class="directive"><a href="#deny">Deny</a></code>
 246       ディレクティブに合わないか、<code class="directive"><a href="#allow">Allow</a></code>
 247       ディレクティブに合うクライアントはアクセスを許可されます。</dd>
 248
 249       <dt><code>Allow,Deny</code></dt>
 250
 251       <dd><code class="directive"><a href="#allow">Allow</a></code>
 252       ディレクティブが <code class="directive"><a href="#deny">Deny</a></code>
 253       ディレクティブの前に評価されます。
 254       アクセスはデフォルトで拒否されます。<code class="directive"><a href="#allow">Allow</a></code>
 255       ディレクティブに合わないか、<code class="directive"><a href="#deny">Deny</a></code>
 256       ディレクティブに合うクライアントはアクセスを拒否されます。
 257       </dd>
 258
 259       <dt><code>Mutual-failure</code></dt>
 260
 261       <dd><code class="directive"><a href="#allow">Allow</a></code> のリストに現れて、
 262       <code class="directive"><a href="#deny">Deny</a></code>
 263       のリストに現れないホストのみがアクセスを許可されます。
 264       この順番付けは <code>Order Allow,Deny</code> と同じ効果を持ち、
 265       その設定の方が好ましいために非推奨となっています。</dd>
 266     </dl>
 267
 268     <p>キーワードはコンマで分離することだけが可能です。
 269     間に<em>空白があってはいけません</em>。どの場合でも、<code class="directive"><a href="#allow">Allow</a></code> と
 270     <code class="directive"><a href="#deny">Deny</a></code> 文は
 271     全て評価されるということに注意してください。
 272     </p>
 273
 274     <p>以下の例では、apache.org
 275     ドメインのすべてのホストはアクセスを許可されます。
 276     他のすべてのホストはアクセスを拒否されます。</p>
 277
 278     <div class="example"><p><code>
 279       Order Deny,Allow<br />
 280       Deny from all<br />
 281       Allow from apache.org
 282     </code></p></div>
 283
 284     <p>次の例では、foo.apache.org サブドメインにあるホスト以外の、
 285     apache.org ドメインのすべてのホストがアクセスを許可されます。
 286     apache.org
 287     ドメインでないホストは、デフォルトの状態がアクセス拒否のため、
 288     サーバへのアクセスを拒否されます。</p>
 289
 290     <div class="example"><p><code>
 291       Order Allow,Deny<br />
 292       Allow from apache.org<br />
 293       Deny from foo.apache.org
 294     </code></p></div>
 295
 296     <p>一方、上の例の <code class="directive">Order</code> が <code>Deny,Allow</code>
 297     に変わっていれば、すべのホストにアクセスが許可されます。
 298     これは、設定ファイル中の実際の順番に関わらず、
 299     <code>Allow from apache.org</code> が最後に評価されて、
 300     <code>Deny from foo.apache.org</code> を上書きするからです。
 301     <code>apache.org</code>
 302     ドメインにないホストも、デフォルトの状態が <var>allow</var>
 303     に変化するために、アクセスを許可されます。
 304     </p>
 305
 306     <p><code class="directive">Order</code>
 307     ディレクティブはデフォルトのアクセスの状態に影響を与えるので、
 308     <code class="directive"><a href="#allow">Allow</a></code> ディレクティブと
 309     <code class="directive"><a href="#deny">Deny</a></code>
 310     ディレクティブが無くても、サーバのアクセスに影響を与えることができます。
 311     たとえば、</p>
 312
 313     <div class="example"><p><code>
 314       &lt;Directory /www&gt;<br />
 315       <span class="indent">
 316         Order Allow,Deny<br />
 317       </span>
 318       &lt;/Directory&gt;
 319     </code></p></div>
 320
 321     <p>はデフォルトのアクセス状態が <var>deny</var> になるため、
 322     <code>/www</code> ディレクトリへのすべてのアクセスを拒否します。
 323     </p>
 324
 325     <p><code class="directive">Order</code>
 326     ディレクティブはサーバの設定処理の各段階でだけ
 327     アクセスディレクティブの処理の順番を変更します。これは、たとえば、
 328     <code class="directive">Order</code> ディレクティブの設定に関わらず、
 329     <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> セクションの
 330     <code class="directive"><a href="#allow">Allow</a></code> ディレクティブや
 331     <code class="directive"><a href="#deny">Deny</a></code> ディレクティブは、
 332     <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> セクションや
 333     <code>.htaccess</code> ファイルの <code class="directive"><a href="#allow">Allow</a></code>
 334     ディレクティブや <code class="directive"><a href="#deny">Deny</a></code>
 335     ディレクティブよりも常に後に評価されるということを意味します。
 336     設定セクションのマージの詳細については、
 337     <a href="../sections.html">Directory,Location, Files
 338     セクションの動作方法</a> を参照してください。</p>
 339
 340 </div>
 341 </div>
 342 <div class="bottomlang">
 343 <p><span>Available Languages: </span><a href="../en/mod/mod_access.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 344 <a href="../ja/mod/mod_access.html" title="Japanese">&nbsp;ja&nbsp;</a></p>
 345 </div><div id="footer">
 346 <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 347 <p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div>
 348 </body></html>