共用方式為

概念 - 在 MIP SDK 中記錄

  • 發行項

針對取用 MIP SDK 的自定義應用程式進行疑難解答，一開始會檢查 mip 記錄。 MIP 記錄位置是在 MipContext 建立時設定，而且可以使用 *.miplog 擴展名來查詢。 Microsoft 應用程式和範例會將 MIP 記錄儲存在應用程式路徑\APP_DATA\mip_data。

遮罩 MIP 記錄中的敏感數據

MIP SDK 中的記錄不會遮罩機密內容，而客戶可能沒有額外的設定即可個人識別這些內容。

MIP SDK 記錄中的常見敏感數據：

  • 電子郵件名稱
  • 檔案名稱
  • 標籤名稱
  • IP 位址
  • MAC 位址

若要遮罩 MIP SDK 所產生的所有 miplog 檔案中的敏感性內容，請在組態.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 中設定

若要使用 MipConfiguration 來遮罩 MIP 記錄檔中的 PII，請建立新的 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);