Manual:Image authorization/ja

この記事では、管理者が利用者権限に基づき画像やファイルへのアクセスを制限するための方法を示します.

サーバーにアップロードされたファイルは、通常MediaWikiを通さずに直接ウェブサーバーから公開されます. パスの暗号化(例：/c/c4/...)を最低限のセキュリティとして用いることはできますが、それらのパスはファイル名から簡単に計算できるので、この方法は本質的な保護にはなり得ません.

'''この設定は推奨されていません. ''' MediaWikiはコンテンツ管理システム（CMS）としては設計されておらず、それゆえ秘匿性の高いデータを保護できる仕様ではありません. （むしろ、可能な限りオープンであるように設計されています. ） このため、プライベートな項目についても、機能の揃った完全な保護はそもそもサポートされていません. 管理者がこの機能を使用しようと考えている場合、Security issues with authorization extensionsをよく読んで下さい.

概要
既定では、すべてのアップロードされた画像（とファイル）はWebサーバーから直接アクセス可能です. MediaWikiフレームワークで許可されたユーザーのみにアクセスを許可したい場合は、二つの条件を満たす必要があります.

MediaWikiの認証はそのディレクトリを含むURLが要求されたときにスクリプトの実行によって画像／ファイルへのアクセスがあったときに呼び出される必要があります.
 * 1) The actual directory must be protected from direct access and;

基本的な実装には次の設定が必要です：


 * 1) アップロードディレクトリ（）を、ファイルシステム上のWebルートディレクトリの外にするか、保護します.
 * 2) アップロードパス（）をへのパスに設定します.

両方のメカニズムはWebサーバープラットフォームによって異なります. ここでは2つのプラットフォームについて詳細な手順を説明します.


 * 1) Apache (ほとんどのバージョン)
 * 2) Microsoft Internet Information Server (IIS), version 6.0 以降

すべての説明において、Mediawikiが"/path/to"にインストールされているとします.

For example in:

http://wiki.yourwiki.org/MyWiki

"/path/to" is "/MyWiki"

How Does "img_auth.php" Work?
Image authorisation works by "intercepting" the URL and checking to see if the remainder (PATH_INFO) is in an area where the user has access based on the standard User ID and any Namespace, etc. protections you've assigned. When you've set up the upload path, to point to a directory that automatically redirects to include a script in the path, the script is executed and determines whether or not the file should be accessed.

What is really happening is this. If your pointer to the image/file is set up to, this is translated to    by MW and the server actually executes img_auth.php passing it   in the PATH_INFO server variable.

img_auth.php then checks to see if the user has access to that particular file and if so, streams it back. If not, it displays a standard 403 error.

Configuring File Uploads
Before attempting this configuration it is very important you understand how to configure file uploads. Please take a few moments to review and understand this article - it will save you a lot of time.

PHP PATH_INFO Support
This requires that your PHP setup support PATH_INFO (many CGI configurations do not) and you need to be in mode or else, there wouldn't be a point ... unless you just like a more secure MW install; see below.

Another Scenario, Security Motivated (Apache/Unix ONLY)
Even if you don't want to restrict access to your images you might want to make use of the img_auth.php mechanism: to avoid publicly accessible directories, where the web server has write permissions. Though a web server writable directory is not insecure in itself, it is the first half of a successful attack to your web server. The second half then would be some exploitable (php) script, being MW or, most likely, some other script. If the attacker can exploit the broken script to upload or generate another script intended to help him with further attacks/spamming etc, the attacker still needs a place to store that script in, writable by the web server ... and has it available and well known in the 'images' directory of MW standard installations.

A very first security measure against this will be to place a .htaccess file inside the 'images' directory with this content:

And that .htaccess must not be writable by the web server! It is a pity, that MW doesn't come with this by default (at least not in 1.6.10).

But even better will be to also move the web server writable 'images' directory outside of the document root, renaming it to something unguessable (e.g. the MD5 hash of &lt;whatever&gt;) and streaming the images via 'img_auth.php', so that the real directory name never ever shows up.

To accomplish that follow these steps:

  login in to a shell of your web server (similar actions are often possible with your FTP client, if not, ask your provider to assist you)   create the unguessable images/upload directory outside of (in parallel to) your document root (note the  at the end of the path):   make it read/writeable for the web server:   create the .htaccess file as noted above and make it readable only (this is paranoia, because the web server never looks here, only PHP not taking care of .ht* files normally, but just in case this directory ever will be made available to the web server directly) :   change your LocalSettings.php config file:  

which should do the right thing without any additional configuration.

That should do the job for web servers with PHP running as an Apache module. No further Apache config file changes are necessary. You then will never see the path to your images, img_auth.php intercepts all read accesses. But all of your images are served, including thumbs.

If you use CGI or IIS your milage may vary.

Apache Instructions
Most administrators have found implementation in an Apache Environment straightforward and fairly simple.

 If you are using a GoDaddy shared hosting account, you may need to reference this thread if you are having problems viewing uploaded images with img_auth.php: 

Apache Step 1. Protect Images Directory from Internet Access
In your [/path/to]/images directory, create an .htaccess containing one line:

Deny from All

Apache Step 2.1. Change in LocalSettings.php. This is not needed if Apache step 2.2 is done.
is the URL path, not the file system path, so if img_auth.php is in  but is accessed as , the line would read:

Be sure to add a leading slash  if   is actually in your root-directory. Images won't be displayed at all if you forget to do so:

Apache Step 2.2. Create aliases to execute img_auth.php
Edit the httpd.conf file and add the two following aliases:

The second [/path/to] on each line should be the absolute path on the file system, and it may be necessary to add a trailing frontslash to img_auth.php (i.e., use [/path/to]/img_auth.php/).

Apache Step 1. Download the cgi-supporting image authorization script
When PATH_INFO is not available download the CGI-supporting image authorization script. Save script under the name cgi_img_auth.php in your MediaWiki directory.

Apache Step 2. Protect Images Directory from Internet Access
In your [/path/to]/images directory, create an .htaccess containing one line:

Apache Step 3.2. Edit .htaccess
Edit the .htaccess to look like this

Note, however, this step is unnecessary on some installations.

Apache - Compatibilize with clean URLs
If your website is rewriting URLs through .htaccess, then you will need an exception before the custom rewrites:

(This means: in case of img_auth called, stop rules)

Example of .htaccess:

Apache - Deny the directory list
If you don't want user to list your images folder set this up on your Apache configuration:

IIS Instructions
Implementation in IIS is more complex because it lacks the inherent 'pipe' capabilities of Apache or Unix in general. However using a few tricks, IIS can be made to execute the CGI and achieve protection.

IIS Step 1. Protect Images Directory from Anonymous Internet Access
With IIS it is important that users cannot access images or files by using alternative URL paths to the bypass the virtual directory redirect. Therefore, a new directory outside the MediaWiki root must be created.

IIS Step 1.1 Create New Physical Directory
Create a new physical directory. This directory should not be inside any other existing web directories or virtual web directories:

例:

c:\inetpub\wwwroot\MyWikiImg

IIS Step 1.2 Check/Set Directory Security
The Directory security must allow read, write, modify for the Internet Guest Account (usually IUSR_[server name]). Don't worry, you're going to regulate this in subsequent steps.

IIS Step 2. Execute Script img_auth.php for all Accesses to Image Directory
In IIS this is done by creating a virtual directory with the same name as the physical directory (if your directory is off the root web).

IIS Step 2.1 Create Virtual Directory with Same Name as Physical Directory
Create a new virtual directory using Start->Administrative Tools->Internet Information Services (IIS) Manager in the web service you are using for MediaWiki.

Right click on the web service->New Virtual Directory...

In the wizard, create a new virtual directory with the same name as the physical directory and point it to that directory.

IIS Step 2.2 Redirect New Virtual Directory to img_auth.php
Still in IIS Manager, right click on the new virtual directory->Properties select the 'Virtual Directory' tab and change the 'The content for this resource should come from:' to 'A redirection to a URL'. Fill in the 'Redirect To:' with the URL to img_auth in your MediaWiki.

例:

http://wiki.yourwiki.org/MyWiki/img_auth.php

Remember to Click Apply!

IIS Step 3 Copy Old Image Directory to New
Copy the contents of the old images directory ($ip/image) and subdirectories into the new directory you created. Note: The 'image' directory will not exist in the new directory. The new directory should not appear as:

Wrong:

MyWikiImg images 0   1    . ..

Right:

MyWikiImg 0 1  . ..

IIS Step 4.1 Change  in LocalSettings.php
例:

IIS Step 4.2 Change  in LocalSettings.php
例:

IIS Step 4.4 Troubleshoot IIS PATH_INFO
If your installation is not working, it may be because img_auth.php requires the server to return PATH_INFO to know exactly which file you wish to access (e.g., everything in the URL after the virtual directory).

There have been several articles and hints that some versions of IIS may disallow the server variables PATH_INFO and PATH_TRANSLATE 'for security reasons'. While we did not have this problem on the current server and patch level (IIS 6.0) it is a noted issue for IIS 4.0 (and possibly prior), you may want to investigate if img_auth.php is not working for you.

The full knowledgebase article may be found at Using PATH_INFO and PATH_TRANSLATED from CGI Applications. The article instructs you on how to run a program written in MS Visual Basic (you may need to load CScript).