Concepto: Registro en el SDK de MIP

La solución de problemas de aplicaciones personalizadas que consumen el SDK de MIP comienza por inspeccionar los registros de MIP. Configura la ubicación del registro de MIP al crear MipContext, y puede consultar los registros mediante la extensión de archivo *.miplog. Las aplicaciones y los ejemplos de Microsoft almacenan los registros de MIP en application path\APP_DATA\mip_data.

Enmascarar datos confidenciales en los registros de MIP

Los registros del SDK de MIP no enmascaran contenido confidencial que podría identificar personalmente a un cliente a menos que configure el enmascaramiento.

Datos confidenciales comunes en los registros del SDK de MIP:

  • Nombres de correo electrónico
  • Nombres de archivo
  • Nombres de las etiquetas
  • Direcciones IP
  • Direcciones MAC

Para enmascarar contenido confidencial en todos los *.miplog archivos generados por el SDK de MIP, cree un nuevo campo en el archivo de configuración JSON o configure MipConfiguration.

Archivo de configuración

Use archivos de configuración para configurar opciones personalizadas en el SDK de MIP en todas las plataformas compatibles. Para enmascarar PII en los archivos de registro de MIP, use el método siguiente.

  1. Cree un archivo de configuración de ajustes personalizados denominado mip_config.json, al que pueda acceder el SDK de MIP, y almacene el archivo en la siguiente ruta de acceso MipConfiguration.
mipConfiguration->GetPath()/mip
  1. Agregue un nuevo campo a mip_config.json para establecer el AllowPii campo en false.
{"MipLogger":{"MaxLogFilesSizeMb":40,"MaxLogFileCount":10,"AllowPii":false}}

Después de configurar esta opción, el SDK de MIP enmascara el contenido confidencial en todos los registros de MIP nuevos.

Configurar en MipConfiguration

Para enmascarar PII en los archivos de registro de MIP con MipConfiguration, cree un nuevo MipConfiguration objeto que contenga los nuevos valores de configuración personalizados que se van a pasar a MipContext.

Este método solo se admite para C++ y C#. Si usa la API de C o los wrappers de Java, cree en su lugar un archivo de configuración.

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