mod_info.xml.ja revision 173e5f4d5ec46b5febb74ce860d753bb1faaba0f
842ae4bd224140319ae7feec1872b93dfd491143fielding<?xml version="1.0" encoding="UTF-8" ?>
842ae4bd224140319ae7feec1872b93dfd491143fielding<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
842ae4bd224140319ae7feec1872b93dfd491143fielding<?xml-stylesheet type="text/xsl" href="/style/manual.ja.xsl"?>
842ae4bd224140319ae7feec1872b93dfd491143fielding<!-- English Revision: 450473:1397681 (outdated) -->
842ae4bd224140319ae7feec1872b93dfd491143fielding
842ae4bd224140319ae7feec1872b93dfd491143fielding<!--
2d2eda71267231c2526be701fe655db125852c1ffielding Licensed to the Apache Software Foundation (ASF) under one or more
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd contributor license agreements. See the NOTICE file distributed with
2d2eda71267231c2526be701fe655db125852c1ffielding this work for additional information regarding copyright ownership.
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd The ASF licenses this file to You under the Apache License, Version 2.0
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd (the "License"); you may not use this file except in compliance with
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd the License. You may obtain a copy of the License at
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd http://www.apache.org/licenses/LICENSE-2.0
2d2eda71267231c2526be701fe655db125852c1ffielding
2d2eda71267231c2526be701fe655db125852c1ffielding Unless required by applicable law or agreed to in writing, software
759f4a24d09e28c4eaca9f97311b497fc15cb5c7ben distributed under the License is distributed on an "AS IS" BASIS,
0432a26b69eedfb9ca5f34fba590236378a24851ben WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
0432a26b69eedfb9ca5f34fba590236378a24851ben See the License for the specific language governing permissions and
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh limitations under the License.
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh-->
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<modulesynopsis metafile="mod_info.xml.meta">
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<name>mod_info</name>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<description>サーバの設定の包括的な概観を提供する</description>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<status>Extension</status>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<sourcefile>mod_info.c</sourcefile>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<identifier>info_module</identifier>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<summary>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh <p><module>mod_info</module> を設定するには、以下を <code>httpd.conf</code>
2d2eda71267231c2526be701fe655db125852c1ffielding ファイルに加えます。</p>
2d2eda71267231c2526be701fe655db125852c1ffielding
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh <example>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh &lt;Location /server-info&gt;<br />
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh <indent>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb SetHandler server-info<br />
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb </indent>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb &lt;/Location&gt;
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb </example>
2d2eda71267231c2526be701fe655db125852c1ffielding
30c289e6bc6d28d210b21edd800ab2cfc78a8381wrowe <p><directive type="section" module="core">Location</directive>
cccd31fa4a72fe23cc3249c06db181b274a55a69gstein の中で <module>mod_access</module> を使って、サーバ設定情報への
cccd31fa4a72fe23cc3249c06db181b274a55a69gstein アクセスを制限したいと思うかもしれません :</p>
cd39d2139743ca0ef899953c6496dcf99e9c791atrawick
cccd31fa4a72fe23cc3249c06db181b274a55a69gstein <example>
a261b81a1044c0e2ea3f21cf9b7019297bad16aajorton &lt;Location /server-info&gt;<br />
b627048681b27fe30f979ba471b523be3a6a22adrbb <indent>
cccd31fa4a72fe23cc3249c06db181b274a55a69gstein SetHandler server-info<br />
cccd31fa4a72fe23cc3249c06db181b274a55a69gstein Order deny,allow<br />
44c46ef733836b32585d135d2d90856e7cfd9929rbb Deny from all<br />
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb Allow from yourcompany.com<br />
e6cc28a5eb3371ba0c38e941855e71ff0054f50erbb </indent>
d9039a9aaeaa1359c1147af66c09aeac56ae3ee0pquerna &lt;/Location&gt;
cdccf2ac94172d1a4a54bc2e17324e1ef682ccf3pquerna </example>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb
9cfc48b742c224c1fbc2c26a4119a3266192c7d2wrowe <p>一旦設定すると、<code>http://your.host.example.com/server-info</code>
9cfc48b742c224c1fbc2c26a4119a3266192c7d2wrowe にアクセスすることでサーバの情報を得られるようになります。</p>
ef5650b61a8e35f3cc93ec07e73efc17ea329894jorton</summary>
7c7372abe2484e7fcf81937b93496d1246e5b816gstein
a261b81a1044c0e2ea3f21cf9b7019297bad16aajorton<section id="security"><title>Security Issues</title>
a261b81a1044c0e2ea3f21cf9b7019297bad16aajorton <p>一旦 <module>mod_info</module> がサーバに読み込まれると、
a261b81a1044c0e2ea3f21cf9b7019297bad16aajorton 提供しているハンドラ機能はディレクトリ毎の設定ファイル (<em>例えば</em>
a261b81a1044c0e2ea3f21cf9b7019297bad16aajorton .htaccess) を含む <em>すべて</em>の設定ファイルで有効になります。
d71fd7cd9c4815d0647425f21ba3a803919a9148jorton このモジュールを有効にするときはセキュリティの問題を考慮する必要が
7c7372abe2484e7fcf81937b93496d1246e5b816gstein あるでしょう。</p>
7c7372abe2484e7fcf81937b93496d1246e5b816gstein
7c7372abe2484e7fcf81937b93496d1246e5b816gstein <p>特に、このモジュールはシステムパス、ユーザ名/パスワード、
7c7372abe2484e7fcf81937b93496d1246e5b816gstein データベース名など、他の Apache モジュールの設定ディレクティブから
7c7372abe2484e7fcf81937b93496d1246e5b816gstein セキュリティ上微妙な情報を漏らす可能性があります。
2d2eda71267231c2526be701fe655db125852c1ffielding ですから、このモジュールはきちんとアクセス制御された環境で<strong>のみ</strong>、
2d2eda71267231c2526be701fe655db125852c1ffielding 注意して使ってください。</p>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh
2d2eda71267231c2526be701fe655db125852c1ffielding <p>設定情報へのアクセスを制限するために、<module>mod_authz_host</module> を
2d2eda71267231c2526be701fe655db125852c1ffielding 使うのが良いでしょう。</p>
2d2eda71267231c2526be701fe655db125852c1ffielding
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh <example><title>アクセス制御</title>
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh &lt;Location /server-info&gt;<br />
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh <indent>
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh SetHandler server-info<br />
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh Order allow,deny<br />
2d2eda71267231c2526be701fe655db125852c1ffielding # Allow access from server itself<br />
dd5cbadf2df719db2f3c769d03ec847da25854e6bnicholes Allow from 127.0.0.1<br />
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh # Additionally, allow access from local workstation<br />
dd5cbadf2df719db2f3c769d03ec847da25854e6bnicholes Allow from 192.168.1.17<br />
2d2eda71267231c2526be701fe655db125852c1ffielding </indent>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh &lt;/Location&gt;
2d2eda71267231c2526be701fe655db125852c1ffielding </example>
2d2eda71267231c2526be701fe655db125852c1ffielding</section>
2d2eda71267231c2526be701fe655db125852c1ffielding
2d2eda71267231c2526be701fe655db125852c1ffielding<section id="queries"><title>表示される情報の選択</title>
742318b93e89c311f66b55f426c4d9cf2c14628bjim <p>デフォルトでは、サーバ情報はすべての有効なモジュールと、
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb 各モジュールについて、モジュールが理解するディレクティブ、
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb 実装している、フック、現時点での設定の関連するディレクティブに
742318b93e89c311f66b55f426c4d9cf2c14628bjim なっています。</p>
742318b93e89c311f66b55f426c4d9cf2c14628bjim
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <p><code>server-info</code> リクエストへクエリーを追加することで、
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb 設定情報の他の表示形式を選ぶことができます。例えば、
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <code>http://your.host.example.com/server-info?config</code> は
742318b93e89c311f66b55f426c4d9cf2c14628bjim すべての設定ディレクティブを表示します。</p>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh
2d2eda71267231c2526be701fe655db125852c1ffielding <dl>
2d2eda71267231c2526be701fe655db125852c1ffielding <dt><code>?&lt;module-name&gt;</code></dt>
2d2eda71267231c2526be701fe655db125852c1ffielding <dd>指定されたモジュールに関連する情報のみ</dd>
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh <dt><code>?config</code></dt>
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh <dd>モジュールでソートせずに、設定ディレクティブのみ</dd>
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh <dt><code>?hooks</code></dt>
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh <dd>各モジュールが使用するフックのみ</dd>
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh <dt><code>?list</code></dt>
2d2eda71267231c2526be701fe655db125852c1ffielding <dd>有効なモジュールの簡単なリストのみ</dd>
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh <dt><code>?server</code></dt>
2d2eda71267231c2526be701fe655db125852c1ffielding <dd>基本サーバ情報のみ</dd>
2d2eda71267231c2526be701fe655db125852c1ffielding </dl>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh</section>
2d2eda71267231c2526be701fe655db125852c1ffielding
a0bd5cdd79004f4b7b1b441e38133519d3e20a1fsf<section id="limitations"><title>既知の制限</title>
2d2eda71267231c2526be701fe655db125852c1ffielding <p><module>mod_info</module> は、元の設定ファイルを読むのではなく、
2d2eda71267231c2526be701fe655db125852c1ffielding 既にパースされた設定を読み込むことで情報を提供します。従って、
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh パース済みの設定情報の木が生成される方法による制限がいくつかあります:</p>
2d2eda71267231c2526be701fe655db125852c1ffielding <ul>
2d2eda71267231c2526be701fe655db125852c1ffielding <li>パースされた設定に保存されずに、すぐに実行されるディレクティブは
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh 一覧に現れません。これには
2d2eda71267231c2526be701fe655db125852c1ffielding <directive module="core">ServerRoot</directive>,
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh <directive module="mod_so">LoadModule</directive>,
2d2eda71267231c2526be701fe655db125852c1ffielding <directive module="mod_so">LoadFile</directive> があります。</li>
2d2eda71267231c2526be701fe655db125852c1ffielding <li><directive module="core">Include</directive>,
2d2eda71267231c2526be701fe655db125852c1ffielding <directive module="core">&lt;IfModule&gt;</directive>,
2d2eda71267231c2526be701fe655db125852c1ffielding <directive module="core">&lt;IfDefine&gt;</directive>,
2d2eda71267231c2526be701fe655db125852c1ffielding のような設定ファイル自身を制御するディレクティブは表示されません。
2d2eda71267231c2526be701fe655db125852c1ffielding そのディレクティブの中にあり、有効になっているディレクティブは
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh 表示されます。</li>
2d2eda71267231c2526be701fe655db125852c1ffielding <li>コメントは表示されません。(これは仕様だと思ってください。)</li>
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh <li><code>.htaccess</code> ファイルの設定ディレクティブは表示されません
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh (永久的なサーバ設定の一部ではないからです)。</li>
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh <li><directive module="core">&lt;Directory&gt;</directive>
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh のようなコンテナディレクティブは普通に表示されますが、
2d2eda71267231c2526be701fe655db125852c1ffielding <module>mod_info</module> は閉じタグの <directive module="core"
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh >&lt;/Directory&gt;</directive> などの数を知ることはできません。</li>
2d2eda71267231c2526be701fe655db125852c1ffielding <li><module>mod_perl</module> のようなサードパーティモジュール
2d2eda71267231c2526be701fe655db125852c1ffielding のディレクティブは表示されないかもしれません。</li>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh </ul>
2d2eda71267231c2526be701fe655db125852c1ffielding</section>
2d2eda71267231c2526be701fe655db125852c1ffielding
2d2eda71267231c2526be701fe655db125852c1ffielding<directivesynopsis>
2d2eda71267231c2526be701fe655db125852c1ffielding<name>AddModuleInfo</name>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<description>server-info ハンドラにより表示されるモジュールの情報に
2d2eda71267231c2526be701fe655db125852c1ffielding追加の情報を付け加える</description>
2d2eda71267231c2526be701fe655db125852c1ffielding<syntax>AddModuleInfo <var>module-name</var> <var>string</var></syntax>
2d2eda71267231c2526be701fe655db125852c1ffielding<contextlist><context>server config</context><context>virtual host</context>
2d2eda71267231c2526be701fe655db125852c1ffielding</contextlist>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh<compatibility>Apache 1.3 以降</compatibility>
2d2eda71267231c2526be701fe655db125852c1ffielding
dbbf1b4183ae16353011a5269b37899f02b97d81gregames<usage>
2d2eda71267231c2526be701fe655db125852c1ffielding <p>これは、<var>string</var> の内容がモジュール <var>module-name</var>
2d2eda71267231c2526be701fe655db125852c1ffielding の<strong>追加情報</strong> として HTML
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh として解釈され、表示されるようにします。例:</p>
2d2eda71267231c2526be701fe655db125852c1ffielding
742318b93e89c311f66b55f426c4d9cf2c14628bjim <example>
2d2eda71267231c2526be701fe655db125852c1ffielding AddModuleInfo mod_deflate.c 'See &lt;a \<br />
2d2eda71267231c2526be701fe655db125852c1ffielding <indent>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh href="http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html"&gt;\<br />
2d2eda71267231c2526be701fe655db125852c1ffielding http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html&lt;/a&gt;'
ee1af2aeb57527f33baa4737aa431e4aef997855rbowen </indent>
2d2eda71267231c2526be701fe655db125852c1ffielding </example>
2d2eda71267231c2526be701fe655db125852c1ffielding</usage>
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh
2d2eda71267231c2526be701fe655db125852c1ffielding</directivesynopsis>
2d2eda71267231c2526be701fe655db125852c1ffielding</modulesynopsis>
2d2eda71267231c2526be701fe655db125852c1ffielding