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

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

注

このクイックスタートで説明する手順は、MIP .NET ラッパーのファイル、ポリシー、または保護 SDK を使用するすべてのクライアントアプリケーションに必要です。このクイックスタートではファイル SDK の使用方法を示しますが、ポリシー SDK と保護 SDK を使用するクライアントにも同じパターンが適用されます。今後のクイックスタートは、それぞれが前のクイックスタートに基づいて構築されており、これが最初のものになっているので、順次実行する必要があります。このコードは、MIP SDK の使用を開始する方法を示すことを目的としており、 運用環境での使用を目的としたものではありません。

[前提条件]

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

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

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

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

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

認証デリゲートを実装する

MIP SDK は、クラス拡張を使用して認証を実装します。この機能は、認証作業をクライアントアプリケーションと共有するメカニズムを提供します。クライアントは、適切な OAuth2 アクセストークンを取得し、実行時に MIP SDK に提供する必要があります。

次に、SDK の Microsoft.InformationProtection.IAuthDelegate インターフェイスを拡張し、 IAuthDelegate.AcquireToken() 仮想関数をオーバーライド/実装することで、認証デリゲートの実装を作成します。認証デリゲートはインスタンス化され、後で FileProfile および FileEngine オブジェクトによって使用されます。

Visual Studio でプロジェクト名を右クリックし、[ 追加] 、[ クラス] の順に選択します。
[名前] フィールドに「AuthDelegateImplementation」と入力します。追加をクリックします。
Microsoft 認証ライブラリ (MSAL) と MIP ライブラリの using ステートメントを追加します。
```
using Microsoft.InformationProtection;
using Microsoft.Identity.Client;
```
AuthDelegateImplementationを設定してMicrosoft.InformationProtection.IAuthDelegateを継承し、Microsoft.InformationProtection.ApplicationInfoのプライベート変数と同じ型を受け入れるコンストラクターを実装します。
```
public class AuthDelegateImplementation : IAuthDelegate
{
   private ApplicationInfo _appInfo;
   // Microsoft Authentication Library IPublicClientApplication
   private IPublicClientApplication _app;
   public AuthDelegateImplementation(ApplicationInfo appInfo)
   {
       _appInfo = appInfo;
   }

}
```
ApplicationInfo オブジェクトには、3 つのプロパティが含まれています。 _appInfo.ApplicationIdは、AuthDelegateImplementation クラスでクライアント ID を認証ライブラリに提供するために使用されます。 ApplicationName と ApplicationVersion は、Microsoft Purview 監査レポートに表示されます。

public string AcquireToken() メソッドを追加します。このメソッドは、必要に応じて、 Microsoft.InformationProtection.Identity と 3 つの文字列 (機関 URL、リソース URI、要求) を受け入れる必要があります。これらの文字列変数は API によって認証ライブラリに渡されるため、操作しないでください。テナントの Azure portal からテナント GUID を入力してください。テナント GUID 以外の文字列を編集すると、認証に失敗する可能性があります。

public string AcquireToken(Identity identity, string authority, string resource, string claims)
{
   var authorityUri = new Uri(authority);
   authority = String.Format("https://{0}/{1}", authorityUri.Host, "<Tenant-GUID>");

   _app = PublicClientApplicationBuilder.Create(_appInfo.ApplicationId).WithAuthority(authority).WithDefaultRedirectUri().Build();
   var accounts = (_app.GetAccountsAsync()).GetAwaiter().GetResult();

   // Append .default to the resource passed in to AcquireToken().
   string[] scopes = new string[] { resource[resource.Length - 1].Equals('/') ? $"{resource}.default" : $"{resource}/.default" };
   var result = _app.AcquireTokenInteractive(scopes).WithAccount(accounts.FirstOrDefault()).WithPrompt(Prompt.SelectAccount)
              .ExecuteAsync().ConfigureAwait(false).GetAwaiter().GetResult();

   return result.AccessToken;
}

次に、SDK の Microsoft.InformationProtection.IConsentDelegate インターフェイスを拡張し、 GetUserConsent()をオーバーライド/実装することで、同意デリゲートの実装を作成します。同意デリゲートは、ファイルプロファイルオブジェクトとファイルエンジンオブジェクトによって後でインスタンス化され、使用されます。同意デリゲートには、ユーザーが url パラメーターで使用するために同意する必要があるサービスのアドレスが提供されます。通常、代理人は、サービスへのアクセスに対する同意をユーザーが受け入れるか拒否できるようにするフローを提供する必要があります。このクイックスタートでは、ハードコード Consent.Accept。

前に使用したのと同じ Visual Studio の "クラスの追加" 機能を使用して、別のクラスをプロジェクトに追加します。今回は、[ クラス名] フィールドに「ConsentDelegateImplementation」と入力します。
次に、ConsentDelegateImpl.csを更新して、新しい同意デリゲートクラスを実装します。 Microsoft.InformationProtectionの using ステートメントを追加し、IConsentDelegateを継承するようにクラスを設定します。
```
class ConsentDelegateImplementation : IConsentDelegate
{
     public Consent GetUserConsent(string url)
     {
          return Consent.Accept;
     }
}
```
必要に応じて、ソリューションをビルドして、エラーなしでコンパイルされるようにします。

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

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

using System;
using System.Threading.Tasks;
using Microsoft.InformationProtection;
using Microsoft.InformationProtection.Exceptions;
using Microsoft.InformationProtection.File;
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 File SDK operations
            MIP.Initialize(MipComponent.File);
            
        }
    }
}

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

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

using System;
using System.Threading.Tasks;
using Microsoft.InformationProtection;
using Microsoft.InformationProtection.File;

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 File SDK operations.
            MIP.Initialize(MipComponent.File);

            // Create ApplicationInfo, setting the clientID from Microsoft Entra 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);

            // Create MipContext using Configuration
            MipContext mipContext = MIP.CreateMipContext(mipConfiguration);

            // Initialize and instantiate the File Profile.
            // Create the FileProfileSettings object.
            // Initialize file profile settings to create/use local state.
            var profileSettings = new FileProfileSettings(mipContext,
                                     CacheStorageType.OnDiskEncrypted,
                                     new ConsentDelegateImplementation());

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

            // Create a FileEngineSettings object, then use that to add an engine to the profile.
            // This pattern sets the engine ID to user1@tenant.com, then sets the identity used to create the engine.
            var engineSettings = new FileEngineSettings("user1@tenant.com", authDelegate, "", "en-US");
            engineSettings.Identity = new Identity("user1@tenant.com");

            var fileEngine = Task.Run(async () => await fileProfile.AddEngineAsync(engineSettings)).Result;

            // Application Shutdown
            // handler = null; // This will be used in later quick starts.
            fileEngine = null;
            fileProfile = null;
            mipContext.ShutDown();
            mipContext = null;
       }
  }
}

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

Placeholder	価値	Example
<application-id>	"MIP SDK のセットアップと構成" に登録されているアプリケーションに割り当てられた Microsoft Entra アプリケーション ID (2 つのインスタンス)。	0edbblll-8773-44de-b87c-b8c6276d41eb
<friendly-name>	アプリケーションのユーザー定義のフレンドリ名。	AppInitialization
<Tenant-GUID>	Microsoft Entra テナントの Tenant-ID	TenantID

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

次のステップ

初期化コードが完了したら、次のクイックスタートに向けて準備が整いました。ここでは、MIP ファイル SDK の使用を開始します。

秘密度ラベルを一覧表示する

フィードバック

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

Last updated on 2025-08-19

次の方法で共有

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

[前提条件]

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

認証デリゲートを実装する

同意デリゲートを実装する

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

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

次のステップ

フィードバック

その他のリソース

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

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

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