クイックスタート: List Protection テンプレート (C++)

2025-04-18

このクイックスタートでは、MIP Protection SDK を使用して、ユーザーが使用できる保護テンプレートを使用する方法について説明します。

[前提条件]

まだ行っていない場合は、続行する前に次の前提条件を満たしていることを確認してください。

クイックスタート - クライアントアプリケーションの初期化 - 保護 SDK (C++) を最初に実行します。これは、スターター Visual Studio ソリューションを構築します。この "リスト保護テンプレート" クイックスタートでは、スターターソリューションを適切に作成するために、前のテンプレートに依存しています。
必要に応じて、 RMS テンプレートの概念を確認します。

保護テンプレートを一覧表示するロジックを追加する

保護エンジンオブジェクトを使用して、ユーザーが使用できる保護テンプレートを一覧表示するロジックを追加します。

前の「クイックスタート - クライアントアプリケーションの初期化 - 保護 SDK (C++)」の記事で作成した Visual Studio ソリューションを開きます。
ソリューションエクスプローラーを使用して、main() メソッドの実装を含む.cpp ファイルをプロジェクトで開きます。デフォルトでは、プロジェクト作成時に指定した名前と同じ名前が、それを含むプロジェクトに設定されます。
using mip::ProtectionEngine;の後、ファイルの先頭付近に次のusing ディレクティブを追加します。
```
using std::endl;
```

main() 本体の末尾付近の最後の catch ブロックの右中かっこ } の下、return 0; の上 (先行するクイックスタートで終えた場所) に次のコードを挿入します。

 // List protection templates
 const shared_ptr<ProtectionEngineObserver> engineObserver = std::make_shared<ProtectionEngineObserver>();
 // Create a context to pass to 'ProtectionEngine::GetTemplateListAsync'. That context will be forwarded to the
 // corresponding ProtectionEngine::Observer methods. In this case, we use promises/futures as a simple way to detect
 // the async operation completes synchronously.
 auto loadPromise = std::make_shared<std::promise<vector<shared_ptr<mip::TemplateDescriptor>>>>();
 std::future<vector<shared_ptr<mip::TemplateDescriptor>>> loadFuture = loadPromise->get_future();
 engine->GetTemplatesAsync(engineObserver, loadPromise);
 auto templates = loadFuture.get();

 cout << "*** Template List: " << endl;

 for (const auto& protectionTemplate : templates) {
     cout << "Name: " << protectionTemplate->GetName() << " : " << protectionTemplate->GetId() << endl;
 }

アクセストークンを生成する PowerShell スクリプトを作成する

次の PowerShell スクリプトを使用してアクセストークンを生成します。アクセストークンは、 AuthDelegateImpl::AcquireOAuth2Token 実装で SDK によって要求されます。このスクリプトでは、前にインストールした ADAL.PS モジュールの "MIP SDK のセットアップと構成" の Get-ADALToken コマンドレットを使用します。

PowerShell スクリプトファイル (拡張子.ps1) を作成し、次のスクリプトをコピーしてファイルに貼り付けます。

$authority と $resourceUrl は、後のセクションで更新されます。
Microsoft Entra アプリの登録で指定した値と一致するように、 $appId と $redirectUriを更新します。

$authority = '<authority-url>'                   # Specified when SDK calls AcquireOAuth2Token()
$resourceUrl = '<resource-url>'                  # Specified when SDK calls AcquireOAuth2Token()
$appId = '<app-ID>'                              # App ID of the Azure AD app registration
$redirectUri = '<redirect-uri>'                  # Redirect URI of the Azure AD app registration
$response = Get-ADALToken -Resource $resourceUrl -ClientId $appId -RedirectUri $redirectUri -Authority $authority -PromptBehavior:RefreshSession
$response.AccessToken | clip                     # Copy the access token text to the clipboard

後でクライアントアプリケーションから要求されたときに実行できるように、スクリプトファイルを保存します。

アプリケーションのビルドとテスト

最後に、クライアントアプリケーションをビルドしてテストします。

Ctrl + Shift + b (ソリューションのビルド) を使用して、クライアントアプリケーションをビルドします。ビルドエラーがない場合は、F5 (デバッグの開始) を使用してアプリケーションを実行します。
プロジェクトが正常にビルドされて実行されると、SDK が AcquireOAuth2Token() メソッドを呼び出すたびに、アプリケーションによってアクセストークンの入力が求められます。複数回プロンプトが表示され、要求された値が同じ場合は、以前に生成されたトークンを再利用できます。
プロンプトのアクセストークンを生成するには、PowerShell スクリプトに戻り、次の操作を行います。
- $authority変数と$resourceUrl変数を更新します。これらは、手順 2 のコンソール出力で指定された値と一致する必要があります。
- PowerShell スクリプトを実行します。 Get-ADALToken コマンドレットは、次の例のように Microsoft Entra 認証プロンプトをトリガーします。手順 2 のコンソール出力で指定したのと同じアカウントを指定します。サインインに成功すると、アクセストークンがクリップボードに配置されます。
- サインインアカウントで実行中に、アプリケーションが MIP API にアクセスできるようにするために、同意が必要になる場合もあります。これは、Microsoft Entra アプリケーションの登録が事前に同意されていない場合 (「MIP SDK のセットアップと構成」で説明されているように)、または別のテナント (アプリケーションが登録されているテナント以外) のアカウントでサインインしている場合に発生します。同意を記録するには、[ 承諾 ] をクリックするだけです。

手順 2 のプロンプトにアクセストークンを貼り付けた後、次の例のように、コンソール出力に保護テンプレートが表示されます。

*** Template List:
Name: Confidential \ All Employees : a74f5027-f3e3-4c55-abcd-74c2ee41b607
Name: Highly Confidential \ All Employees : bb7ed207-046a-4caf-9826-647cff56b990
Name: Confidential : 174bc02a-6e22-4cf2-9309-cb3d47142b05
Name: Contoso Employees Only : 667466bf-a01b-4b0a-8bbf-a79a3d96f720

C:\MIP Sample Apps\ProtectionQS\Debug\ProtectionQS.exe (process 8252) exited with code 0.
To automatically close the console when debugging stops, enable Tools->Options->Debugging->Automatically close the console when debugging stops.

Press any key to continue . . .

注

次のクイックスタートで使用するように、1 つ以上の保護テンプレート ( f42a3342-8706-4288-bd31-ebb85995028z など) の ID をコピーして保存します。

トラブルシューティング

C++ アプリケーションの実行中の問題

概要	エラーメッセージ	解決策
不正なアクセストークン	例外が発生しました...アクセストークンが正しくないか、有効期限が切れていますか? 失敗した API 呼び出し: profile_add_engine_async失敗しました。[class mip::P olicySyncException] ポリシーの取得に失敗しました。要求は http 状態コード 401、x-ms-diagnostics: [2000001; で失敗しました。reason="要求と共に送信された OAuth トークンは解析できません。"error_category="invalid_token"], correlationId:[35bc0023-3727-4eff-8062-000006d5d672]' C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (プロセス 29924) がコード 0 で終了しました。このウィンドウを閉じるには、任意のキーを押します。 . .	プロジェクトが正常にビルドされていても、左側のような出力が表示される場合は、 `AcquireOAuth2Token()` メソッドに無効なトークンまたは期限切れのトークンが含まれている可能性があります。 PowerShell スクリプトの作成に戻り、アクセストークンを生成してアクセストークンを再生成し、`AcquireOAuth2Token()`をもう一度更新し、再構築/再テストします。 jwt.ms シングルページ Web アプリケーションを使用して、トークンとその要求を調べて確認することもできます。

次のステップ

認証されたユーザーが使用できる保護テンプレートを一覧表示する方法を学習したので、次のクイックスタートを試してください。

[テキストの暗号化と暗号化解除](quick-protection-encrypt-decrypt text-cpp.md)

次の方法で共有

クイック スタート: List Protection テンプレート (C++)