マネージドコード (C#) を使用して単純な FTP ホームディレクトリプロバイダーを作成する方法

[アーティクル]
03/25/2024

Microsoft は、Windows Server® 2008 用に完全に書き換えられた新しい FTP サービスを作成しました。この新しい FTP サービスには、Web 作成者が以前よりも簡単にコンテンツを公開できる多くの新機能が組み込まれており、Web 管理者により多くのセキュリティとデプロイのオプションが提供されます。

新しい FTP 7.5 サービスでは、FTP サービスに含まれる組み込み機能を拡張できる拡張性がサポートされています。具体的には、FTP 7.5 では、独自の認証および承認プロバイダーの作成がサポートされています。また、カスタム FTP ログや FTP ユーザーのホームディレクトリ情報を決定するためのプロバイダーを作成することもできます。

このチュートリアルでは、マネージドコードを使用して単純な FTP ホームディレクトリプロバイダーを作成する手順について説明します。

前提条件

この記事の手順を完了するには、次の項目が必要です。

IIS 7.0 以降を Windows Server 2008 サーバーにインストールし、インターネットインフォメーションサービス (IIS) マネージャーもインストールする必要があります。
新しい FTP 7.5 サービスをインストールする必要があります。
FTP 公開用のルートフォルダーを作成する必要があります。
Visual Studio 2008 を使用する必要があります。

Note

以前のバージョンの Visual Studio を使用している場合、このチュートリアルの一部の手順が正しくない可能性があります。
各ユーザーのホームディレクトリを作成する必要があります。コードサンプルでは C:\Ftpusers\%*UserName*% を使用しますが、必要に応じて変更できます。

手順 1: プロジェクト環境の設定

この手順では、Visual Studio 2008 でデモプロバイダー用のプロジェクトを作成します。

Microsoft Visual Studio 2008 を起動します。
[ファイル] メニューの [新規作成]、[プロジェクト] の順に選択します。
新しいプロジェクト ダイアログボックスで以下を実行します。
- プロジェクトの種類として [Visual C#] を選択します。
- テンプレートとして [クラスライブラリ] を選択します。
- プロジェクトの名前として「FtpHomeDirectoryDemo」と入力します。
- OK をクリックします。
プロジェクトが開いたら、FTP 機能拡張ライブラリへの参照パスを追加します。
- [プロジェクト] を選択し、[FtpHomeDirectoryDemo Properties] (FtpHomeDirectoryDemo プロパティ) を選択します。
- [参照パス] タブをクリックします。
- Windows のバージョンの FTP 拡張機能アセンブリへのパスを入力します。C: はオペレーティングシステムドライブです。
  - Windows Server 2008 と Windows Vista の場合: C:\Windows\assembly\GAC\_MSIL\Microsoft.Web.FtpServer\7.5.0.0\_\_31bf3856ad364e35
  - Windows 7 の場合: C:\Program Files\Reference Assemblies\Microsoft\IIS
- [フォルダーの追加] をクリックします。
プロジェクトに厳密な名前のキーを追加します。
- [プロジェクト] を選択し、[FtpHomeDirectoryDemo Properties] (FtpHomeDirectoryDemo プロパティ) を選択します。
- [署名] タブをクリックします。
- [アセンブリの署名] チェックボックスをオンにします。
- 厳密なキー名のドロップダウンボックスから <[新規作成]> を選択します。
- キーファイル名として「FtpHomeDirectoryDemoKey」と入力します。
- 必要に応じて、キーファイルのパスワードを入力します。それ以外の場合は、[Protect my key file with a password] (パスワードでキーファイルを保護する) チェックボックスをオフにします。
- OK をクリックします。
省略可能: カスタムビルドイベントを追加して、開発用コンピューターのグローバルアセンブリキャッシュ (GAC) に DLL を自動的に追加できます。
- [プロジェクト] を選択し、[FtpHomeDirectoryDemo Properties] (FtpHomeDirectoryDemo プロパティ) を選択します。
- [ビルドイベント] タブをクリックします。
- [ビルド後に実行するコマンドライン] ダイアログボックスに、次のように入力します。
```
net stop ftpsvc
call "%VS90COMNTOOLS%\vsvars32.bat">null
gacutil.exe /if "$(TargetPath)"
net start ftpsvc
```
プロジェクトを [保存] します。

手順 2: 機能拡張クラスを作成する

この手順では、デモプロバイダーの機能拡張インターフェイスを実装します。

プロジェクトの FTP 機能拡張ライブラリへの参照を追加します。
- [プロジェクト] をクリックし、[参照の追加] をクリックします
- [.NET] タブで、[Microsoft.Web.FtpServer] をクリックします。
- OK をクリックします。
プロジェクトの System.Web への参照を追加します。
- [プロジェクト] をクリックし、[参照の追加] をクリックします
- [.NET] タブで、[System.Web] をクリックします。
- OK をクリックします。

認証クラスのコードを追加します。

ソリューションエクスプローラーで、[Class1.cs] ファイルをダブルクリックします。
既存のコードを削除します。

以下のコードをエディターに貼り付けます。

using System;
using Microsoft.Web.FtpServer;
 
namespace FtpHomeDirectory
{
    public class FtpHomeDirDemo : BaseProvider,
        IFtpHomeDirectoryProvider
    {
        string IFtpHomeDirectoryProvider.GetUserHomeDirectoryData(
            string sessionId,
            string siteName,
            string userName)
        {
            // Note: You would add your own custom logic here.
            // Return the user's home directory based on their user name.
            return @"C:\Ftpusers\" + userName;
        }
    }
}

プロジェクトを保存してコンパイルします。

Note

オプションの手順を使用してアセンブリを GAC に登録しなかった場合は、手動でアセンブリを IIS コンピューターにコピーし、Gacutil.exe ツールを使用してアセンブリを GAC に追加する必要があります。詳細については、「Gacutil.exe (グローバルアセンブリキャッシュツール)」を参照してください。

手順 3: ホームディレクトリプロバイダーの FTP への追加

この手順では、FTP サービスと既定の Web サイトにデモプロバイダーを追加します。

機能拡張プロバイダーのアセンブリ情報を確認します。
- Windows エクスプローラーで C:\Windows\assembly パスを開きます。C: はオペレーティングシステムドライブです。
- FtpHomeDirectoryDemo アセンブリを見つけます。
- アセンブリを右クリックし、[プロパティ] を選択します。
- カルチャ値 (例: Neutral) をコピーします。
- バージョン番号 (例: 1.0.0.0) をコピーします。
- Public Key Token 値 (例: 426f62526f636b73) をコピーします。
- [キャンセル] をクリックします。
機能拡張プロバイダーを FTP プロバイダーのグローバルリストに追加します。
- インターネットインフォメーションサービス (IIS) マネージャーを開きます。
- [接続] ウィンドウでコンピューター名を選択します。
- メインウィンドウで [FTP Authentication] をダブルクリックします。
- [操作] ウィンドウで [カスタムプロバイダー] を選択します。
- [登録] をクリックします。
- プロバイダーの [名前] として「FtpHomeDirectoryDemo」と入力します。
- [マネージドプロバイダー (.NET)] を選択します。
- 前にコピーした情報を使用して、拡張プロバイダーのアセンブリ情報を入力します。次に例を示します。
```
FtpHomeDirectory.FtpHomeDirDemo,FtpHomeDirectoryDemo,version=1.0.0.0,Culture=neutral,PublicKeyToken=426f62526f636b73
```
- OK をクリックします。
- プロバイダーの一覧の [FtpHomeDirectoryDemo] チェックボックスをオフにします。
- OK をクリックします。
カスタムプロバイダーをサイトに追加します。
- 現時点では、サイトにカスタム機能を追加できる UI がないため、次のコマンドラインを使用する必要があります。
```
AppCmd set site "Default Web Site" /+ftpServer.customFeatures.providers.[name='FtpHomeDirectoryDemo',enabled='true']
```
カスタムプロバイダーを使用するようにユーザー分離を構成します。
- 現時点では、ユーザー分離用のカスタム機能を指定できる UI がないため、次のコマンドラインを使用する必要があります。
```
AppCmd set site "Default Web Site" /ftpServer.userIsolation.mode:Custom
```

まとめ

このチュートリアルでは、次の方法を学習しました。

カスタム FTP ホームディレクトリプロバイダー用のプロジェクトを Visual Studio 2008 で作成する。
カスタム FTP ホームディレクトリ参照の機能拡張インターフェイスを実装する。
カスタムホームディレクトリプロバイダーを FTP サービスに追加する。

ユーザーが FTP サイトに接続すると、FTP サービスによって、各ユーザーのホームディレクトリがデモプロバイダーで指定したパスに設定されます。

次の方法で共有

マネージドコード (C#) を使用して単純な FTP ホームディレクトリプロバイダーを作成する方法

前提条件

手順 1: プロジェクト環境の設定

手順 2: 機能拡張クラスを作成する

手順 3: ホームディレクトリプロバイダーの FTP への追加

まとめ

フィードバック

その他のリソース

次の方法で共有

マネージド コード (C#) を使用して単純な FTP ホーム ディレクトリ プロバイダーを作成する方法

前提条件

手順 1: プロジェクト環境の設定

手順 2: 機能拡張クラスを作成する

手順 3: ホーム ディレクトリ プロバイダーの FTP への追加

まとめ

フィードバック

その他のリソース

マネージドコード (C#) を使用して単純な FTP ホームディレクトリプロバイダーを作成する方法

手順 3: ホームディレクトリプロバイダーの FTP への追加