mod_access.xml.ja

Apache HTTP Server 是一个功能强大的灵活的与HTTP/1.1相兼容的web服务器.这里给出的是Apache HTTP服务器的源码。

<?xml version="1.0" encoding="iso-2022-jp"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
<!-- English Revision: 151405 -->

<!--
 Copyright 2002-2004 The Apache Software Foundation

 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-->

<modulesynopsis metafile="mod_access.xml.meta">

<name>mod_access</name> 
<description>$B%/%i%$%"%s%H$N%[%9%HL>!"(BIP $B%"%I%l%9!"$=$NB>$N%/%i%$%"%s%H(B
$B$N%j%/%(%9%H$NFCD'$K4p$E$$$?%"%/%;%9@)8f5!G=$rDs6!$9$k(B</description>

<status>Base</status>
<sourcefile>mod_access.c</sourcefile>
<identifier>access_module</identifier>
<compatibility>2.1 $B$h$jA0$N%P!<%8%g%s$N$_$G;HMQ2DG=(B</compatibility>

<summary>
    <p><module>mod_access</module> $B$K$h$jDs6!$5$l$k%G%#%l%/%F%#%V$O%5!<%P$NFCDj$NItJ,$X$N(B
    $B%"%/%;%9$r@)8f$9$k$?$a$K(B <directive module="core" type="section"
    >Directory</directive>, <directive module="core"
    type="section">Files</directive>, <directive module="core"
    type="section">Location</directive>
    $B$H(B <code><a href="core.html#accessfilename">.htaccess</a
    ></code> $B%U%!%$%k$G;HMQ$5$l$^$9!#%/%i%$%"%s%H$N%[%9%HL>!"(BIP
    $B%"%I%l%9$d(B <a href="../env.html">$B4D6-JQ?t(B</a
    >$B$H$7$F<hF@$5$l$?!"$=$NB>$N%j%/%(%9%H$NFCD'$K4p$E$$$F(B
    $B%"%/%;%9@)8f$r9T$J$&$3$H$,$G$-$^$9!#(B<directive
    module="mod_access">Allow</directive> $B$H(B
    <directive module="mod_access">Deny</directive> $B%G%#%l%/%F%#%V$O(B
    $B$I$N$h$&$J%/%i%$%"%s%H$K%"%/%;%9$r(B
    $B5v2D$9$k!"$7$J$$$+$r;XDj$9$k$?$a$K;HMQ$5$l$^$9!#0lJ}!"(B
    <directive module="mod_access">Order</directive> $B%G%#%l%/%F%#%V$O(B
    $B%G%U%)%k%H$N%"%/%;%9>uBV$H!"(B
    <directive module="mod_access">Allow</directive> $B%G%#%l%/%F%#%V$H(B
    <directive module="mod_access">Deny</directive>
    $B%G%#%l%/%F%#%V$H$N$*8_$$$X$N1F6A$N;EJ}$r@_Dj$7$^$9!#(B
    </p>

    <p>$B%[%9%H$K$h$k%"%/%;%9@)8B$H%Q%9%o!<%I$K$h$kG'>Z$rF1;~$K(B
    $B9T$J$&$3$H$,2DG=$G$9!#$=$N>l9g!"$=$NFs$D$N@)8B$N4X78$r;XDj$9$k$?$a$K(B
    <directive module="core">Satisfy</directive>
    $B%G%#%l%/%F%#%V$r;HMQ$7$^$9!#(B</p>

    <p>$B0lHLE*$K$O!"%"%/%;%9@)8B%G%#%l%/%F%#%V$O$9$Y$F$N%"%/%;%9%a%=%C%I(B
    (<code>GET</code>, <code>PUT</code>, <code>POST</code> $B$J$I(B)
    $B$KE,MQ$5$l$^$9!#$=$7$F!"$[$H$s$I$N>l9g$3$l$,K>$^$7$$F0:n$G$9!#(B
    $B$7$+$7!"(B<directive module="core" type="section">Limit</directive>
    $B%;%/%7%g%s$NCf$K%G%#%l%/%F%#%V$r=q$/$3$H$G!"(B
    $B0lIt$N%a%=%C%I$K$N$_@)8B$r$+$1$k$3$H$b$G$-$^$9!#(B</p>
</summary>

<seealso><directive module="core">Satisfy</directive></seealso>
<seealso><directive module="core">Require</directive></seealso>

<directivesynopsis>
<name>Allow</name>
<description>$B%5!<%P$N$"$kNN0h$K%"%/%;%9$G$-$k%[%9%H$r@)8f$9$k(B</description>
<syntax> Allow from
    all|<var>host</var>|env=<var>env-variable</var>
    [<var>host</var>|env=<var>env-variable</var>] ...</syntax>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>Limit</override>

<usage>

    <p><directive>Allow</directive> $B%G%#%l%/%F%#%V$O$I$N%[%9%H$,(B
    $B%5!<%P$N$"$kNN0h$r%"%/%;%9$G$-$k$+$K1F6A$rM?$($^$9!#(B
    $B%"%/%;%9$O%[%9%HL>!"(BIP $B%"%I%l%9!"(BIP $B%"%I%l%9$NHO0O$d!"(B
    $B4D6-JQ?t$H$7$F<hF@$5$l$?!"$=$NB>$N%/%i%$%"%s%H$N%j%/%(%9%H$N(B
    $BFCD'$K$h$C$F@)8f$9$k$3$H$,$G$-$^$9!#(B</p> 

    <p>$B$3$N%G%#%l%/%F%#%V$N:G=i$N0z?t$O>o$K(B <code>from</code> $B$G$9!#(B
    $B$=$l$KB3$/0z?t$O;0$D$N0c$C$?7A<0$,$"$j$^$9!#(B<code>Allow from
    all</code> $B$,;XDj$5$l$F$$$l$P!"$9$Y$F$N%[%9%H$K%"%/%;%9$r5v2D$7!"(B
    $B%"%/%;%9@)8B$O2<$G@bL@$5$l$F$$$k$h$&$K!"(B
    <directive module="mod_access">Deny</directive>
    $B%G%#%l%/%F%#%V$H(B <directive module="mod_access">Order</directive>
    $B%G%#%l%/%F%#%V$N@_Dj$G7h$^$j$^$9!#(B
    $BFCDj$N%[%9%H$d%[%9%H72$K$N$_%5!<%P$X$N%"%/%;%9$r5v2D$9$k$?$a$K$O!"(B
    $B0J2<$N$I$l$+$N7A<0$G(B <var>host</var> $B$r;XDj$9$k$3$H$,$G$-$^$9(B:</p>

    <dl>
      <dt>$B%I%a%$%sL>(B ($B$N0lIt(B)</dt>

      <dd>
      <example><title>$BNc(B:</title>
        Allow from apache.org
      </example>
      <p>$B$3$NJ8;zNs$K9g$&$+!"$3$l$G=*$o$kL>A0$N%[%9%H$N%"%/%;%9$,5v2D$5$l$^$9!#(B
      $B3FItJ,$,40A4$K9g$&$b$N$@$1$KE,MQ$5$l$^$9$N$G!">e$NNc$O(B
      <code>foo.apache.org</code> $B$K$O%^%C%A$7$^$9$,!"(B
      <code>fooapache.org</code> $B$K$O%^%C%A$7$^$;$s!#(B
      $B$3$N@_Dj$r$9$k$H!"(BApache $B$O(B
      <directive module="core">HostnameLookups</directive>
      $B$N@_Dj$K4X$o$i$:!"%/%i%$%"%s%H$N(B IP $B%"%I%l%9$KBP$7$F(B
      $BFs=E$N(B DNS $B$N5U0z$-$r9T$J$$$^$9!#$^$:(B IP $B%"%I%l%9$KBP$7$F(B DNS $B$N(B
      $B5U0z$-$r9T$J$C$F%[%9%HL>$rF@!"$=$N%[%9%HL>$KBP$7$F@50z$-$r(B
      $B9T$J$$!"85$N(B IP $B%"%I%l%9$H0lCW$9$k$+$rD4$Y$^$9!#(BDNS $B$N@50z$-$H(B
      $B5U0z$-$,L5L7=b$+$D%[%9%HL>$,0lCW$9$k$H$-$K$N$_(B
      $B%"%/%;%9$,5v2D$5$l$^$9!#(B</p></dd>

      <dt>$B40A4$J(B IP $B%"%I%l%9(B</dt>

      <dd>
      <example><title>$BNc(B:</title>
        Allow from 10.1.2.3
      </example>
      <p>$B%"%/%;%9$r5v2D$9$k(B IP $B%"%I%l%9$G$9!#(B</p></dd>

      <dt>IP $B%"%I%l%9$N0lIt(B</dt>

      <dd>
      <example><title>$BNc(B:</title>
        Allow from 10.1
      </example>
      <p>$B%5%V%M%C%H$N@)8BMQ$N!"(BIP
      $B%"%I%l%9$N:G=i$N0l$D$+$i;0$D$^$G$N%P%$%H$G$9!#(B</p></dd>

      <dt>$B%M%C%H%o!<%/(B/$B%M%C%H%^%9%/(B $B$NBP(B</dt>

      <dd>
      <example><title>$BNc(B:</title>
        Allow from 10.1.0.0/255.255.0.0
      </example>
      <p>$B%M%C%H%o!<%/(B a.b.c.d $B$H%M%C%H%^%9%/(B w.x.y.z $B$G$9!#(B
      $B$h$j:YN3EY$N%5%V%M%C%H@)8BMQ$G$9!#(B</p></dd>

      <dt>$B%M%C%H%o!<%/(B/nnn CIDR $B;XDj(B</dt>

      <dd>
      <example><title>$BNc(B:</title>
        Allow from 10.1.0.0/16
      </example>
      <p>$B%M%C%H%^%9%/$,(B nnn $B$N>e0L%S%C%H$,(B 1
      $B$H$J$C$F$$$k$b$N$+$i$J$k$3$H0J30$OA0$N$b$N$HF1$8$G$9!#(B</p></dd>
    </dl>

    <p>$BCm(B: $B:G8e$N;0$D$NNc$O$^$C$?$/F1$8%[%9%H$K9g$$$^$9!#(B</p>


    <p>IPv6 $B%"%I%l%9$H(B IPv6 $B$N%5%V%M%C%H$O0J2<$N$h$&$K;XDj$G$-$^$9(B:</p>

    <example>
       Allow from fe80::a00:20ff:fea7:ccea<br />
       Allow from fe80::a00:20ff:fea7:ccea/10
    </example>

    <p><directive>Allow</directive> $B%G%#%l%/%F%#%V$N0z?t$N;0$DL\$N7A<0$O!"(B
    <a href="../env.html">$B4D6-JQ?t(B</a>
    $B$NB8:_$K$h$j%"%/%;%9$N@)8f$r9T$J$($k$h$&$K$9$k$b$N$G$9!#(B
    <code>Allow from env=<var>env-variable</var></code>
    $B$,;XDj$5$l$F$$$k$H!"4D6-JQ?t(B <var>env-variable</var>
    $B$,B8:_$7$?>l9g$K%j%/%(%9%H$O%"%/%;%9$r5v2D$5$l$^$9!#%5!<%P$O(B
    <module>mod_setenvif</module>
    $B$N%G%#%l%/%F%#%V$K$h$j!"%/%i%$%"%s%H$N%j%/%(%9%H(B
    $B$NFCD'$K4p$E$$$F=@Fp$K4D6-JQ?t$r@_Dj$9$k5!G=$rDs6!$7$^$9!#(B
    $B$G$9$+$i!"$3$N%G%#%l%/%F%#%V$O%/%i%$%"%s%H$N(B
    <code>User-Agent</code> ($B%V%i%&%6$N<oN`(B)$B!"(B<code>Referer</code>
    $B$dB>$N(B HTTP $B%j%/%(%9%H$N%X%C%@%U%#!<%k%I$J$I$K4p$E$$$F(B
    $B%"%/%;%95v2D$r$9$k$?$a$K;H$&$3$H$,$G$-$^$9!#(B
    </p>

    <example><title>$BNc(B:</title>
      SetEnvIf User-Agent ^KnockKnock/2\.0 let_me_in<br />
      &lt;Directory /docroot&gt;<br />
      <indent>
        Order Deny,Allow<br />
        Deny from all<br />
        Allow from env=let_me_in<br />
      </indent>
      &lt;/Directory&gt;
    </example>

    <p>$B$3$N>l9g!"(Buser-agent $B$NJ8;zNs$,(B <code>KnockKnock/2.0</code>
    $B$G;O$^$k%V%i%&%6$N$_$,%"%/%;%9$r5v2D$5$l!"(B
    $BB>$N$b$N$O%"%/%;%9$r5qH]$5$l$^$9!#(B</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>Deny</name>
<description>$B%5!<%P$,%"%/%;%9$r5qH]$9$k%[%9%H$r@)8f$9$k(B</description>
<syntax> Deny from
    all|<var>host</var>|env=<var>env-variable</var>
    [<var>host</var>|env=<var>env-variable</var>] ...</syntax>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>Limit</override>

<usage>
    <p>$B$3$N%G%#%l%/%F%#%V$O%[%9%HL>!"(BIP
    $B%"%I%l%9!"4D6-JQ?t$K4p$E$$$F%5!<%P$X$N%"%/%;%9$r@)8B$7$^$9!#(B
    <directive>Deny</directive> $B%G%#%l%/%F%#%V$N0z?t$O(B <directive
    module="mod_access">Allow</directive>
    $B%G%#%l%/%F%#%V$H$^$C$?$/F1$8$G$9!#(B</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>Order</name>
<description>$B%G%U%)%k%H$N%"%/%;%92DG=$J>uBV$H!"(B<directive>Allow</directive> $B$H(B
<directive>Deny</directive> $B$,I>2A$5$l$k=gHV$r@)8f$9$k(B</description>

<syntax> Order <var>ordering</var></syntax>
<default>Order Deny,Allow</default>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>Limit</override>

<usage>

    <p><directive>Order</directive> $B%G%#%l%/%F%#%V$O%G%U%)%k%H$N%"%/%;%9$N>uBV$H(B
    <directive module="mod_access">Allow</directive> $B%G%#%l%/%F%#%V$H(B
    <directive module="mod_access">Deny</directive>
    $B%G%#%l%/%F%#%V$,I>2A$5$l$k=gHV$r@)8f$7$^$9!#(B
    <var>Ordering</var> $B$O0J2<$N$I$l$+$G$9!#(B</p>

    <dl>
      <dt><code>Deny,Allow</code></dt>

      <dd><directive module="mod_access">Deny</directive> $B%G%#%l%/%F%#%V$,(B
      <directive module="mod_access">Allow</directive>
      $B%G%#%l%/%F%#%V$NA0$KI>2A$5$l$^$9!#(B
      $B%"%/%;%9$O%G%U%)%k%H$G5v2D$5$l$^$9!#(B<directive
      module="mod_access">Deny</directive>
      $B%G%#%l%/%F%#%V$K9g$o$J$$$+!"(B<directive module="mod_access">Allow</directive>
      $B%G%#%l%/%F%#%V$K9g$&%/%i%$%"%s%H$O%"%/%;%9$r5v2D$5$l$^$9!#(B</dd>

      <dt><code>Allow,Deny</code></dt>

      <dd><directive module="mod_access">Allow</directive>
      $B%G%#%l%/%F%#%V$,(B <directive
      module="mod_access">Deny</directive>
      $B%G%#%l%/%F%#%V$NA0$KI>2A$5$l$^$9!#(B
      $B%"%/%;%9$O%G%U%)%k%H$G5qH]$5$l$^$9!#(B<directive
      module="mod_access">Allow</directive>
      $B%G%#%l%/%F%#%V$K9g$o$J$$$+!"(B<directive module="mod_access">Deny</directive>
      $B%G%#%l%/%F%#%V$K9g$&%/%i%$%"%s%H$O%"%/%;%9$r5qH]$5$l$^$9!#(B
      </dd>

      <dt><code>Mutual-failure</code></dt>

      <dd><directive module="mod_access">Allow</directive> $B$N%j%9%H$K8=$l$F!"(B
      <directive module="mod_access">Deny</directive>
      $B$N%j%9%H$K8=$l$J$$%[%9%H$N$_$,%"%/%;%9$r5v2D$5$l$^$9!#(B
      $B$3$N=gHVIU$1$O(B <code>Order Allow,Deny</code> $B$HF1$88z2L$r;}$A!"(B
      $B$=$N@_Dj$NJ}$,9%$^$7$$$?$a$KHs?d>)$H$J$C$F$$$^$9!#(B</dd>
    </dl>

    <p>$B%-!<%o!<%I$O%3%s%^$GJ,N%$9$k$3$H$@$1$,2DG=$G$9!#(B
    $B4V$K(B<em>$B6uGr$,$"$C$F$O$$$1$^$;$s(B</em>$B!#$I$N>l9g$G$b!"(B<directive
    module="mod_access">Allow</directive> $B$H(B
    <directive module="mod_access">Deny</directive> $BJ8$O(B
    $BA4$FI>2A$5$l$k$H$$$&$3$H$KCm0U$7$F$/$@$5$$!#(B
    </p>

    <p>$B0J2<$NNc$G$O!"(Bapache.org
    $B%I%a%$%s$N$9$Y$F$N%[%9%H$O%"%/%;%9$r5v2D$5$l$^$9!#(B
    $BB>$N$9$Y$F$N%[%9%H$O%"%/%;%9$r5qH]$5$l$^$9!#(B</p>

    <example>
      Order Deny,Allow<br />
      Deny from all<br />
      Allow from apache.org
    </example>

    <p>$B<!$NNc$G$O!"(Bfoo.apache.org $B%5%V%I%a%$%s$K$"$k%[%9%H0J30$N!"(B
    apache.org $B%I%a%$%s$N$9$Y$F$N%[%9%H$,%"%/%;%9$r5v2D$5$l$^$9!#(B
    apache.org
    $B%I%a%$%s$G$J$$%[%9%H$O!"%G%U%)%k%H$N>uBV$,%"%/%;%95qH]$N$?$a!"(B
    $B%5!<%P$X$N%"%/%;%9$r5qH]$5$l$^$9!#(B</p>

    <example>
      Order Allow,Deny<br />
      Allow from apache.org<br />
      Deny from foo.apache.org
    </example>

    <p>$B0lJ}!">e$NNc$N(B <directive>Order</directive> $B$,(B <code>Deny,Allow</code>
    $B$KJQ$o$C$F$$$l$P!"$9$Y$N%[%9%H$K%"%/%;%9$,5v2D$5$l$^$9!#(B
    $B$3$l$O!"@_Dj%U%!%$%kCf$N<B:]$N=gHV$K4X$o$i$:!"(B
    <code>Allow from apache.org</code> $B$,:G8e$KI>2A$5$l$F!"(B
    <code>Deny from foo.apache.org</code> $B$r>e=q$-$9$k$+$i$G$9!#(B
    <code>apache.org</code>
    $B%I%a%$%s$K$J$$%[%9%H$b!"%G%U%)%k%H$N>uBV$,(B <var>allow</var>
    $B$KJQ2=$9$k$?$a$K!"%"%/%;%9$r5v2D$5$l$^$9!#(B
    </p>

    <p><directive>Order</directive>
    $B%G%#%l%/%F%#%V$O%G%U%)%k%H$N%"%/%;%9$N>uBV$K1F6A$rM?$($k$N$G!"(B
    <directive module="mod_access">Allow</directive> $B%G%#%l%/%F%#%V$H(B
    <directive module="mod_access">Deny</directive>
    $B%G%#%l%/%F%#%V$,L5$/$F$b!"%5!<%P$N%"%/%;%9$K1F6A$rM?$($k$3$H$,$G$-$^$9!#(B
    $B$?$H$($P!"(B</p>

    <example>
      &lt;Directory /www&gt;<br />
      <indent>
        Order Allow,Deny<br />
      </indent>
      &lt;/Directory&gt;
    </example>

    <p>$B$O%G%U%)%k%H$N%"%/%;%9>uBV$,(B <var>deny</var> $B$K$J$k$?$a!"(B
    <code>/www</code> $B%G%#%l%/%H%j$X$N$9$Y$F$N%"%/%;%9$r5qH]$7$^$9!#(B
    </p>

    <p><directive>Order</directive>
    $B%G%#%l%/%F%#%V$O%5!<%P$N@_Dj=hM}$N3FCJ3,$G$@$1(B
    $B%"%/%;%9%G%#%l%/%F%#%V$N=hM}$N=gHV$rJQ99$7$^$9!#$3$l$O!"$?$H$($P!"(B
    <directive>Order</directive> $B%G%#%l%/%F%#%V$N@_Dj$K4X$o$i$:!"(B
    <directive module="core" type="section">Location</directive> $B%;%/%7%g%s$N(B
    <directive module="mod_access">Allow</directive> $B%G%#%l%/%F%#%V$d(B
    <directive module="mod_access">Deny</directive> $B%G%#%l%/%F%#%V$O!"(B
    <directive module="core" type="sectino">Directory</directive> $B%;%/%7%g%s$d(B
    <code>.htaccess</code> $B%U%!%$%k$N(B <directive
    module="mod_access">Allow</directive>
    $B%G%#%l%/%F%#%V$d(B <directive module="mod_access">Deny</directive>
    $B%G%#%l%/%F%#%V$h$j$b>o$K8e$KI>2A$5$l$k$H$$$&$3$H$r0UL#$7$^$9!#(B
    $B@_Dj%;%/%7%g%s$N%^!<%8$N>\:Y$K$D$$$F$O!"(B
    <a href="../sections.html">Directory,Location, Files
    $B%;%/%7%g%s$NF0:nJ}K!(B</a> $B$r;2>H$7$F$/$@$5$$!#(B</p>
</usage>
</directivesynopsis>

</modulesynopsis>