WebDAVのお話

目次

1 WebDAV って何?

1.1 概要

WebDAV --- Web-based Distributed Authoring and Versioning

Authoring（RFC2581）

• コンテンツの作成，削除，情報の問合せ
• 階層構造を持つドキュメントのコレクション（つまりディレクトリのようなもの）の作成，削除
• 複数の人が編集できないようにするための，ドキュメントのロック
• サーバ内でのドキュメント等のコピーや移動

Versioning（RFC3253）

• DeltaVと呼ばれてる
• 実装はあんまりない

1.2 用語

リソース

サーバ上にあるもの．ファイルやコレクションの総称．

コレクション

同一サーバ内のリソースを示すURIの集合．ディレクトリやフォルダのようなもの．

プロパティ（属性）

各リソースに付属する，名前と値のペアの集合．サーバによって定義されていて必須なものをライブ・プロパティ，クライアントが定義可能なものをデッド・プロパティと呼ぶ．

1.3 ファイルサーバと違う所

• リソースがCGIである場合，かつ，CGIが有効であった場合，読み込んだ結果は，CGIスクリプトの実行結果である．
• リソースがHTMLでSSIである場合も同様．
• サーバ上の任意のユーザのホームディレクトリをWebDAVでマウントする，という使い方は難しい．
• プロトコルはテキストベース（HTTP + XML）なので，通常のファイルサーバよりは効率が悪く，パフォーマンスがでない．

1.4 ファイル名文字コード問題

• 素のApache HTTP Server + mod_davはUTF8を期待している様子

  Mac OS X

  • 特に問題は発生しない（たぶん）

  Windows XP

  • 送信するファイル名はShift_JIS
  • MacOSXで作ったUTF-8のファイル名は正しく読める
  • 自分で作ったファイル名は正しく読めない

• mod_encodingというモジュールがある（今回はちょっと保留）．

1.5 WebDAV 関連ソフトウェア

サーバ

• Apache HTTP Server
• IIS
• 等（たくさんあるらしい）

クライアント

Windows

標準でサポート．「ネットワークプレイスの追加」でhttp://....で設定するとアクセス可能．

Mac OS X

標準でサポート．mount_webdavコマンドや，Filderの「移動」→「サーバに接続」でマウント可能．

neon

C言語用API

cadaver

コマンドラインで使えるクライアント

davfs2

Linuxファイルシステムドライバ

GNOME Nautilus

GNOMEのファイルマネージャ

KDE Konqueror

KDEのファイルマネージャ

2 Subversion って何?

2.1 概要

• サーバ・クライアント型のリビジョン・コントロール・システム
• ファイルのバージョン管理をやってくれる
• 複数の人で一つのソフトウェアやドキュメント等を開発するのに便利
• 一番メジャーなcvsに操作が比較的近い．
• リポジトリへのアクセスに，専用のプロトコル等他にWebDAVが使える．

3 サーバ構築

3.1 目標

1. WebDAVを有効にしたhttpdを動かす．
2. SubversionのリポジトリをWebDAV経由でアクセス可能にする．

3.2 材料

1. UNIXなOSインストール済みPC（この文書ではNetBSD3.0を使用）... 1個
2. Apache HTTP Server 2.2のソース... 1組
3. subversion 1.3.0のソース... 1組

3.3 設定

• /opt/webdavに上記2つのソフトウェアをインストール
• httpdはユーザdav，グループdavで動かす．
• 公開するSubversionリポジトリは/u/repos

3.4 下拵え

1. コンパイルに必要となる次のソフトウェアをインストールしておく．
   • Berkeley DB version 4
   • perl
   • GNU libiconv
   • GNU make
2. Apache HTTP server, subversionを/opt/webdav以下にインストールする．
   図 1 Apache HTTP server インストール例

   $ env CPPFLAGS='-I/usr/pkg/include -I/opt/webdav/include' ...
       LDFLAGS='-L/usr/pkg/lib -Wl,-rpath,/usr/pkg/lib ...
   	-L/opt/webdav/lib -Wl,-rpath,/opt/webdav/lib' ...
       ./configure --prefix=/opt/webdav ...
   	--enable-mods-shared=all ...
   	--enable-ssl --with-ssl=/usr 
   $ make
   $ sudo make install
   

   図 2 Subversion インストール例

   $ env CPPFLAGS='-I/usr/pkg/include -I/opt/webdav/include' ...
       LDFLAGS='-L/usr/pkg/lib -Wl,-rpath,/usr/pkg/lib ...
   	-L/opt/webdav/lib -Wl,-rpath,/opt/webdav/lib' ...
       ./configure --prefix=/opt/webdav --enable-shared ...
   	--with-berkeley-db=/usr/pkg --with-apr=/opt/webdav ...
   	--with-apr-util=/opt/webdav --with-apxs=/opt/webdav/bin/apxs 
   $ make
   $ sudo make install
   

   図 3 mod_encoding インストール例

   $ cd mod_encoding-*/lib
   $ ./configure --prefix=/opt/webdav
   $ gmake
   $ sudo gmake install
   $ cd ..
   $ sudo apcs -i -c -a -Wl,-rpath,/opt/webdav/lib ...
   	-L /opt/webdav/lib -l iconv_hook mod_encoding.c
   

3.5 webdav の基本的な設定

• conf/{httpd.conf,extra/httpd-dav.conf}の雛形を最小限変更して，ひとまず動かしてみる．
• この状態でサーバを起動すると...
  • webdavクライアントから，http://サーバ名/uploads/にアクセスし，adminというユーザ名で認証が成功すると，ファイルのアップロードができるようになる．
  • 通常のweb browserでアクセスするとファイルは読める．（但し，indexesディレクティブが設定されていないので，http://サーバ名/uploads/へのアクセスはforbiddenとなる．）
• 設定
  1. /opt/webdav/conf/httpd.confを編集
     • 次の行のコメントをはずす．

       #Include conf/extra/httpd-dav.conf
       

     • 次の2行が入っていることを確認する．

       LoadModule dav_module modules/mod_dav.so
       LoadModule dav_fs_module modules/mod_dav_fs.so
       

     • userとgroupをdaemonからdavに変更．
  2. /opt/webdav/conf/extra/httpd-dav.confを編集
     リスト 1 httpd-dav.conf の一部

     DavLockDB "/opt/webdav/var/DavLock"
     Alias /uploads "/opt/webdav/uploads"
     <Directory "/opt/webdav/uploads">
         Dav On
         AuthType Digest
         AuthName DAV-upload
         AuthUserFile "/opt/webdav/user.passwd"
         <LimitExcept GET OPTIONS>
             require user admin
         </LimitExcept>
         Order allow,deny
         Allow from all
     </Directory>
     

     • orderディレクティブとallowディレクティブを追加
  3. ユーザ登録

     $ sudo htdigest -c /opt/webdav/user.passwd DAV-upload admin
     Adding password for admin in realm DAV-upload.
     New password: ********
     Re-type new password: ********
     

  4. 必要なディレクトリの作成&パーミッションの設定

     # mkdir -p /opt/webdav/uploads /opt/webdav/var
     # chown dav:dav /opt/webdav/uploads /opt/webdav/var
     

3.6 cgi や ssi を使う web ページを webdav で

• cgiやssiを有効にしたwebコンテンツを，webdav経由で編集できるようにする．
• 設定
  • conf/extra/httpd-dav.confに，以下を追加．

    Alias /cgi-enable  "/opt/webdav/cgi"
    Alias /cgi-disable "/opt/webdav/cgi"
    
    <Location /cgi-enable>
        Order allow,deny
        Allow from all
        Options +Include +ExecCGI
        AddHandler cgi-script .cgi
    </Location>    
    
    <Location /cgi-disable>
        Dav On
        ForceType text/plain
        AuthType Digest
        AuthName DAV-upload
        AuthUserFile "/opt/webdav/user.passwd"
        Require valid-user
        Order allow,deny
        Allow from all
    </Directory>
    

• 動作
  • http://サーバ名/cgi-enable/cgiスクリプト.cgiにアクセスすると，cgiやssiが実行される．（webdavは使えない）
  • webdav等で，http://サーバ名/cgi-disable/にアクセスすると，ソースファイルが見える．

3.7 アクセス制御

• 通常のwebコンテンツと同じように制限可能
  • 認証（basic，digest）による制限
  • order/allow/denyによるホスト単位のアクセス制限
  • limit，limitexceptionによる操作単位の制限

3.8 subversion で webdav リポジトリ

• 認証されたユーザは何でもできる（認証が通らないと何もできない）ようにする．
• 設定
  1. conf/extra/httpd-dav.confに以下を追加
     リスト 2 httpd-dav.conf への追加分

     <Location /repos>
         Dav svn
         SVNPath /u/repos
         Order allow,deny
         Allow from all
         AuthType Digest
         AuthName Repository
         AuthUserFile "/opt/webdav/user.passwd"
         Require valid-user
     </Location>
     

  2. ユーザ登録

     $ sudo htdigest /opt/webdav/user.passwd Repository ユーザー名
     Adding password for ユーザー名 in realm Repository.
     New password: ********
     Re-type new password: ********
     

  3. 必要なディレクトリの作成&パーミッションの設定

     $ sudo svnadmin create /u/repos
     $ sudo chown -R dav:dav /u/repos
     

• 動作
  • WebDAVとしてマウントした時は，リードオンリになる．見えるのは最新のリビジョンのみ．
  • Webブラウザでアクセスした場合，コレクション（ディレクトリ）にアクセスした時は，ファイルのリストが表示される．HTMLファイルの場合は，Firefoxで見るとソースファイルが表示される．IEだとHTMLがレンダリングされて表示される．
  • index.htmlがあったとしても，デフォルトでそれが表示されることはない．
  • ssiやcgiは機能しない．

3.9 AutoVersioning

• リポジトリをwebdavとしてマウントしてファイルの操作を行うと，自動的にリポジトリへのコミットが行われる．
• 設定
  • locationの中に，svnautoversioning onを追加する．
• 使用感
  • リビジョン番号がやたらと増える．（作ったばかりのリポジトリを，macosxでマウントして，ファイルを一つコピーして，一度開いて2行ほど編集して保存すると，既にリビジョン19）
  • 関連する複数の変更を1回のコミットにまとめるということができない．
  • ログが自由に書けない．（モジュール内にハードコーディングされてる）

3.10 mod_encoding の利用

• Windowsで漢字のファイル名を扱えるようにする．
• 設定
  1. 以下を追加する．
     リスト 3 mod_encodng.conf の設定

     LoadModule encoding_module    modules/mod_encoding.so
     <IfModule mod_encoding.c>
         EncodingEngine      on
         NormalizeUsername   on
         SetServerEncoding   UTF-8
         DefaultClientEncoding JA-AUTO-SJIS-MS SJIS
         AddClientEncoding "cadaver/" EUC-JP
     </IfModule>
     

  2. 認証方式をDigestからBasicに変更する．
• 動作
  • 漢字や仮名については使えるようになる．（たぶん）
  • （いわゆる）半角'&'等，使えない文字もまだある．WebDAV Resource JPにパッチがいくつかある．
  • Digest認証だと，エラー出てうまくいかない．Digest認証にURIそのものを用いているようで，変換により一致しなくなる．

4 まとめと今後の課題

• オーサリングについては，かなり便利に使えるとおもう．
• ファイルの読み出し時に，CGIやSSIが機能するというのは，何か面白いことに使えそう．
• アクセス制御については注意する必要がある．GETやPUT等のコマンド毎の制限をきちんと設定しないと不安．
• mod_encodingを使ってもファイル名に使えない文字がいくつかある．
• SSLを使って，通信自体も暗号化してしまう．

5 Webliography

• WebDAV Resources，http://www.webdav.org/
• WebDAV Resource JP，http://webdav.todo.gr.jp/
• Apache HTTP Server Project，http://httpd.apache.org/
• IETF Delta-V Working Group，http://www.webdav.org/deltav/
• Subversion，http://subversion.tigris.org/
• 次世代プロトコルWebDAVの可能性http://www.atmarkit.co.jp/flinux/special/webdav/webdav01a.html
• RFC 2291, Requirements for a Distributed Authoring and Versioning Protocol for the World Wide Web, 1998-02
• RFC 2518, HTTP Extensions for Distributed Authoring -- WEBDAV, 1999-02
• RFC 3253, Versioning Extensions to WebDAV (Web Distributed Authoring and Versioning), 2002-03
• RFC 3648, Web Distributed Authoring and Versioning (WebDAV) Ordered Collections Protocol, 2003-12
• RFC 3744, Web Distributed Authoring and Versioning (WebDAV) Access Control Protocol, 2004-05