Concept - Journalisation dans MIP SDK

La résolution des problèmes d'applications personnalisées qui consomment le MIP SDK commence par inspecter les journaux MIP. L’emplacement du journal MIP est configuré lors de la création de MipContext et peut être interrogé avec l’extension de fichier *.miplog. Les applications et exemples Microsoft stockent les journaux d'activité MIP dans le chemin d'accès de l'application\APP_DATA\mip_data.

Masquer les données sensibles dans les journaux MIP

Les journaux d'activité du SDK MIP ne masquent pas les informations sensibles susceptibles d'identifier un client sans configuration supplémentaire.

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 fichiers miplog 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-le dans MipConfiguration.

Fichier de configuration

Les fichiers de configuration sont le chemin d’accès recommandé pour configurer des paramètres personnalisés dans le Kit de développement logiciel (SDK) MIP et disponibles 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 accessible par le Kit de développement logiciel (SDK) MIP pour les paramètres personnalisés appelés mip_config.json et stockez le fichier dans le chemin MipConfiguration suivant.

mipConfiguration->GetPath()/mip

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

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

Une fois configuré, le contenu sensible est masqué dans tous les nouveaux journaux MIP générés par le Kit de développement logiciel (SDK) MIP.

Configurer dans MipConfiguration

Pour masquer les informations personnelles dans les fichiers journaux MIP avec MipConfiguration, créez un MipConfiguration objet à transmettre dans MipContext, avec de nouvelles valeurs pour les paramètres personnalisés.

Cette méthode est prise en charge uniquement pour C++ et C#. Les développeurs qui utilisent l’API C ou les wrappers Java sont recommandés pour créer un fichier de configuration à la place.

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