WebDAV

RustFS には、HTTP または HTTPS でバケットとオブジェクトを WebDAV クライアントへ公開する Web Distributed Authoring and Versioning（WebDAV）ゲートウェイが含まれます。バケットの参照、コレクションの作成、オブジェクトのアップロード、ダウンロード、名前変更、削除ができます。RustFS は、認証されたアイデンティティとアクセス管理（IAM）ユーザーの権限を各操作に適用します。

WebDAV のサポートは標準の RustFS バイナリにコンパイルされていますが、ゲートウェイは実行時に既定で無効です。クライアントを接続する前に、有効にして設定する必要があります。

概要Copy Anchor Link

ゲートウェイは、WebDAV のパスを RustFS のリソースへ対応付けます。

RustFS は、ゲートウェイ経由で次の操作に対応しています。

コレクションの一覧には、GET ではなく PROPFIND を使います。現在のゲートウェイは、ディレクトリへの GET リクエストに対して 405 Method Not Allowed を返します。

WebDAV は HTTP Basic 認証を使います。ユーザー名には RustFS のアクセスキーを、パスワードにはそのシークレットキーを入力します。ゲートウェイは認証情報を RustFS の IAM に対して認証し、各操作にそのユーザーの S3 ポリシーを適用します。

設定Copy Anchor Link

RustFS を起動する前に、環境変数でゲートウェイを設定します。

標準の RustFS ビルドでは、WebDAV のコンパイル時機能が有効です。--no-default-features で RustFS をビルドする場合は、この機能を明示的に含めます。

cargo build --release --features webdav

TLS なしのローカルテストCopy Anchor Link

次の例は、ポート 8080 で HTTP の WebDAV リスナーを付けて RustFS を起動します。

export RUSTFS_WEBDAV_ENABLE=true
export RUSTFS_WEBDAV_ADDRESS=127.0.0.1:8080
export RUSTFS_WEBDAV_TLS_ENABLED=false
export RUSTFS_ACCESS_KEY=<your-access-key>
export RUSTFS_SECRET_KEY=<your-secret-key>

rustfs /path/to/data

127.0.0.1 にバインドすると、ほかのホストは暗号化されていないテストエンドポイントへ接続できません。

HTTPSCopy Anchor Link

リモート接続または本番接続では、TLS を有効にし、証明書ディレクトリを指定します。

export RUSTFS_WEBDAV_ENABLE=true
export RUSTFS_WEBDAV_ADDRESS=0.0.0.0:8080
export RUSTFS_WEBDAV_TLS_ENABLED=true
export RUSTFS_WEBDAV_CERTS_DIR=/path/to/certs

rustfs /path/to/data

TLS を有効にしているのに RUSTFS_WEBDAV_CERTS_DIR がない場合、またはディレクトリが存在しない場合、WebDAV の初期化は失敗します。証明書の準備は、TLS を設定するを参照します。

設定した WebDAV ポートへの受信 TCP トラフィックを許可します。このリスナーは、S3 API と Console のリスナーとは別です。

使い方Copy Anchor Link

次のコマンドは、ローカルテスト用の HTTP エンドポイントを使います。エンドポイントと認証情報は、自分の HTTPS WebDAV エンドポイントと、必要なバケットおよびオブジェクトの権限を持つ IAM ユーザーに置き換えます。

シークレットを各コマンドへ直接書かずに、再利用できるシェル変数を設定します。

export WEBDAV_URL=http://127.0.0.1:8080
export WEBDAV_USER=<your-access-key>
read -s WEBDAV_PASSWORD
export WEBDAV_PASSWORD

バケットを一覧するCopy Anchor Link

ユーザーから見えるバケットを一覧するには、Depth: 1 を付けた PROPFIND を送ります。

curl --user "$WEBDAV_USER:$WEBDAV_PASSWORD" \
	--request PROPFIND \
	--header "Depth: 1" \
	"$WEBDAV_URL/"

バケットを作成するCopy Anchor Link

curl --user "$WEBDAV_USER:$WEBDAV_PASSWORD" \
	--request MKCOL \
	"$WEBDAV_URL/my-bucket/"

バケット名は、S3 API で作成するバケットと同じ命名規則に従う必要があります。

オブジェクトをアップロードおよびダウンロードするCopy Anchor Link

/path/to/hello.txt をアップロードします。

curl --user "$WEBDAV_USER:$WEBDAV_PASSWORD" \
	--upload-file /path/to/hello.txt \
	"$WEBDAV_URL/my-bucket/hello.txt"

オブジェクトをダウンロードします。

curl --user "$WEBDAV_USER:$WEBDAV_PASSWORD" \
	--output hello.txt \
	"$WEBDAV_URL/my-bucket/hello.txt"

ディレクトリを作成して一覧するCopy Anchor Link

バケットより下の WebDAV ディレクトリは、オブジェクトキーのプレフィックスに対応します。

curl --user "$WEBDAV_USER:$WEBDAV_PASSWORD" \
	--request MKCOL \
	"$WEBDAV_URL/my-bucket/docs/"

curl --user "$WEBDAV_USER:$WEBDAV_PASSWORD" \
	--request PROPFIND \
	--header "Depth: 1" \
	"$WEBDAV_URL/my-bucket/docs/"

オブジェクトの名前を変更するCopy Anchor Link

同じ WebDAV エンドポイント上の宛先パスを指定して、MOVE を使います。

curl --user "$WEBDAV_USER:$WEBDAV_PASSWORD" \
	--request MOVE \
	--header "Destination: $WEBDAV_URL/my-bucket/greeting.txt" \
	"$WEBDAV_URL/my-bucket/hello.txt"

IAM ユーザーには、ソースの読み取りと削除、および宛先への書き込みの権限が必要です。認可に失敗した場合、RustFS はソースを変更せずに残します。

オブジェクトまたはバケットを削除するCopy Anchor Link

オブジェクトを削除します。

curl --user "$WEBDAV_USER:$WEBDAV_PASSWORD" \
	--request DELETE \
	"$WEBDAV_URL/my-bucket/greeting.txt"

内容を削除したあと、バケットを削除します。

curl --user "$WEBDAV_USER:$WEBDAV_PASSWORD" \
	--request DELETE \
	"$WEBDAV_URL/my-bucket/"

デスクトップクライアントから接続するCopy Anchor Link

Basic 認証に対応したクライアントで、WebDAV エンドポイントを使います。

クライアントが認証情報を求めたら、RustFS のアクセスキーとシークレットキーを入力します。クライアントの動作と、対応する WebDAV メソッドは製品によって異なります。トラブルシューティングでサーバー側のエラーを切り分けるときは、curl を使います。

次のステップCopy Anchor Link

• 認証情報を管理する
• TLS を設定する
• サービスの状態を確認する