Conceito - Registo no MIP SDK

A resolução de problemas de aplicações personalizadas que consomem o MIP SDK começa com a inspeção dos registos MIP. Configuras a localização do registo MIP quando crias MipContext, e podes consultar registos usando a *.miplog extensão do ficheiro. As aplicações e exemplos da Microsoft armazenam registos do MIP em application path\APP_DATA\mip_data.

Mascarar dados confidenciais em logs MIP

Os logs no MIP SDK não mascaram conteúdos sensíveis que possam identificar pessoalmente um cliente, a menos que configure o mascaramento.

Dados confidenciais comuns em logs do MIP SDK:

• Nomes de e-mail
• Nomes de ficheiros
• Nomes dos rótulos
• Endereços IP
• Endereços MAC

Para mascarar conteúdos sensíveis em todos *.miplog os ficheiros gerados pelo MIP SDK, crie um novo campo no ficheiro de configuração JSON ou configure MipConfiguration.

Arquivo de configuração

Use ficheiros de configuração para configurar definições personalizadas no MIP SDK em todas as plataformas suportadas. Para mascarar PII em arquivos de log MIP, use o seguinte método.

1. Crie um ficheiro de configuração personalizado chamado mip_config.json ao qual o MIP SDK possa aceder, e armazene o ficheiro 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 configurar esta definição, o SDK MIP mascara conteúdos sensíveis em todos os novos registos MIP.

Configurar em MipConfiguration

Para mascarar PII em ficheiros de registo MIP com MipConfiguration, crie um novo MipConfiguration objeto que contenha os novos valores personalizados para passar para MipContext.

Este método é suportado apenas para C++ e C#. Se usares a API C ou wrappers Java, cria um ficheiro de configuração em vez disso.

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