クイックスタート: 保護 SDK のクライアントアプリケーションの初期化 (C#)

このクイックスタートでは、MIP SDK .NET ラッパーが実行時に使用するクライアント初期化パターンを実装する方法について説明します。

注

MIP .NET ラッパーの Protection SDK を使用するすべてのクライアントアプリケーションには、このクイックスタートの手順が必要です。アプリケーションの初期化と認証デリゲートクラスと同意デリゲートクラスの実装後に、これらのクイックスタートを順次実行します。

[前提条件]

まだ行っていない場合は、次の手順を実行してください。

Microsoft Information Protection (MIP) SDK のセットアップと構成の手順を完了します。この "保護プロファイルとエンジンのセットアップ" クイックスタートは、適切な SDK のセットアップと構成に依存します。
必要に応じて：
- プロファイルオブジェクトとエンジンオブジェクトを確認します。プロファイルオブジェクトとエンジンオブジェクトは、MIP ファイル/ポリシー/保護 SDK を使用するクライアントに必要なユニバーサル概念です。
- 認証の概念を確認して、SDK とクライアントアプリケーションによって認証と同意がどのように実装されるかを学習します。

Visual Studio ソリューションとプロジェクトを作成する

最初に、他のクイックスタートで構築されている初期Visual Studio ソリューションとプロジェクトを作成して構成します。

Visual Studio 2022 以降を開き、[ ファイル ] メニューの [ 新規作成]、[ プロジェクト] の順に選択します。 [ 新しいプロジェクト ] ダイアログで、次の手順を実行します。
- 左側のウィンドウの [ インストール済み、 Visual C#] で、[ Windows デスクトップ] を選択します。
- 中央のウィンドウで、コンソールアプリ (.NET Framework) を選択します。
- 下部のウィンドウで、プロジェクト名、場所、および含まれている ソリューション名 を適宜更新します。
- 完了したら、右下隅の [OK] を選択します 。
MIP Protection SDK の NuGet パッケージをプロジェクトに追加します。
- ソリューションエクスプローラーで、上部のソリューションノードのすぐ下にあるプロジェクトノードを右クリックし、[NuGet パッケージの管理]を選択します。..:
- [エディターグループ] タブ領域で [NuGet パッケージマネージャー ] タブが開いたとき:
  - を選択し、を参照します。
  - 検索ボックスに、Microsoft.InformationProtection と入力します。
  - Microsoft.InformationProtection.Protection パッケージを選択します。
  - [インストール] を選択し、[プレビューの変更の確認] ダイアログが表示されたら [OK] を選択します。
前の手順を繰り返しますが、代わりに Microsoft.Identity.Client (MSAL) をアプリケーションに追加します。

まだ実装されていない場合は、 File SDK アプリケーションの初期化に記載されている手順に従って、認証と同意のデリゲートを実装します。

MIP SDK マネージドラッパーを初期化する

ソリューションエクスプローラーで、Main() メソッドの実装を含むプロジェクト内の.cs ファイルを開きます。既定の名前は、それが含まれるプロジェクトと同じであり、プロジェクトの作成時に指定したものです。
生成された main()の実装を削除します。
マネージドラッパーには、初期化、MipContextの作成、プロファイルの読み込み、リソースの解放のための静的クラスMicrosoft.InformationProtection.MIPが含まれています。 Protection SDK 操作のラッパーを初期化するには、 MIP.Initialize() を呼び出し、 MipComponent.Protection 渡して保護操作に必要なライブラリを読み込みます。
Program.csのMain()で、次のコードを追加します。<application-id> は、前に作成したMicrosoft Entra アプリケーション登録の ID に置き換えます。

using System;
using System.Threading.Tasks;
using Microsoft.InformationProtection;
using Microsoft.InformationProtection.Exceptions;
using Microsoft.InformationProtection.Protection;

namespace mip_sdk_dotnet_quickstart
{
    class Program
    {
        private const string clientId = "<application-id>";
        private const string appName = "<friendly-name>";

        static void Main(string[] args)
        {
            //Initialize Wrapper for Protection SDK operations
            MIP.Initialize(MipComponent.Protection);
        }
    }
}

保護プロファイルとエンジンを構築する

前述のように、MIP API を使用する SDK クライアントにはプロファイルオブジェクトとエンジンオブジェクトが必要です。ネイティブ DLL を読み込むコードを追加し、プロファイルとエンジンオブジェクトをインスタンス化して、このクイックスタートのコーディング部分を完了します。

using System;
using System.Threading.Tasks;
using Microsoft.InformationProtection;
using Microsoft.InformationProtection.Exceptions;
using Microsoft.InformationProtection.Protection;

namespace mip_sdk_dotnet_quickstart
{
     class Program
     {
          private const string clientId = "<application-id>";
          private const string appName = "<friendly-name>";

          static void Main(string[] args)
          {
               // Initialize Wrapper for Protection SDK operations.
               MIP.Initialize(MipComponent.Protection);

               // Create ApplicationInfo, setting the clientID from Azure AD App Registration as the ApplicationId.
               ApplicationInfo appInfo = new ApplicationInfo()
               {
                    ApplicationId = clientId,
                    ApplicationName = appName,
                    ApplicationVersion = "1.0.0"
               };

               // Instantiate the AuthDelegateImpl object, passing in AppInfo.
               AuthDelegateImplementation authDelegate = new AuthDelegateImplementation(appInfo);

               // Create MipConfiguration Object
               MipConfiguration mipConfiguration = new MipConfiguration(appInfo, "mip_data", LogLevel.Trace, false, CacheStorageType.OnDiskEncrypted);

               // Create MipContext using Configuration
               MipContext mipContext = MIP.CreateMipContext(mipConfiguration);
                
               // Initialize and instantiate the ProtectionProfile.
               // Create the ProtectionProfileSettings object.
               // Initialize protection profile settings to create/use local state.
               var profileSettings = new ProtectionProfileSettings(mipContext,
                                        CacheStorageType.OnDiskEncrypted,                                        
                                        new ConsentDelegateImplementation());

               // Load the Profile async and wait for the result.
               var protectionProfile = Task.Run(async () => await MIP.LoadProtectionProfileAsync(profileSettings)).Result;

               // Create a ProtectionEngineSettings object, then use that to add an engine to the profile.
               var engineSettings = new ProtectionEngineSettings("user1@tenant.com", authDelegate, "", "en-US");
               engineSettings.Identity = new Identity("user1@tenant.com");
               var protectionEngine = Task.Run(async () => await protectionProfile.AddEngineAsync(engineSettings)).Result;

               // Application Shutdown
               // handler = null; // This will be used in later quick starts.
               protectionEngine = null;
               protectionProfile = null;
               mipContext = null;
          }
     }
}

次の値を使用して、貼り付けたソースコードのプレースホルダーの値を置き換えます。

プレースホルダー	価値	例
<application-id>	"MIP SDK のセットアップと構成" に登録されているアプリケーションに割り当てられた Microsoft Entra アプリケーション ID (2 つのインスタンス)。	00001111-aaaa-2222-bbbb-3333cccc4444
<フレンドリーネーム>	アプリケーションのユーザー定義のフレンドリ名。	アプリ初期化

次に、アプリケーションの最終的なビルドを行い、エラーを解決します。コードが正常にビルドされます。

次のステップ

初期化コードが完了したら、次のクイックスタートに進み、MIP Protection SDK の使用を開始できます。

保護テンプレートを一覧表示する

GitHubの MIP Protection SDK .NET サンプルを確認します。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-09-21

クイック スタート: 保護 SDK のクライアント アプリケーションの初期化 (C#)