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 mip. La ubicación del registro de MIP se configura en la creación de MipContext y se puede consultar con la extensión de archivo *.miplog. Las aplicaciones y ejemplos de Microsoft almacenan registros MIP en la ruta de acceso de la aplicación\APP_DATA\mip_data.

Enmascarar datos confidenciales en los registros de MIP

Los registros del SDK de MIP no enmascaran contenido confidencial que puede ser identificable personalmente a un cliente sin configuración adicional.

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 archivos miplog generados por el SDK de MIP, cree un nuevo campo en la configuración .json archivo o configure en MipConfiguration.

Archivo de configuración

Los archivos de configuración son la ruta de acceso recomendada para configurar opciones personalizadas en el SDK de MIP y están disponibles 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 que sea accesible por el SDK de MIP para configuraciones personalizadas llamado mip_config.json y almacene el archivo en la siguiente ruta MipConfiguration.

mipConfiguration->GetPath()/mip

2. Agregue un nuevo campo a mip_config.json para establecer el AllowPii campo en false.

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

Una vez configurado, el contenido confidencial se enmascara en todos los registros de MIP nuevos generados por el SDK de MIP.

Configurar en MipConfiguration

Para enmascarar PII en los archivos de registro de MIP con MipConfiguration, cree un nuevo objeto MipConfiguration para pasar al MipContext con los nuevos valores para la configuración personalizada.

Este método solo se admite para C++ y C#. En su lugar, se recomienda a los desarrolladores que usen la API de C o los contenedores de Java para crear 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);