Concept - Journalisation dans MIP SDK

La résolution des problèmes d’applications personnalisées qui consomment le SDK MIP commence par l’inspection des journaux MIP. Vous configurez l’emplacement du journal d'activité MIP lorsque vous créez MipContext, et vous pouvez interroger les journaux d'activité en utilisant l’extension de fichier *.miplog. Les applications et exemples Microsoft stockent les journaux d'activité MIP dans application path\APP_DATA\mip_data.

Masquer les données sensibles dans les journaux MIP

Les journaux du SDK MIP ne masquent pas le contenu sensible permettant d’identifier personnellement un client, sauf si vous configurez le masquage.

Données sensibles courantes dans les journaux d'activité du SDK MIP :

• Noms des e-mails
• Noms de fichiers
• Noms des étiquettes
• Adresses IP
• Adresses MAC

Pour masquer le contenu sensible dans tous les *.miplog fichiers générés par le Kit de développement logiciel (SDK) MIP, créez un champ dans le fichier de configuration JSON ou configurez MipConfiguration.

Fichier de configuration

Utilisez des fichiers de configuration pour configurer des paramètres personnalisés dans le SDK MIP sur toutes les plateformes prises en charge. Pour masquer les informations personnelles identifiables dans les fichiers journaux MIP, veuillez suivre la méthode suivante.

1. Créez un fichier de configuration de paramètres personnalisés nommé mip_config.json auquel le SDK MIP peut accéder, et stockez-le dans le chemin MipConfiguration suivant.

mipConfiguration->GetPath()/mip

1. Ajoutez un nouveau champ dans mip_config.json pour définir le champ AllowPii sur false.

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

Après avoir configuré ce paramètre, le SDK MIP masque le contenu sensible dans tous les nouveaux journaux MIP.

Configurer dans MipConfiguration

Pour masquer les PII dans les fichiers journaux MIP avec MipConfiguration, créez un nouvel objet MipConfiguration qui contient les nouvelles valeurs de paramètres personnalisés à transmettre à MipContext.

Cette méthode est prise en charge uniquement pour C++ et C#. Si vous utilisez l’API C ou Java wrappers, créez un fichier de configuration à la place.

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