Conceito — Registro de logs no MIP SDK

A solução de problemas de aplicativos personalizados que consomem o SDK do MIP começa com a inspeção de logs de MIP. Você configura o local dos logs do MIP ao criar MipContext, e pode consultar os logs usando a extensão de arquivo *.miplog. Os aplicativos e exemplos da Microsoft armazenam logs do MIP em application path\APP_DATA\mip_data.

Mascarar dados confidenciais em logs de MIP

Os logs no SDK do MIP não mascaram conteúdo confidencial que possa identificar pessoalmente um cliente, a menos que você configure o mascaramento.

Dados confidenciais comuns em logs do SDK do MIP:

• Nomes de email
• Nomes de arquivo
• Nomes dos rótulos
• Endereços IP
• Endereços MAC

Para mascarar o conteúdo confidencial em todos os *.miplog arquivos gerados pelo SDK do MIP, crie um novo campo no arquivo de configuração JSON ou configure MipConfiguration.

Arquivo de configuração

Use arquivos de configuração para definir configurações personalizadas no SDK do MIP em todas as plataformas com suporte. Para mascarar PII em arquivos de log MIP, use o método a seguir.

1. Crie um arquivo de configuração de definições personalizadas chamado mip_config.json, que o SDK do MIP possa acessar, e armazene o arquivo no seguinte caminho MipConfiguration.

mipConfiguration->GetPath()/mip

1. Adicione um novo campo para mip_config.json definir o AllowPii campo como false.

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

Depois de definir essa configuração, o SDK do MIP mascara o conteúdo confidencial em todos os novos logs de MIP.

Configurar em MipConfiguration

Para mascarar PII em arquivos de log do MIP com MipConfiguration, crie um novo objeto MipConfiguration que contenha os novos valores de configuração personalizados a serem passados para MipContext.

Esse método tem suporte apenas para C++ e C#. Se você usar a API C ou Java wrappers, crie um arquivo de configuração.

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);