Conceito - Registro em log no SDK do MIP

A resolução de problemas de aplicativos personalizados que consomem o SDK do MIP começa com a inspeção dos logs do MIP. O local do log MIP é configurado na criação do MipContext e pode ser consultado com a extensão de arquivo *.miplog. 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 pode ser pessoalmente identificável para um cliente sem configuração extra.

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 conteúdo confidencial em todos os arquivos miplog gerados pelo SDK do MIP, crie um novo campo na configuração .json arquivo ou configure no MipConfiguration.

Arquivo de configuração

Os arquivos de configuração são o caminho recomendado para definir configurações personalizadas no SDK do MIP e disponíveis 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 acessível pelo SDK do MIP para configurações personalizadas chamadas mip_config.json e armazene o arquivo no caminho MipConfiguration a seguir.

mipConfiguration->GetPath()/mip

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

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

Depois de configurado, o conteúdo confidencial é mascarado em todos os novos logs de MIP gerados pelo SDK do MIP.

Configurar em MipConfiguration

Para mascarar PII em arquivos de log do MIP com MipConfiguration, crie um novo objeto MipConfiguration para passar para MipContext com novos valores para as configurações personalizadas.

Esse método tem suporte apenas para C++ e C#. É recomendável que os desenvolvedores que usam a API em C ou os wrappers Java criem um arquivo de configuração em vez disso.

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