診断データ
既定では、Microsoft Information Protection SDK は診断データを Microsoft に送信します。 このデータは、内部テストではキャプチャできない可能性がある SDK インストール ベース全体のバグ、品質、パフォーマンスの問題のトラブルシューティングに役立ちます。 SDK を使用してアプリケーションを実装する場合は、必要に応じて診断データの送信をオプトアウトする機能をユーザーと管理者に付与することが重要です。
診断構成
MIP SDK の診断オプションは、DiagnosticConfiguration を使用して制御できます。 このクラスのインスタンスを作成し、isMinimalTelemetryEnabled を true に設定します。 クラス DiagnosticConfiguration のオブジェクトを、MipContext の作成に使用される関数に提供します。
最小診断イベント
診断構成が最小に設定されている場合、最小データ セットが Microsoft に送信されます。 個人を特定できる情報はすべて、この情報から除去されます。 このデータには、SDK が使用されていることを理解するハートビート情報とシステム メタデータが含まれています。 ユーザー コンテンツまたはエンド ユーザー識別可能な情報はサービスに設定されません。
次の表を確認して、最小診断を有効にした場合に送信されるイベントとデータを正確に確認します。
イベント: ハートビート
| 名前 | 説明 | 除去 |
|---|---|---|
| App.ApplicationId | mip::ApplicationInfo を介して提供されるアプリケーション識別子。 | いいえ |
| App.ApplicationName | mip::ApplicationInfo を使用して提供されるアプリケーション名。 | いいえ |
| App.ApplicationVersion | mip::ApplicationInfo を介して提供されるアプリケーションのバージョン。 | いいえ |
| ApplicationId | mip::ApplicationInfo を介して提供されるアプリケーションのバージョン。 | いいえ |
| ApplicationName | mip::ApplicationInfo を使用して提供されるアプリケーション名。 | いいえ |
| CreationTime | イベントが生成された時刻。 | いいえ |
| DefaultLabel.Id | テナントの既定のラベル ID。 | いいえ |
| Engine.TenantId | 認証されたユーザーのホーム テナント GUID。 | いいえ |
| Engine.UserObjectId | Microsoft Entra ID のユーザー オブジェクト IDです。 | いいえ |
| Event.CorrelationId | イベントをトリガーしたオブジェクトに関連付けられる、生成された一意の ID。 | いいえ |
| Event.CorrelationIdDescription | イベントをトリガーしたオブジェクトの C++ クラス名。 | いいえ |
| Event.ParentCorrelationId | 親イベントの関連付け ID。 | いいえ |
| Event.ParentCorrelationIdDescription | イベントをトリガーしたオブジェクトの親に関連付けられる、生成された一意の ID。 | いいえ |
| Event.UniqueId | イベントに割り当てられる、生成された一意の ID。 | いいえ |
| MachineName | イベントを生成したシステムの名前。 | はい |
| MIP.Version | MIP SDK のバージョン。 | いいえ |
| 操作 | Heartbeat | いいえ |
| OrganizationId | 認証されたユーザーのホーム テナント GUID。 | いいえ |
| プラットフォーム | オペレーティング システムのバージョン。 | いいえ |
| ProcessName | SDK を使用するプロセスの名前。 | いいえ |
| ProductVersion | "App.ApplicationVersion" と同じです。 | いいえ |
| SDKVersion | MIP.Version と同じです。 | いいえ |
| UserId | ユーザーのメール アドレス。 | はい |
| UserObjectId | Microsoft Entra ユーザーのオブジェクト ID です。 | いいえ |
| バージョン | 監査バージョン スキーマ ("1.1")。 | いいえ |
イベント: 検出
| 名前 | 説明 | 除去 |
|---|---|---|
| ActionId | イベントの関連付けに使用される、このイベントの一意のアクション ID。 | いいえ |
| App.ApplicationId | mip::ApplicationInfo を介して提供されるアプリケーション識別子。 | いいえ |
| App.ApplicationName | mip::ApplicationInfo を使用して提供されるアプリケーション名。 | いいえ |
| App.ApplicationVersion | mip::ApplicationInfo を介して提供されるアプリケーションのバージョン。 | いいえ |
| ApplicationId | mip::ApplicationInfo を介して提供されるアプリケーションのバージョン。 | いいえ |
| ApplicationName | mip::ApplicationInfo を使用して提供されるアプリケーション名。 | いいえ |
| CreationTime | イベントが生成された時刻。 | いいえ |
| DataState | アプリケーションが動作するデータの状態。“REST”、“MOTION”、“USE”。 | いいえ |
| DefaultLabel.Id | テナントの既定のラベル識別子。 | いいえ |
| Engine.TenantId | 認証されたユーザーのホーム テナント GUID。 | いいえ |
| Engine.UserObjectId | Microsoft Entra ID のユーザー オブジェクト識別子です。 | いいえ |
| Event.CorrelationId | イベントをトリガーしたオブジェクトに関連付けられる、生成された一意の ID。 | いいえ |
| Event.CorrelationIdDescription | イベントをトリガーしたオブジェクトの C++ クラス名。 | いいえ |
| Event.ParentCorrelationId | 親イベントの関連付け ID。 | いいえ |
| Event.ParentCorrelationIdDescription | イベントをトリガーしたオブジェクトの親に関連付けられる、生成された一意の ID。 | いいえ |
| Event.UniqueId | イベントに割り当てられる、生成された一意の ID。 | いいえ |
| LabelId | 開いたファイルまたはデータのコンテンツ ラベル識別子。 | いいえ |
| MachineName | イベントを生成したシステムの名前。 | はい |
| MIP.Version | MIP SDK のバージョン。 | いいえ |
| ObjectId | ファイルまたはデータのファイル パス/説明。 | はい |
| 操作 | "検出"。 | いいえ |
| OrganizationId | 認証されたユーザーのホーム テナント GUID。 | いいえ |
| プラットフォーム | オペレーティング システムのバージョン。 | いいえ |
| ProcessName | SDK を使用するプロセスの名前。 | いいえ |
| Protected | ファイルが保護されるかどうかを示すブール。 | いいえ |
| 保護 | 保護テンプレート識別子。 | はい |
| ProtectionOwner | 保護所有者の電子メール アドレス。 | はい |
| SDKVersion | MIP.Version と同じです。 | いいえ |
| UserId | ユーザーのメール アドレス。 | はい |
| UserObjectId | Microsoft Entra ユーザーのオブジェクト ID です。 | いいえ |
| バージョン | 監査バージョン スキーマ ("1.1")。 | いいえ |
イベント: ラベルの変更
| 名前 | 説明 | 除去 |
|---|---|---|
| ActionId | イベントの関連付けに使用される、このイベントの一意のアクション ID。 | いいえ |
| ActionIdBefore | 以前のアクション ID。 新しいアクション ID にチェーンするために使用されます。 | いいえ |
| ActionSource | MIP::ActionSource の値。 | いいえ |
| App.ApplicationId | mip::ApplicationInfo を介して提供されるアプリケーション ID。 | いいえ |
| App.ApplicationName | mip::ApplicationInfo を使用して提供されるアプリケーション名。 | いいえ |
| App.ApplicationVersion | mip::ApplicationInfo を介して提供されるアプリケーションのバージョン。 | いいえ |
| ApplicationId | mip::ApplicationInfo を介して提供されるアプリケーション ID。 | いいえ |
| ApplicationName | mip::ApplicationInfo を使用して提供されるアプリケーション名。 | いいえ |
| CreationTime | イベントが生成された時刻。 | いいえ |
| DataState | アプリケーションが動作するデータの状態。“REST”、“MOTION”、“USE”。 | いいえ |
| DefaultLabel.Id | テナントの既定のラベル識別子。 | いいえ |
| Engine.TenantId | 認証されたユーザーのホーム テナント GUID。 | いいえ |
| Engine.UserObjectId | Microsoft Entra ID のユーザー オブジェクト識別子です。 | いいえ |
| Event.CorrelationId | イベントをトリガーしたオブジェクトに関連付けられる、生成された一意の ID。 | いいえ |
| Event.CorrelationIdDescription | イベントをトリガーしたオブジェクトの C++ クラス名。 | いいえ |
| Event.ParentCorrelationId | 親イベントの関連付け ID。 | いいえ |
| Event.ParentCorrelationIdDescription | イベントをトリガーしたオブジェクトの親に関連付けられる、生成された一意の ID。 | いいえ |
| Event.UniqueId | イベントに割り当てられる、生成された一意の ID。 | いいえ |
| IsLabelChanged | ラベルが変更されたかどうかを示すブール。 | いいえ |
| IsProtectionChanged | 保護が変更されたかどうかを示すブール。 | いいえ |
| LabelId | ファイルまたはデータに適用されるラベル ID。 | いいえ |
| LabelIdBefore | ファイルまたはデータに付けられていた以前のラベル ID。 | いいえ |
| MachineName | イベントを生成したシステムの名前。 | はい |
| MIP.Version | MIP SDK のバージョン。 | いいえ |
| ObjectId | ファイルまたはデータのファイル パス/説明。 | はい |
| 操作 | "変更"。 | いいえ |
| OrganizationId | 認証されたユーザーのホーム テナント GUID。 | いいえ |
| プラットフォーム | オペレーティング システムのバージョン。 | いいえ |
| ProcessName | SDK を使用するプロセスの名前。 | いいえ |
| 製品バージョン | いいえ | |
| Protected | ファイルが保護されるかどうかを示すブール。 | いいえ |
| Protected Before | ファイルが以前に保護されたかどうかを示すブール。 | いいえ |
| 保護 | 保護テンプレート識別子。 | いいえ |
| Protection Before | 以前の保護テンプレート識別子。 | いいえ |
| ProtectionContentId | 新しいコンテンツ識別子 (GUID)。 | いいえ |
| ProtectionContentIdBefore | 以前のコンテンツ識別子 (GUID)。 | いいえ |
| ProtectionOwner | 保護所有者の電子メール アドレス。 | はい |
| ProtectionOwnerBefore | 保護所有者の以前の電子メール アドレス。 | はい |
| SDKVersion | MIP.Version と同じです。 | いいえ |
| UserId | ユーザーのメール アドレス。 | はい |
| UserObjectId | Microsoft Entra ユーザーのオブジェクト ID です。 | いいえ |
| バージョン | 監査バージョン スキーマ ("1.1")。 | いいえ |
C++ でのオプトアウト
診断を最小のみに設定するには mip::DiagnosticConfiguration() の共有ポインターを作成し、isMinimalTelemetryEnabled を true に設定します。 オブジェクトを MipConfiguration::SetDiagnosticConfiguration() に渡し、MipConfiguration を使用して MipContext を生成します。
auto diagnosticConfig = std::make_shared<mip::DiagnosticConfiguration>();
diagnosticConfig->isMinimalTelemetryEnabled = true;
// Create MipConfiguration.
// Initialize MipConfiguration.
std::shared_ptr<mip::MipConfiguration> mipConfiguration = std::make_shared<mip::MipConfiguration>(mAppInfo,
"file_sample",
mip::LogLevel::Trace,
false);
// Set DiagnosticConfig
mipConfiguration->SetDiagnosticConfiguration(diagnosticConfig);
mMipContext = mip::MipContext::Create(mipConfiguration);
.NET でのオプトアウト
診断データを最小のみに設定するには DiagnosticConfiguration() オブジェクトを作成し、isMinimalTelemetryEnabled を true に設定します。 MipConfiguration の DiagnosticOverride プロパティを設定し、MipContext を作成します。
DiagnosticConfiguration diagnosticConfiguration = new DiagnosticConfiguration();
diagnosticConfiguration.IsMinimalTelemetryEnabled = true;
// Create MipConfiguration.
MipConfiguration mipConfiguration = new MipConfiguration(appInfo, "mip_data", LogLevel.Trace, false);
// Set Diagnostic Override.
mipConfiguration.DiagnosticOverride = diagnosticConfiguration;
// Create MipContext.
MipContext mipContext = MIP.CreateMipContext(mipConfiguration);