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

On this page:

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

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

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

注意:

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

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

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

例: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

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.

To restrict a WebDAV client's write access permissions to your Confluence installation,

  1. Go to the Confluence 'Administration Console'. To do this:

    • Open the 'Browse' menu and select 'Confluence Admin'. The 'Administrator Access' login screen will be displayed.
    • Enter your password and click 'Confirm'. You will be temporarily logged into a secure session to access the 'Administration Console'.
  2. Click 'WebDav Configuration' under '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.
    (info) 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.

To restore one or more restricted WebDAV client's write access permissions to your Confluence installation,

  1. Go to the Confluence 'Administration Console'. To do this:

    • Open the 'Browse' menu and select 'Confluence Admin'. The 'Administrator Access' login screen will be displayed.
    • Enter your password and click 'Confirm'. You will be temporarily logged into a secure session to access the 'Administration Console'.
  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.

To disable the WebDAV plugin's strict path checking option,

  1. Go to the Confluence 'Administration Console'. To do this:

    • Open the 'Browse' menu and select 'Confluence Admin'. The 'Administrator Access' login screen will be displayed.
    • Enter your password and click 'Confirm'. You will be temporarily logged into a secure session to access the 'Administration Console'.
  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

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

To enable or disable access to virtual files and folders,

  1. Go to the Confluence 'Administration Console'. To do this:

    • Open the 'Browse' menu and select 'Confluence Admin'. The 'Administrator Access' login screen will be displayed.
    • Enter your password and click 'Confirm'. You will be temporarily logged into a secure session to access the 'Administration Console'.
  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 クライアントを利用する

The following sections tell you how to set up a WebDAV client natively for a range of different operating systems. WebDAV clients typically appear as drives in your operating system's file browser application, such as Windows Explorer in Microsoft Windows, Finder in Mac OS or Konqueror in Linux.

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 Troubleshooting WebDAV 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 installations and Confluence Standalone distributions)
  • Has no context root
  • There is an issue (WBDV-208) that can prevent Network Drives from being mapped. Please use the Network Folders steps below as a workaround.

(info) 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.

To map a Confluence WebDAV client network drive in Microsoft Windows,

  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'.
    (info) When prompted for login credentials, specify your Confluence username and password.

Screenshot: A Confluence WebDAV Client Network Drive in Windows XP

Windows Web フォルダー

To map a Confluence WebDAV client web folder in Windows XP,

  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'.
    (info) 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,
(info) 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'.
    (info) 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'.

Setting up a WebDAV client in Mac OS

To set up a Confluence WebDAV client in Mac OS,

  1. Open the Finder.
  2. From Go on the Finder Menu, select Connect to Server or press Command+K, which will also bring up this dialog box.
  3. In the 'Server 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 click 'Connect'.
    (info) When prompted for login credentials, specify your Confluence username and password.

Screenshot: Setting Up a WebDAV Client in Mac OS

Setting up a WebDAV client in Linux or UNIX

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.

To set up a Confluence WebDAV client in Konqueror,

  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.
    (info) 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.

関連トピック

指定したラベルを持つコンテンツはありません。