blob: 39e8cd474d5a25e58d1f3f0b0db4e71f4f3d2dbe [file] [log] [blame]
<?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: 1.10 -->
<!--
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_authz_host.xml.meta">
<name>mod_authz_host</name>
<description>$B%[%9%H(B ($BL>A0$b$7$/$O(B IP $B%"%I%l%9(B) $B$K4p$E$$$?%0%k!<%W>5G'(B</description>
<status>Base</status>
<sourcefile>mod_authz_host.c</sourcefile>
<identifier>authz_host_module</identifier>
<compatibility>Apache 2.1 $B0J9_(B</compatibility>
<summary>
<p><module>mod_authz_host</module> $B$K$h$jDs6!$5$l$k%G%#%l%/%F%#%V$O(B
$B%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_authz_host">Allow</directive> $B$H(B
<directive module="mod_authz_host">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_authz_host">Order</directive> $B%G%#%l%/%F%#%V$O(B
$B%G%U%)%k%H$N%"%/%;%9>uBV$H!"(B
<directive module="mod_authz_host">Allow</directive> $B%G%#%l%/%F%#%V$H(B
<directive module="mod_authz_host">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_authz_host">Deny</directive>
$B%G%#%l%/%F%#%V$H(B <directive module="mod_authz_host">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 <em>host</em> $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
DNS $B$N(B 2 $B=E5U0z$-$r9T$J$$$^$9!#(B
$B%[%9%HL>$+$i%*%j%8%J%k$N(B IP $B%"%I%l%9$r=g0z$-$7$^$9!#(B
$B=g0z$-$H5U0z$-$,0lCW$7!"%[%9%HL>$,3:Ev$7$?>l9g$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>Example:</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_authz_host">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_authz_host">Allow</directive> $B%G%#%l%/%F%#%V$H(B
<directive module="mod_authz_host">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_authz_host">Deny</directive> $B%G%#%l%/%F%#%V$,(B
<directive module="mod_authz_host">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_authz_host">Deny</directive>
$B%G%#%l%/%F%#%V$K9g$o$J$$$+!"(B<directive module="mod_authz_host">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_authz_host">Allow</directive>
$B%G%#%l%/%F%#%V$,(B <directive
module="mod_authz_host">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_authz_host">Allow</directive>
$B%G%#%l%/%F%#%V$K9g$o$J$$$+!"(B<directive module="mod_authz_host">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_authz_host">Allow</directive> $B$N%j%9%H$K8=$l$F!"(B
<directive module="mod_authz_host">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_authz_host">Allow</directive> $B$H(B
<directive module="mod_authz_host">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 <em>allow</em>
$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_authz_host">Allow</directive> $B%G%#%l%/%F%#%V$H(B
<directive module="mod_authz_host">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 <em>deny</em> $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_authz_host">Allow</directive> $B%G%#%l%/%F%#%V$d(B
<directive module="mod_authz_host">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_authz_host">Allow</directive>
$B%G%#%l%/%F%#%V$d(B <directive module="mod_authz_host">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>