Windows プロトコル テスト スイート

Windows プロトコル テスト スイートは、ファイル サービス、ID 管理、リモート デスクトップなどを含む Windows オープン仕様の実装に対する相互運用性テストを提供します。

もともと Microsoft オープン仕様の社内テスト用に開発された Microsoft プロトコル テスト スイートは、Plugfest や相互運用性ラボでパートナーの実装に対してテストするために広く使用されてきました。 テスト スイートは、プロトコルまたはプロトコル ファミリの実装が特定の相互運用性要件を満たしているかどうかを評価します。 テスト スイートはすべてのプロトコル要件を網羅しているわけではなく、すべてのテストに合格したとしても実装を認定するものでは決してありません。 ただし、各テスト スイートは、相互運用性に関する有用な指標をユーザーに提供します。

• ファイル サーバー ファミリ テスト スイート。これは、[MS-SMB2]、[MS-DFSC]、[MS-SWN]、[MS-FSRVP]、[MS-FSA]、[MS-FSCC]、[MS-RSVD]、[MS-SQOS] を含むファイル サーバー プロトコル ファミリの実装をテストするように設計されています。 ファイル サーバー テスト スイートを開始するには、ファイル サーバー テスト スイート ユーザー ガイドを参照してください。使い捨ての Azure テスト環境を作成するには、ファイル サーバー Azure 自動デプロイを使用してください。
• RDP クライアント ファミリ テスト スイート。これは、[MS-RDPBCGR]、[MS-RDPEDISP]、[MS-RDPEDYC]、[MS-RDPEGFX]、[MS-RDPEGT]、[MS-RDPEI]、[MS-RDPEMT]、[MS-RDPEUDP]、[MS-RDPEUSB]、[MS-RDPEVOR]、[MS-RDPRFX] を含む RDP ファミリ プロトコルのクライアント実装に対する相互運用性テストを提供します。RDP クライアント テスト スイートを開始するには、RDP クライアント テスト スイート ユーザー ガイドを参照してください。
• RDP サーバー ファミリ テスト スイート。これは、[MS-RDPBCGR]、[MS-RDPEDYC]、[MS-RDPEMT]、[MS-RDPELE] を含む RDP ファミリ プロトコルのサーバー実装に対する相互運用性テストを提供します。RDP サーバー テスト スイートを開始するには、RDP サーバー テスト スイート ユーザー ガイドを参照してください。
• Kerberos サーバー テスト スイート。これは、[MS-KILE]、[MS-KKDCP]、[MS-PAC] を含む Kerberos プロトコルのサーバー実装をテストするように設計されています。Kerberos サーバー テスト スイートを開始するには、Kerberos サーバー テスト スイート ユーザー ガイドを参照してください。
• SMBD サーバー テスト スイート。これは、[MS-SMBD] および [MS-SMB2] で規定されている SMB2&3 ダイレクト (RDMA) プロトコルの実装をテストするように設計されています。SMBD サーバー テスト スイートを開始するには、SMBD サーバー テスト スイート ユーザー ガイドを参照してください。
• Branch Cache テスト スイート。これは、[MS-PCCRTP]、[MS-PCCRR]、[MS-PCHC]、[MS-PCCRC] プロトコルの実装をテストするように設計されています。Branch Cache テスト スイートを開始するには、Branch Cache テスト スイート ユーザー ガイドを参照してください。
• AZOD テスト スイート。これは、[MS-AZOD] プロトコルの実装をテストするように設計されています。AZOD テスト スイートを開始するには、AZOD テスト スイート ユーザー ガイドを参照してください。
• ADFamily テスト スイート。これは、[MS-ADA1]、[MS-ADA2]、[MS-ADA3]、[MS-ADLS]、[MS-ADSC]、[MS-ADTS]、[MS-APDS]、[MS-DRSR]、[MS-FRS2]、[MS-LSAD]、[MS-LSAT]、[MS-SAMR]、[MS-NRPC] を含む Active Directory プロトコルの実装をテストするように設計されています。ADFamily テスト スイートを開始するには、ADFamily テスト スイート ユーザー ガイドを参照してください。
• ADFSPIP クライアント テスト スイート。これは、[MS-ADFSPIP] で説明されている ADFS プロキシと Web アプリケーション プロキシの統合の実装をテストするように設計されています。ADFSPIP クライアント テスト スイートを開始するには、ADFSPIP クライアント テスト スイート ユーザー ガイドを参照してください。
• ADOD テスト スイート。これは、[MS-ADOD] プロトコルの実装をテストするように設計されています。ADOD テスト スイートを開始するには、ADOD テスト スイート ユーザー ガイドを参照してください。
• XCA テスト スイート。これは、[MS-XCA] プロトコルの実装をテストするように設計されています。XCA テスト スイートを開始するには、XCA テスト スイート ユーザー ガイドを参照してください。
• WSP テスト スイート。これは、[MS-WSP] プロトコルの実装をテストするように設計されています。WSP テスト スイートを開始するには、WSP テスト スイート ユーザー ガイドを参照してください。

コンポーネント

Windows プロトコル テスト スイートには以下のコンポーネントが含まれています:

• CommonScripts。各テスト スイートで使用される共通スクリプト。通常、環境のデプロイに使用されます。
• ProtoSDK。各テスト スイートで使用されるプロトコル ライブラリ。プロトコル メッセージのデータ構造、メッセージをエンコードおよびデコードするメソッド、メッセージを送受信するメソッドなどを提供します。
• TestSuites。すべてのテスト スイートのコードとドキュメントがここに保存され、各テスト スイートを表すフォルダーごとに分類されています。
• ProtocolTestManager。テスト スイートの構成と実行を支援するツール。

前提条件

Windows プロトコル テスト スイートは .NET に基づいているため、さまざまなプラットフォームで開発および実行できます。 テストの目的に応じて、以下に示すソフトウェアをそれぞれの依存関係も含めてインストールする必要があります。

1. .NET および関連コンポーネント

   a. Windows、Linux、macOS の場合、テスト スイートをビルドまたは実行するために .NET 8.0 SDK をインストールします。

   b. Windows で作業し、IDE を好む場合は、Visual Studio 2022 以降 (Visual Studio 2022 Community を推奨) を、インストーラーから以下の個別コンポーネントとともにインストールします:

   セクション	Visual Studio 2022 の個別コンポーネント	Windows プロトコル テスト スイートの実行	ソース コードからの Windows プロトコル テスト スイートのビルド
   .NET	.NET SDK	必須	必須
   コンパイラ、ビルド ツール、ランタイム	C# および Visual Basic Roslyn コンパイラ		必須
   コンパイラ、ビルド ツール、ランタイム	MSVC v143 - VS 2022 C++ x64/x86 ビルド ツール (最新)		必須1
   コンパイラ、ビルド ツール、ランタイム	v143 ビルド ツール用 C++/CLI サポート (最新)		必須1
   コンパイラ、ビルド ツール、ランタイム	C++ 2022 再頒布可能パッケージの更新	必須1	必須1
   開発アクティビティ	C++ コア機能		必須1
   SDK、ライブラリ、フレームワーク	Windows 10 SDK (10.0.19041.0)		必須1

   注:

[1]: この個別コンポーネントは、C++ コードを含む ADFamily および MS-SMBD で必要です。

1. Protocol Test Framework v2.6 (build 2.6.1)

   Protocol Test Framework は、ProtoSDK および TestSuites のプロジェクトから NuGet パッケージとして参照されます。

2. Network Direct DDK

   NetworkDirect_DDK.zip から ndspi.h と ndstatus.h をプロジェクト パス ProtoSDK\RDMA\include に展開します。これは SMBD テスト スイートをビルドするためです。

3. PowerShell Core

   これは、ユーザーが PowerShell Core Remoting over SSH を使用する場合にのみ必要です。

4. Win32-OpenSSH

   これは、ユーザーが Windows プラットフォームで PowerShell Core Remoting over SSH を使用する場合にのみ必要です。

5. WMF 5.1

   これは、ユーザーが CommonTestSuite.ptfconfig の ISutCommonControlAdapter に対して Windows Server 2012R2 で PowerShell 実装を使用する場合にのみ必要です。

   a. DC が Windows Server 2012R2 を実行しているドメイン環境で ISutCommonControlAdapter に PowerShell 実装を選択した場合、DC から SID を取得するために DC に WMF 5.1 をインストールする必要があります。Windows Server 2012R2 より新しい他の Windows Server バージョンでは、DC に WMF 5.1 をインストールする必要はありません。

   b. ワークグループ環境で Windows プラットフォーム (Windows Server 2012R2 以降を含む) 上の ISutCommonControlAdapter に PowerShell 実装を選択した場合、SUT に WMF 5.1 をインストールする必要はありません。

   c. Windows プラットフォーム (Windows Server 2012R2 以降を含む) 上の ISutCommonControlAdapter にマネージド実装を選択した場合、LDAP クエリを使用して SID を取得し、ドメイン環境のみをサポートします。

Windows で作業する場合、InstallPrerequisites フォルダー内のスクリプトを使用して、これらのソフトウェアを自動的にダウンロードしてインストールできます。

InstallPrerequisites フォルダー内のスクリプトを使用する際のヒント:

• スクリプトは一部の依存関係をダウンロードするためにインターネット接続が必要です。