mod_auth_digest.xml.ko

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

<?xml version="1.0" encoding="EUC-KR" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
<!-- English Revision: 106090:151405 (outdated) -->

<!--
 Copyright 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_auth_digest.xml.meta">

<name>mod_auth_digest</name>
<description>MD5 Digest Authentication阑 荤侩茄 荤侩磊牢刘.</description>
<status>Experimental</status>
<sourcefile>mod_auth_digest.c</sourcefile>
<identifier>auth_digest_module</identifier>

<summary>
    <p>捞 葛碘篮 HTTP Digest Authentication阑 备泅茄促.
    弊矾唱 腹篮 抛胶飘甫 芭摹瘤 臼篮 角氰利牢 葛碘捞促.</p>
</summary>

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

<section id="using"><title>Digest Authentication 荤侩窍扁</title>

    <p>MD5 Digest authentication篮 概快 奖霸 荤侩且 荐 乐促.
    葛电 <directive module="mod_auth">AuthGroupFile</directive>阑
    <directive
    module="mod_auth_digest">AuthDigestGroupFile</directive>肺
    函版窍绊, <code>AuthType Basic</code>苞 <directive
    module="mod_auth">AuthUserFile</directive> 措脚
    <code>AuthType Digest</code>客 <directive
    module="mod_auth_digest">AuthDigestFile</directive>阑
    荤侩窍咯 埃窜洒 牢刘阑 汲沥且 荐 乐促. 弊府绊 弥家茄 焊龋窍妨绰
    康开狼 扁夯 URI阑 <directive module="mod_auth_digest"
    >AuthDigestDomain</directive> 瘤矫绢俊 荤侩茄促.</p>

    <p><a href="../programs/htdigest.html">htdigest</a> 档备甫
    荤侩窍咯 荤侩磊 (巩磊)颇老阑 父甸 荐 乐促.</p>

    <example><title>抗力:</title>
      &lt;Location /private/&gt;<br />
      <indent>
        AuthType Digest<br />
        AuthName "private area"<br />
        AuthDigestDomain /private/ http://mirror.my.dom/private2/<br />
        AuthDigestFile /web/auth/.digest_pw<br />
        Require valid-user<br />
      </indent>
      &lt;/Location&gt;
    </example>

    <note><title>林狼</title> 
    <p>Digest authentication篮 Basic authentication焊促 歹
    救傈茄 鞠龋矫胶袍阑 力傍窍瘤父, 宏扼快历啊 瘤盔秦具 茄促.
    2002斥 11岿 泅犁 digest authentication阑 瘤盔窍绰 宏扼快历俊绰
    <a href="http://www.opera.com/">Opera</a>, (龙狼巩磊凯苞
    窃膊 荤侩窍搁 救登瘤父 - 秦搬规过篮 酒贰 "<a href="#msie"
     >MS Internet Explorer</a> 巩力 秦搬窍扁"甫 曼绊) <a
    href="http://www.microsoft.com/windows/ie/">MS Internet
    Explorer</a>, <a
    href="http://www.w3.org/Amaya/">Amaya</a>, <a
    href="http://www.mozilla.org">Mozilla</a>, 滚傈 7 捞饶狼
    <a href="http://channels.netscape.com/ns/browsers/download.jsp"
    >Netscape</a> 殿捞 乐促. digest authentication捞 basic
    authentication 父怒 澄府 备泅登瘤 臼疽扁锭巩俊 林狼秦辑
    荤侩秦具 茄促.</p>
    </note>
</section>

<section id="msie"><title>MS Internet Explorer 巩力 秦搬窍扁</title>
    <p>泅犁 Internet Explorer绰 Digest authentication
    荤侩矫 龙狼巩磊凯捞 乐绰 <code>GET</code> 夸没阑 RFC客 促福霸
    贸府窍绰 巩力啊 乐促. 割啊瘤 规过栏肺 捞 巩力甫 秦搬且 荐
    乐促.</p>

    <p>
    霉锅掳绰 橇肺弊伐俊 磊丰甫 逞败林扁困秦 <code>GET</code>
    措脚 <code>POST</code> 夸没阑 荤侩窍绰 规过捞促. 捞 规过捞
    啊瓷窍促搁 啊厘 埃窜茄 秦搬氓捞促.
    </p>

    <p>肚, 酒颇摹 2.0.51何磐 <code>AuthDigestEnableQueryStringHack</code>
    券版函荐甫 力傍窍咯 巩力甫 秦搬茄促. 夸没俊
    <code>AuthDigestEnableQueryStringHack</code>阑 汲沥窍搁
    酒颇摹绰 MSIE 滚弊甫 乔秦哎 炼摹甫 秒窍绊 夸没 URI甫 digest
    厚背俊辑 力寇茄促. 捞 规过篮 促澜苞 鞍捞 荤侩茄促.</p>

    <example><title>MSIE俊辑 Digest Authentication 荤侩窍扁:</title>
    BrowserMatch "MSIE" AuthDigestEnableQueryStringHack=On
    </example>

    <p>急琶利牢 券版函荐 汲沥俊 措茄 磊技茄 郴侩篮 <directive
    module="mod_setenvif">BrowserMatch</directive> 瘤矫绢甫
    曼绊窍扼.</p>
</section>


<directivesynopsis>
<name>AuthDigestFile</name>
<description>digest authentication俊 荤侩且 荤侩磊疙苞 牢内爹等
鞠龋 格废阑 历厘茄 巩辑颇老 困摹</description>
<syntax>AuthDigestFile <var>file-path</var></syntax>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>AuthConfig</override>

<usage>
    <p><directive>AuthDigestFile</directive> 瘤矫绢绰 digest
    authentication俊 荤侩且 荤侩磊疙苞 牢内爹等 鞠龋甫 历厘窍绰
    巩辑颇老疙阑 瘤沥茄促. <var>File-path</var>绰 荤侩磊沥焊
    颇老狼 例措版肺捞促.</p>

    <p>捞 颇老 郴侩篮 漂喊茄 屈侥捞 乐促. 酒颇摹 硅器夯狼
    <code>support/</code> 窍困叼泛配府俊 乐绰 <a
    href="../programs/htdigest.html">htdigest</a> 档备甫 荤侩窍咯
    捞繁 屈侥狼 颇老阑 父甸 荐 乐促.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>AuthDigestGroupFile</name>
<description>digest authentication俊 荤侩且 弊缝 格废阑 历厘茄
巩辑颇老疙</description>
<syntax>AuthDigestGroupFile <var>file-path</var></syntax>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>AuthConfig</override>

<usage>
    <p><directive>AuthDigestGroupFile</directive> 瘤矫绢绰 弊缝苞
    弊缝狼 备己盔甸(荤侩磊疙) 格废阑 历厘窍绰 巩辑颇老疙阑 瘤沥茄促.
    <var>File-path</var>绰 弊缝沥焊 颇老狼 例措版肺捞促.</p>

    <p>弊缝颇老篮 弊缝疙 第俊 妮沸, 弊第俊 弊缝俊 加茄 荤侩磊疙甸阑
    傍归栏肺 备盒窍咯 茄 临肺 扁废茄促. 抗甫 甸绢 促澜苞 鞍促.</p>

    <example>mygroup: bob joe anne</example>

    <p>奴 巩磊颇老阑 八祸窍绰 巴捞 <em>概快</em> 厚瓤啦利烙阑
    疙缴窍扼.</p>

    <note type="warning"><title>焊救:</title>
    <p><directive>AuthGroupFile</directive>阑 昆辑滚 巩辑甸 观俊
    历厘秦具 茄促. 弊缝颇老捞 焊龋窍绰 叼泛配府 救俊 弊缝颇老阑
    滴瘤 <em>付扼</em>. 弊犯瘤 臼栏搁 努扼捞攫飘啊
    <directive>AuthGroupFile</directive>阑 促款罐阑 荐档 乐促.</p>
    </note>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>AuthDigestQop</name>
<description>digest authentication啊 荤侩且
焊龋荐霖(quality-of-protection)阑 瘤沥茄促.</description>
<syntax>AuthDigestQop none|auth|auth-int [auth|auth-int]</syntax>
<default>AuthDigestQop auth</default>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>AuthConfig</override>

<usage>
    <p><directive>AuthDigestQop</directive> 瘤矫绢绰
    <dfn>焊龋荐霖(quality-of-protection)</dfn>阑 瘤沥茄促.
    <code>auth</code>绰 (荤侩磊疙/鞠龋) 牢刘父 窍绊,
    <code>auth-int</code>绰 牢刘苞 肯搬己 八荤甫 (MD5 秦浆档
    拌魂窍咯 八荤茄促) 茄促. <code>none</code>篮 (肯搬己 八荤甫
    窍瘤臼绰) 坷贰等 RFC-2069 digest 舅绊府硫阑 荤侩茄促.
    <code>auth</code>客 <code>auth-int</code>甫 葛滴 瘤沥且
    荐 乐促. 捞 版快 宏扼快历绰 绢恫 巴阑 荤侩且瘤 急琶茄促.
    宏扼快历啊 绢带 捞蜡俊辑扒 challenge甫 亮酒窍瘤 臼绰促搁
    <code>none</code>阑 荤侩秦具 茄促.</p>

    <note>
      <code>auth-int</code>绰 酒流 备泅登瘤 臼疽促.
    </note>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>AuthDigestNonceLifetime</name>
<description>辑滚 nonce啊 蜡瓤茄 扁埃</description>
<syntax>AuthDigestNonceLifetime <var>seconds</var></syntax>
<default>AuthDigestNonceLifetime 300</default>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>AuthConfig</override>

<usage>
    <p><directive>AuthDigestNonceLifetime</directive> 瘤矫绢绰
    辑滚 nonce啊 蜡瓤茄 扁埃阑 炼例茄促. 努扼捞攫飘啊 父扁等
    nonce甫 啊瘤绊 辑滚俊 立辟窍搁 辑滚绰 <code>stale=true</code>客
    窃膊 401阑 馆券茄促. <var>seconds</var>啊 0焊促 农搁 nonce啊
    蜡瓤茄 扁埃阑 瘤沥茄促. 酒付档 10 檬焊促 累霸 汲沥窍搁 救等促.
    <var>seconds</var>啊 0焊促 累栏搁 nonce绰 康盔洒 父扁登瘤
    臼绰促. <!-- 酒流 备泅登瘤 臼疽澜: <var>seconds</var>啊
    0捞搁 努扼捞攫飘绰 沥犬洒 茄锅父 nonce甫 荤侩且 荐 乐促.
    茄锅父 荤侩且 荐 乐绰 nonce绰 犁积傍拜(replay attack)俊
    措秦 歹 救傈茄 焊救阑 力傍窍瘤父, 宏扼快历啊 夸没甸阑 楷加秦辑
    焊郴芭唱 咯矾 楷搬阑 悼矫俊 且 荐啊 绝绢辑 己瓷捞 惑寸洒
    冻绢龙 荐 乐澜阑 林狼窍扼. 宏扼快历绰 nonce甫 捞固 荤侩窍看绰瘤
    奖霸 舅酒尘 荐 绝扁锭巩俊 夸没阑 楷加秦辑 焊辰饶, 霉锅掳
    夸没阑 力寇窍绊 401 览翠阑 罐篮 促澜 夸没阑 促矫 焊郴霸
    等促. 肚 犁积傍拜俊 措茄 焊龋绰 POST 夸没苞 鞍捞 悼利栏肺
    郴侩阑 积己窍绰 版快俊父 狼固啊 乐澜阑 林狼窍扼. 沥利牢
    郴侩狼 版快 傍拜磊绰 捞固 肯傈茄 郴侩阑 啊瘤绊 乐栏骨肺,
    茄锅父 荤侩且 荐 乐绰 nonce绰 狼固啊 绝促. -->
    </p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>AuthDigestNonceFormat</name>
<description>nonce甫 父靛绰 规过阑 搬沥茄促</description>
<syntax>AuthDigestNonceFormat <var>format</var></syntax>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>AuthConfig</override>

<usage>
    <note>酒流 备泅登瘤 臼疽促.</note>
    <!-- AuthDigestNonceFormat 瘤矫绢绰 nonce甫 父靛绰 规过阑
    搬沥茄促. -->
</usage>
</directivesynopsis>

<directivesynopsis>
<name>AuthDigestNcCheck</name>
<description>辑滚啊 焊郴绰 nonce-count甫 八荤且瘤 咯何</description>
<syntax>AuthDigestNcCheck On|Off</syntax>
<default>AuthDigestNcCheck Off</default>
<contextlist><context>server config</context></contextlist>

<usage>
    <note>
      酒流 备泅登瘤 臼疽促.
    </note>
    <!--
    <p>AuthDigestNcCheck 瘤矫绢绰 辑滚啊 焊郴绰 nonce-count甫
    八荤且瘤 搬沥茄促.</p>

    <p>焊救惑 鼻厘窍瘤父 捞 瘤矫绢甫 On栏肺 汲沥窍搁 己瓷捞
    农霸 冻绢柳促. nonce-count甫 八荤窍妨搁 (digest authentication
    咯何客 包拌绝捞 Authorization 庆歹甫 焊郴绰) *葛电* 夸没阑
    烙拌康开(critical section)阑 烹秦 贸府秦具 茄促. 辑滚啊
    Authorization 庆歹甫 器窃茄 概快 腹篮 夸没阑 贸府茄促搁
    己瓷捞 泅历洒 冻绢龙 荐 乐促.</p>
     -->
</usage>
</directivesynopsis>

<directivesynopsis>
<name>AuthDigestAlgorithm</name>
<description>digest authentication俊辑 challenge客 response
hash甫 拌魂窍绰 舅绊府硫阑 急琶茄促</description>
<syntax>AuthDigestAlgorithm MD5|MD5-sess</syntax>
<default>AuthDigestAlgorithm MD5</default>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>AuthConfig</override>

<usage>
    <p><directive>AuthDigestAlgorithm</directive> 瘤矫绢绰
    challenge客 response hash甫 拌魂窍绰 舅绊府硫阑 急琶茄促.</p>

    <note>
      <code>MD5-sess</code>绰 酒流 肯傈洒 备泅登瘤 臼疽促.
    </note>
    <!--
    <p><code>MD5-sess</code>甫 荤侩窍妨搁
    <code>mod_auth_digest.c</code>狼 <code>get_userpw_hash()</code>
    窃荐甫 刚历 累己秦具 茄促.</p>
    -->
</usage>
</directivesynopsis>

<directivesynopsis>
<name>AuthDigestDomain</name>
<description>digest authentication俊辑 鞍篮 焊龋康开俊 加窍绰
URI甸</description>
<syntax>AuthDigestDomain <var>URI</var> [<var>URI</var>] ...</syntax>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>AuthConfig</override>

<usage>
    <p><directive>AuthDigestDomain</directive> 瘤矫绢绰 鞍篮
    焊龋康开俊 乐绰 (<em>抗甫 甸绢</em> 鞍篮 康开苞 荤侩磊疙/鞠龋
    沥焊甫 荤侩窍绰) URI甸阑 瘤沥茄促. 瘤沥茄 URI绰 立滴荤肺
    荤侩茄促. <em>溜</em>, 努扼捞攫飘绰 URI "酒贰" 葛滴甫
    鞍篮 荤侩磊疙/鞠龋肺 焊龋茄促绊 啊沥茄促. URI绰
    (<em>溜</em>, 胶糯(scheme), 龋胶飘, 器飘 殿阑 器窃窍绰)
    例措 URL捞芭唱 惑措 URI捞促.</p>

    <p>捞 瘤矫绢绰 亲惑 <em>瘤沥秦具</em> 窍哥, 弥家茄 康开甸狼
    扁夯 URI(甸)甫 器窃<em>秦具</em> 茄促. 积帆窍搁 努扼捞攫飘绰
    捞 辑滚肺 焊郴绰 <em>葛电 夸没</em>俊 Authorization 庆歹甫
    器窃茄促. 弊矾搁 夸没狼 农扁啊 目瘤哥, <directive
    module="mod_auth_digest">AuthDigestNcCheck</directive>甫
    荤侩茄促搁 己瓷俊 唱慧 康氢阑 临 荐 乐促.</p>

    <p>促弗 辑滚狼 URI甫 瘤沥窍搁, (捞甫 捞秦窍绰) 努扼捞攫飘绰
    咯矾 辑滚付促 概锅 荤侩磊俊霸 汞瘤臼绊 鞍篮 荤侩磊疙/鞠龋甫
    荤侩且 荐 乐促.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>AuthDigestShmemSize</name>
<description>努扼捞攫飘甫 眠利窍扁困秦 且寸窍绰 傍蜡皋葛府樊</description>
<syntax>AuthDigestShmemSize <var>size</var></syntax>
<default>AuthDigestShmemSize 1000</default>
<contextlist><context>server config</context></contextlist>

<usage>
    <p><directive>AuthDigestShmemSize</directive> 瘤矫绢绰
    努扼捞攫飘甫 眠利窍扁困秦 辑滚啊 矫累且锭 且寸窍绰
    傍蜡皋葛府樊阑 沥狼茄促. 傍蜡皋葛府绰 弥家茄 <em>窍唱狼</em>
    努扼捞攫飘甫 眠利窍扁困秦 鞘夸茄 傍埃焊促 累阑 荐 绝澜阑
    林狼窍扼. 捞 蔼篮 矫胶袍俊 蝶扼 促福促. 沥犬茄 蔼阑 舅妨搁
    <directive>AuthDigestShmemSize</directive>甫 <code>0</code>栏肺
    汲沥窍绊 辑滚甫 矫累茄饶 坷幅巩阑 曼绊窍扼.</p>

    <p><var>size</var>绰 焊烹 官捞飘 窜困捞瘤父, 第俊
    <code>K</code>唱 <code>M</code>阑 荤侩窍咯 KBytes唱 MBytes甫
    唱鸥尘 荐 乐促. 抗甫 甸绢, 促澜 瘤矫绢甸篮 葛滴 鞍促:</p>

    <example>
      AuthDigestShmemSize 1048576<br />
      AuthDigestShmemSize 1024K<br />
      AuthDigestShmemSize 1M
    </example>
</usage>
</directivesynopsis>

</modulesynopsis>