WebDAV を使用すれば、ユーザーは Microsoft Windows の「My Network Places」などの WebDAV クライアントを介して、Confluence のコンテンツにアクセスできます。ユーザーに権限があれば、Confluence のスペース、ページ、添付ファイルを読み書きできるようになります。ユーザーはログインすることを求められ、標準の Confluence コンテンツへのアクセス権限が WebDAV クライアントを通じて利用できる同等のコンテンツに対して適用されます。

Confluence の WebDAV クライアント統合の概要

既定では、すべての WebDAV クライアントが Confluence への書き込み権限を持っています。書き込み権限には、Confluence インストールのスペース、ページ、添付ファイルに関連付けられたコンテンツを作成、編集、移動、削除する WebDAV クライアント用の機能が含まれています。

Confluence 管理コンソールの「WebDAV 設定」画面では、次の操作ができます。

注意:

  • The 'WebDav Configuration' page is only be available if the WebDAV plugin has been enabled. Note that this plugin is bundled with Confluence, and can be enabled or disabled by the System Administrator.
  • The settings on the 'WebDav Configuration' page do not apply to external attachment storage configuration.

Confluence への WebDAV クライアント書き込みアクセスの制限

WebDAV プラグインの以前のバージョンでは、WebDAV クライアントの書き込み権限（つまり、作成、移動、編集を行う操作）を制限する別のオプションが利用可能でした。しかし、このプラグインの現在のバージョンでは、オプションが簡素化され、これらのすべての操作を網羅する一般的な書き込み権限の制限にまとめられています。

現在、WebDAV クライアントのユーザー エージェント ヘッダー内の特定のコンテンツに一致する regex を設定することによって、WebDAV クライアントは Confluence インストールへの書き込み権限を拒否されます。設定された regex は、制限を受ける WebDAV クライアントの一覧に追加されます。この一覧の regex に一致するユーザー エージェント ヘッダーを持つすべての WebDAV クライアントは、Confluence インストールへの書き込み権限を拒否されます。

On this page:

関連ページ

例：Microsoft Web フォルダー WebDAV クライアントによって生成された PROPFIND メソッド ヘッダーです。ユーザー エージェント ヘッダー フィールドを示しています。

PROPFIND /plugins/servlet/confluence/default HTTP/1.1
Content-Language: en-us
Accept-Language: en-us
Content-Type: text/xml
Translate: f
Depth: 1
Content-Length: 489
User-Agent: Microsoft Data Access Internet Publishing Provider DAV
Host: 127.0.0.1:8082
Connection: Keep-Alive

Note: Unlike earlier versions of the WebDAV plugin which could only restrict write permissions for all WebDAV clients, the current version of this plugin allows you to restrict write permissions to specific WebDAV clients selectively.

Confluence インストールへの WebDAV クライアントの書き込みアクセス権限を制限するには、

  1. Choose the cog icon , then choose General Configuration under Confluence Administration.
  2. Choose 'WebDav Configuration' in the left panel. The 'WebDAV Configuration' page is displayed.
  3. 制限したい WebDAV クライアントによって送信されたユーザー エージェント ヘッダーの特定のコンポーネントと一致する regex を入力します。
  4. Click the 'Add new regex' button. The regex is added to the list of restricted WebDAV clients.
    You can repeat steps 3 and 4 to add a regex for each additional WebDAV client you want to restrict.
  5. Click the 'Save' button to save the configuration changes.

Confluence インストールへの書き込みを制限された、1 つ以上の WebDAV クライアントの書き込みアクセス権限を復元するには、

  1. Choose the cog icon , then choose General Configuration under Confluence Administration.
  2. Click 'WebDav Configuration' under 'Configuration' in the left panel. The 'WebDAV Configuration' page is displayed.
  3. Select the regex(es) from the list that match(es) the user agent header sent by the restricted WebDAV client(s) you want to restore.
  4. Click the 'Remove selected regexes' button. The regexes you had selected are removed from the list of restricted WebDAV clients.
  5. Click the 'Save' button to save the configuration changes.

スクリーンショット：WebDAV 設定
 

厳密なパス チェックの無効化

If you observe any idiosyncrasies with your WebDAV client, such as a folder that does exist on your Confluence site but is missing from the client, you can disable the WebDAV plugin's strict path checking option, which may minimise these problems.

WebDAV プラグインの厳格なパス チェック オプションを無効にするには、

  1. Choose the cog icon , then choose General Configuration under Confluence Administration.
  2. Click 'WebDav Configuration' under 'Configuration' in the left panel. The 'WebDAV Configuration' page is displayed.
  3. Clear the 'Disable strict path check' check box.
    (info) You can re-enable this option at a later point in time by simply selecting this check box.
  4. Click the 'Save' button to save this configuration change.

仮想ファイルとフォルダー

In the unlikely event that you observe any problems with the WebDAV client's performance or stability, you can enable access to automatically generated (that is, virtual) files and folders.

注意:

By default, these options are hidden on the 'WebDAV Configuration' page. To make them visible, you must append the parameter ?hiddenOptionsEnabled=true to the end of your URL and reload the page. For example:

<Confluence base URL>/admin/plugins/webdav/config.action?hiddenOptionsEnabled=true

スクリーンショット：非表示になっている仮想ファイルとフォルダー オプション
 

仮想ファイルとフォルダーへのアクセスを有効化または無効化するには、

  1. Choose the cog icon , then choose General Configuration under Confluence Administration.
  2. Click 'WebDav Configuration' under 'Configuration' in the left panel. The 'WebDAV Configuration' page is displayed.
  3. Amend your URL as described in the note above and reload the 'WebDav Configuration' page.
  4. Select or clear the check box options in the 'Virtual Files and Folders' section as required.
  5. Click the 'Save' button to save the configuration changes.

ページで利用するために WebDAV クライアントを利用する

次のセクションでは、各種のオペレーティングシステムで WebDAV クライアントをネイティブに設定する方法を説明します。WebDAV クライアントは、Microsoft Windows のWindows Explorer、Linux の Konqueror など、オペレーティング システムのファイル ブラウザ アプリケーションでは、一般的にドライブとして表示されます。

Setting Up a WebDAV Client in Microsoft Windows

ここでは、Microsoft Windows で WebDAV クライアントをネイティブに設定する 2 つの方法を説明します。

  • ネットワーク ドライブとして設定
  • Web フォルダーとして設定

このようなネットワーク ドライブ方式を使用できる場合は、Web フォルダー方式よりも包括的な Confluence と WebDAV クライアントとのやり取りが実現します。しかし、この方式を使用するには、Confluence のインスタンスがいくつかの環境制約を満たす必要があります。インスタンスの設定がこれらの要件を満たさない場合は、Web フォルダー方式またはサードパーティの WebDAV クライアント ソフトウェアを使用します。

If you run into any problems with the procedures in this section, please refer to the WebDAV Troubleshooting page.

Windows ネットワーク ドライブ

To map a Confluence WebDAV client network drive, your Confluence instance must be configured so that all of the following criteria is met:

  • Uses HTTP (not HTTPS)
  • Listens on port 80 (not 8080, which is the default port value used by the popular application server Apache Tomcat that runs many Confluence EAR / WAR installations, or 8090, the default for Confluence distributions)
  • コンテキスト ルートがない
  • There is an issue (WBDV-208) that can prevent Network Drives from being mapped. Please use the Network Folders steps below as a workaround.

The reason for these restrictions results from limitations in Microsoft's Mini-Redirector component. For more information, please refer to Microsoft's server discovery issue.

Microsoft Windows で Confluence WebDAV クライアント ネットワーク ドライブを割り当てるには、

  1. In Windows XP, go to My Computer -> Tools menu -> Map Network Drive.
    In Windows Vista, go to Computer -> Map Network Drive.
    The 'Map Network Drive' dialog box opens.
  2. 次の入力を指定して、WebDAV クライアントをネットワーク ドライブとして割り当てます。
    • Drive: <Any drive letter> (for example, Z:)
    • Folder: \\<hostname>\webdav (for example, \\localhost\webdav)
  3. Click 'Finish'.
    When prompted for login credentials, specify your Confluence username and password.

Windows Web フォルダー

Windows XP で Confluence WebDAV クライアント Web フォルダーを割り当てるには、

  1. Go to My Network Places and choose 'Add a network place'. The 'Add Network Place Wizard' opens.
  2. Click 'Next', ensure that 'Choose another network location' is selected and then click 'Next' again.
  3. In the 'Internet or network address' field, enter the URL for the Confluence WebDAV location (for example, http://<confluence server url>/confluence/plugins/servlet/confluence/default or http://<confluence server url>/plugins/servlet/confluence/default) and then click 'Next'.
    When prompted for login credentials, specify your Confluence username and password.
  4. Provide a meaningful name for your web folder and proceed with the remainder of the wizard.
  5. Click 'Finish'.

スクリーンショット：Windows XP の Confluence WebDAV クライアント Web フォルダー

To map a Confluence WebDAV client web folder in Windows Vista:
This procedure is very similar to the one for Windows XP. However, the following procedure includes the slight interface differences that are specific to Windows Vista.

  1. Open the 'Map Network Drive' dialog box (refer to first step of the procedure above for mapping a network drive) and choose 'Connect to a Web site that you can use to store your documents and pictures'. The 'Add Network Location' wizard opens.
  2. Click 'Next', ensure that 'Choose a custom network location' is selected and then click 'Next' again.
  3. In the 'Internet or network address' field, enter the URL for the Confluence WebDAV location (for example, http://<confluence server url>/confluence/plugins/servlet/confluence/default or http://<confluence server url>/plugins/servlet/confluence/default) and then click 'Next'.
    When prompted for login credentials, specify your Confluence username and password.
  4. Provide a meaningful name for your network location/web folder and proceed with the remainder of the wizard.
  5. Click 'Finish'.

Linux または Solaris で WebDAV クライアントを設定する

There are many tools and mechanisms available for configuring WebDAV clients in these operating systems. Therefore, we have chosen to demonstrate this using the file manager Konqueror, which is part of the Linux K Desktop Environment.

Konqueror で Confluence WebDAV クライアントを設定するには、

  1. Konqueror を開きます。
  2. In the 'Location' field, enter the URL for the Confluence WebDAV location using the 'protocol' webdavs (for example, webdavs://<confluence server url>/confluence/plugins/servlet/confluence/default or webdavs://<confluence server url>/plugins/servlet/confluence/default) and press Enter.
    If prompted for login credentials, specify your Confluence username and password.
    You should be able to click to load many, but not all files. In practice, you would normally save a modified file locally, then drag it to the Konqueror window to upload it to Confluence.

既知の問題

Please refer to the WebDAV plugin documentation for a description of the known issues and suggested workarounds.

  • ラベルなし

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.