Концепция. Ведение журнала в пакете SDK MIP

Устранение неполадок с пользовательскими приложениями, используюющими пакет SDK MIP, начинается с проверки журналов MIP. Вы настраиваете расположение журнала MIP при создании MipContextи можете запрашивать журналы с помощью *.miplog расширения файла. Приложения Microsoft и образцы хранят журналы MIP по адресу application path\APP_DATA\mip_data.

Маскирование конфиденциальных данных в журналах MIP

Журналы в пакете SDK MIP не маскируют конфиденциальное содержимое, которое может лично идентифицировать клиента, если вы не настроите маскирование.

Общие конфиденциальные данные в журналах пакета SDK для MIP:

• Имена электронной почты
• Имена файлов
• Названия меток
• IP-адреса
• MAC-адреса

Чтобы маскировать конфиденциальное содержимое во всех *.miplog файлах, созданных пакетом SDK MIP, создайте новое поле в файле конфигурации JSON или настройте MipConfiguration.

Файл конфигурации

Используйте файлы конфигурации для настройки пользовательских параметров в пакете SDK MIP на всех поддерживаемых платформах. Чтобы маскировать личные данные в файлах журнала MIP, используйте следующий метод.

1. Создайте файл конфигурации пользовательских параметров с именем mip_config.json , к которому может получить доступ пакет SDK MIP, и сохраните файл в следующем пути MipConfiguration .

mipConfiguration->GetPath()/mip

1. Добавьте новое поле в mip_config.json, чтобы установить для поля AllowPii значение false.

{"MipLogger":{"MaxLogFilesSizeMb":40,"MaxLogFileCount":10,"AllowPii":false}}

После настройки этого параметра пакет SDK MIP маскирует конфиденциальное содержимое во всех новых журналах MIP.

Настройка в MipConfiguration

Чтобы маскировать PII в файлах журнала MIP с помощью 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);