概念 - MIP SDK でのログ記録

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

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

MIP SDK のログは、マスクを構成しない限り、顧客を個人的に識別する可能性のある機密コンテンツをマスクしません。

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

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

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

構成ファイル

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

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

この設定を構成すると、MIP SDK によってすべての新しい MIP ログ内の機密コンテンツがマスクされます。

MipConfiguration で構成する

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

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

auto mipConfiguration = make_shared<mip::MipConfiguration>(appInfo, "mip_data", mip::LogLevel::Trace, false, mip::CacheStorageType::OnDisk);
    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, CacheStorageType.OnDiskEncrypted);
  mipConfiguration.LoggerConfigurationOverride = new LoggerConfiguration(10, 40, false);
  var mipContext = MIP.CreateMipContext(mipConfiguration);
  • 最終更新: