1 <?xml version="1.0" encoding="UTF-8" ?>
2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
4 <!-- English Revision: 450473:1343935 (outdated) -->
7 Licensed to the Apache Software Foundation (ASF) under one or more
8 contributor license agreements. See the NOTICE file distributed with
9 this work for additional information regarding copyright ownership.
10 The ASF licenses this file to You under the Apache License, Version 2.0
11 (the "License"); you may not use this file except in compliance with
12 the License. You may obtain a copy of the License at
14 http://www.apache.org/licenses/LICENSE-2.0
16 Unless required by applicable law or agreed to in writing, software
17 distributed under the License is distributed on an "AS IS" BASIS,
18 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19 See the License for the specific language governing permissions and
20 limitations under the License.
23 <modulesynopsis metafile="mod_info.xml.meta">
26 <description>サーバの設定の包括的な概観を提供する</description>
27 <status>Extension</status>
28 <sourcefile>mod_info.c</sourcefile>
29 <identifier>info_module</identifier>
32 <p><module>mod_info</module> を設定するには、以下を <code>httpd.conf</code>
36 <Location /server-info><br />
38 SetHandler server-info<br />
43 <p><directive type="section" module="core">Location</directive>
44 の中で <module>mod_access</module> を使って、サーバ設定情報への
45 アクセスを制限したいと思うかもしれません :</p>
48 <Location /server-info><br />
50 SetHandler server-info<br />
51 Order deny,allow<br />
53 Allow from yourcompany.com<br />
58 <p>一旦設定すると、<code>http://your.host.example.com/server-info</code>
59 にアクセスすることでサーバの情報を得られるようになります。</p>
62 <section id="security"><title>Security Issues</title>
63 <p>一旦 <module>mod_info</module> がサーバに読み込まれると、
64 提供しているハンドラ機能はディレクトリ毎の設定ファイル (<em>例えば</em>
65 .htaccess) を含む <em>すべて</em>の設定ファイルで有効になります。
66 このモジュールを有効にするときはセキュリティの問題を考慮する必要が
69 <p>特に、このモジュールはシステムパス、ユーザ名/パスワード、
70 データベース名など、他の Apache モジュールの設定ディレクティブから
71 セキュリティ上微妙な情報を漏らす可能性があります。
72 ですから、このモジュールはきちんとアクセス制御された環境で<strong>のみ</strong>、
75 <p>設定情報へのアクセスを制限するために、<module>mod_authz_host</module> を
78 <example><title>アクセス制御</title>
79 <Location /server-info><br />
81 SetHandler server-info<br />
82 Order allow,deny<br />
83 # Allow access from server itself<br />
84 Allow from 127.0.0.1<br />
85 # Additionally, allow access from local workstation<br />
86 Allow from 192.168.1.17<br />
92 <section id="queries"><title>表示される情報の選択</title>
93 <p>デフォルトでは、サーバ情報はすべての有効なモジュールと、
94 各モジュールについて、モジュールが理解するディレクティブ、
95 実装している、フック、現時点での設定の関連するディレクティブに
98 <p><code>server-info</code> リクエストへクエリーを追加することで、
99 設定情報の他の表示形式を選ぶことができます。例えば、
100 <code>http://your.host.example.com/server-info?config</code> は
101 すべての設定ディレクティブを表示します。</p>
104 <dt><code>?<module-name></code></dt>
105 <dd>指定されたモジュールに関連する情報のみ</dd>
106 <dt><code>?config</code></dt>
107 <dd>モジュールでソートせずに、設定ディレクティブのみ</dd>
108 <dt><code>?hooks</code></dt>
109 <dd>各モジュールが使用するフックのみ</dd>
110 <dt><code>?list</code></dt>
111 <dd>有効なモジュールの簡単なリストのみ</dd>
112 <dt><code>?server</code></dt>
117 <section id="limitations"><title>既知の制限</title>
118 <p><module>mod_info</module> は、元の設定ファイルを読むのではなく、
119 既にパースされた設定を読み込むことで情報を提供します。従って、
120 パース済みの設定情報の木が生成される方法による制限がいくつかあります:</p>
122 <li>パースされた設定に保存されずに、すぐに実行されるディレクティブは
124 <directive module="core">ServerRoot</directive>,
125 <directive module="mod_so">LoadModule</directive>,
126 <directive module="mod_so">LoadFile</directive> があります。</li>
127 <li><directive module="core">Include</directive>,
128 <directive module="core"><IfModule></directive>,
129 <directive module="core"><IfDefine></directive>,
130 のような設定ファイル自身を制御するディレクティブは表示されません。
131 そのディレクティブの中にあり、有効になっているディレクティブは
133 <li>コメントは表示されません。(これは仕様だと思ってください。)</li>
134 <li><code>.htaccess</code> ファイルの設定ディレクティブは表示されません
135 (永久的なサーバ設定の一部ではないからです)。</li>
136 <li><directive module="core"><Directory></directive>
137 のようなコンテナディレクティブは普通に表示されますが、
138 <module>mod_info</module> は閉じタグの <directive module="core"
139 ></Directory></directive> などの数を知ることはできません。</li>
140 <li><module>mod_perl</module> のようなサードパーティモジュール
141 のディレクティブは表示されないかもしれません。</li>
146 <name>AddModuleInfo</name>
147 <description>server-info ハンドラにより表示されるモジュールの情報に
148 追加の情報を付け加える</description>
149 <syntax>AddModuleInfo <var>module-name</var> <var>string</var></syntax>
150 <contextlist><context>server config</context><context>virtual host</context>
152 <compatibility>Apache 1.3 以降</compatibility>
155 <p>これは、<var>string</var> の内容がモジュール <var>module-name</var>
156 の<strong>追加情報</strong> として HTML
157 として解釈され、表示されるようにします。例:</p>
160 AddModuleInfo mod_deflate.c 'See <a \<br />
162 href="http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html">\<br />
163 http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html</a>'