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

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

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

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

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

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

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

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

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

  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

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

Этот метод поддерживается только для C++ и C#. Разработчикам, использующим API C или 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