MIP SDK での監査

Microsoft Purview ポータルでは、アクティビティ エクスプローラーを使用して監査レポートにアクセスできます。 これらのレポートでは、MIP SDK を統合するアプリケーション全体で、ユーザーが手動または自動で適用するラベルが表示されます。 SDK を使用する開発パートナーは、この機能を有効にすることができます。これにより、アプリケーションからの情報が顧客レポートに表示されます。

イベントの種類

SDK は、ハートビート イベント、検出イベント、変更イベントの 3 種類の監査イベントを送信できます。

ハートビート イベント

SDK は、Policy SDK を統合するすべてのアプリケーションのハートビート イベントを自動的に生成します。 ハートビート イベントには次のものが含まれます。

  • テナント識別子
  • 生成時刻
  • ユーザー プリンシパル名
  • 監査を生成したマシンの名前
  • プロセス名
  • プラットホーム
  • アプリケーション ID - Microsoft Entra アプリケーション ID に対応します

これらのイベントは、Microsoft Information Protection SDK を使用する企業全体のアプリケーションを検出する場合に役立ちます。

検出イベント

検出イベントは、Policy SDK が読み取りまたは使用するラベル付きコンテンツに関する情報を提供します。 これらのイベントは、組織全体の情報にアクセスするデバイス、場所、ユーザーを表示するのに役立ちます。

Policy SDK で検出イベントを生成するには、 mip::PolicyHandler オブジェクトを作成するときにフラグを設定します。 次の例では、 isAuditDiscoveryEnabled の値が true に設定されています。 mip::ExecutionStateを (既存のメタデータ情報とコンテンツ識別子を使用して) ComputeActions()またはGetSensitivityLabel()に渡すと、SDK はアクティビティ エクスプローラー Microsoft Purview探索情報を送信します。

SDK は、アプリケーションが ComputeActions() または GetSensitivityLabel() を呼び出した後に検出監査を生成し、 mip::ExecutionStateを提供します。 SDK では、ハンドラーごとに 1 回だけこのイベントが生成されます。

実行状態の詳細については、 mip::ExecutionState の概念に関するドキュメントを参照してください。

// Create PolicyHandler, passing in true for isAuditDiscoveryEnabled
auto handler = mEngine->CreatePolicyHandler(true);

// Returns vector of mip::Action and generates discovery event.
auto actions = handler->ComputeActions(*state);

//Or, get the label for a given state
auto label = handler->GetSensitivityLabel(*state);

実際には、isAuditDiscoveryEnabled をmip::PolicyHandler構築中にtrueに設定して、ファイル アクセス情報をアクティビティ エクスプローラーにフローできるようにします。

変更イベント

変更イベントは、ファイル、適用または変更されたラベル、およびユーザーが提供する理由に関する情報を提供します。 変更イベントを生成するには、mip::PolicyHandlerでNotifyCommittedActions()を呼び出します。 アプリケーションがファイルへの変更を正常にコミットし、アクションを計算した mip::ExecutionState を渡した後、呼び出しを行います。

Note

アプリケーションがこの関数の呼び出しに失敗した場合、監査イベントは送信されません。

handler->NotifyCommittedActions(*state);

監査ダッシュボード

SDK によって送信された監査イベントは、Microsoft Purviewアクティビティ エクスプローラーで使用できます。

次のステップ

  • 最終更新: