概念 - MIP SDK でのログ記録

MIP SDK を使用するカスタム アプリケーションのトラブルシューティングは、まずミップ ログの検査から始まります。 MIP ログの場所は MipContext の作成時に構成され、*.miplog ファイル拡張子を使用してクエリを実行できます。 Microsoftアプリとサンプルでは、MIP ログがアプリケーション パス\APP_DATA\mip_dataに格納されます。

MIP ログで機密データをマスクする

MIP SDK のログでは、追加の構成なしでお客様が個人を特定できる可能性がある機密コンテンツはマスクされません。

MIP SDK ログの一般的な機密データ:

  • 電子メール名
  • ファイル名
  • ラベル名
  • IP アドレス
  • MAC アドレス

MIP SDK によって生成されたすべてのミップログ ファイルの機密コンテンツをマスクするには、構成 .json ファイルに新しいフィールドを作成するか、MipConfiguration で構成します。

構成ファイル

構成ファイルは、MIP SDK でカスタム設定を構成するための推奨パスであり、サポートされているすべてのプラットフォームで使用できます。 MIP ログ ファイルで PII をマスクするには、次の方法を使用します。

  1. mip_config.jsonというカスタム設定用に MIP SDK からアクセスできる構成ファイルを作成し、そのファイルを次の MipConfiguration パスに格納します。
mipConfiguration->GetPath()/mip
  1. mip_config.jsonに新しいフィールドを追加して、AllowPii フィールドを false に設定します。
{"MipLogger":{"MaxLogFilesSizeMb":40,"MaxLogFileCount":10,"AllowPii":false}}

構成すると、MIP SDK によって生成されたすべての新しい MIP ログで機密性の高いコンテンツがマスクされます。

MipConfiguration で構成する

MIP ログ ファイルの PII を MipConfiguration でマスクするには、新しい MipConfiguration オブジェクトを作成して、カスタム設定の新しい値を使用して MipContext に渡します。

このメソッドは、C++ と C# でのみサポートされています。 代わりに、C API または Java ラッパーを使用する開発者は、構成ファイルを作成することをお勧めします。

auto mipConfiguration = make_shared<mip::MipConfiguration>(appInfo, "mip_data", mip::LogLevel::Trace, false);
    auto loggerConfiguration = make_shared<mip::LoggerConfiguration>();
    loggerConfiguration->isPiiAllowed = false;
    mipConfiguration->SetLoggerConfiguration(loggerConfiguration);
    auto mipContext = MipContext::Create(mipConfiguration);

MipConfiguration mipConfiguration = new MipConfiguration(appInfo, "mip_data", LogLevel.Trace, false);
  mipConfiguration.LoggerConfigurationOverride = new LoggerConfiguration(10, 40, false);
  var mipContext = MIP.CreateMipContext(mipConfiguration);
  • Last updated on