<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="/style/manual.ja.xsl"?>

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

<name>mod_authz_owner</name>

<description>ファイルの所有者に基づいた承認</description>

<status>Extension</status>

<sourcefile>mod_authz_owner.c</sourcefile>

<identifier>authz_owner_module</identifier>

<summary>

<p>このモジュールはリクエストされたファイルのファイルシステムの

所有者やグループを HTTP 認証に使われたユーザ ID (ウェブユーザ ID) と

比較することでアクセスを承認します。提供されたユーザ名とパスワードは

<module>mod_auth_basic</module> や

<module>mod_auth_digest</module> のような認証モジュールで既に

適切に検証されている必要があります。<module>mod_authz_owner</module>

は以下のように、<directive module="mod_authz_core"

>Require</directive> ディレクティブの <code>file-owner</code> と

<code>file-group</code> という二つの引数を認識します:</p>

<dl>

<dt><code>file-owner</code></dt>

<dd>提供されたウェブユーザ名はリクエストされたファイルの所有者の

システムにおける名前と一致する必要があります。つまり、オペレーティング

システムがファイルは <code>jones</code> により所有されている

と言ったときは、ウェブからのアクセスに使われるユーザ名も

<code>jones</code> でなければなりません。</dd>

<dt><code>file-group</code></dt>

<dd>ファイルを所有するシステムのグループの名前が、例えば

<module>mod_authz_groupfile</module> や <module>mod_authz_dbm</module>

により提供されるグループデータベースに存在していて、

ウェブユーザ名がそのグループに属していなければなりません。

例えば、オペレーティングシステムがファイルは (システムの) グループ

<code>accounts</code> により所有されていると言ったときは、

<code>accounts</code> がグループデータベースに存在して、

リクエストに使用されたウェブユーザ名がそのグループに属している

必要があります。</dd>

</dl>

<note><title>注</title>

<p>ファイルシステムに実際には存在しないリソース

(<em>つまり</em> バーチャルなリソース) の承認に

<module>mod_authz_owner</module> が使用されたときは、

アクセスは拒否されます。</p>

<p>特に、<a

href="/content-negotiation.html#multiviews">コンテント

ネゴシエーションされた"MultiViews"</a> のリソースは

決して承認しません。</p>

</note>

</summary>

<seealso><directive module="mod_authz_core">Require</directive></seealso>

<section id="examples"><title>設定例</title>

<section id="examples.file-owner"><title>Require file-owner</title>

<p>複数ユーザのシステムで Apache ウェブサーバが実行されていて、

<code>~/public_html/private</code> に各ユーザがファイルを置いているとします。

<directive module="mod_authn_dbm">AuthDBMUserFile</directive>

データベースが一つだけあり、すべてのウェブユーザ名が列挙されており、

このユーザ名がサーバで実際にファイルを所有しているユーザ名と一致している場合、

次の節のような設定で、ユーザが自分自身のファイルにアクセスできるようになります。

<code>/home/smith/public_html/private</code> の中のファイルは、所有者が

<code>smith</code> の代わりに <code>jones</code> になっていない限り、

<code>jones</code> にはアクセスは許可されません。</p>

<highlight language="config">

&lt;Directory /home/*/public_html/private&gt;

AuthType Basic

AuthName MyPrivateFiles

AuthBasicProvider dbm

AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all

Require file-owner

&lt;/Directory&gt;

</highlight>

</section>

<section id="examples.file-group"><title>Require file-group</title>

<p>上記のようなシステムで、数人のユーザがプロジェクトのファイルを

<code>~/public_html/project-foo</code> で共有しているとします。

ファイルはシステムのグループ <code>foo</code> に所有されていて、

<directive module="mod_authz_dbm">AuthDBMGroupFile</directive>

データベースが一つだけあり、そこにすべてのウェブユーザ名と

グループのメンバが列挙されている、<em>つまり</em>、それらの

ユーザは少なくとも <code>foo</code> というグループに属している、とします。

<code>jones</code> と<code>smith</code> の二人共がグループ

<code>foo</code> のメンバである場合、どちらの人も両方の

<code>project-foo</code> にアクセスが許可されます。</p>

<highlight language="config">

&lt;Directory /home/*/public_html/project-foo&gt;

AuthType Basic

AuthName "Project Foo Files"

AuthBasicProvider dbm

# combined user/group database

AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all

AuthDBMGroupFile /usr/local/apache2/etc/.htdbm-all

Satisfy All

Require file-group

&lt;/Directory&gt;

</highlight>

</section>

</section>

</modulesynopsis>