Partager via

Concept - Journalisation dans le Kit de développement logiciel (SDK) MIP

  • Article

Résolution des problèmes d’applications personnalisées qui consomment le SDK MIP commencent 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 MIP sur le chemin d’accès de l’application\APP_DATA\mip_data.

Masquer les données sensibles dans les journaux MIP

Les journaux du SDK MIP ne masquent pas le contenu sensible qui peut être identifiable personnellement à un client sans configuration supplémentaire.

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

  • Noms des e-mails
  • Noms de fichiers
  • Noms d’é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 dans les fichiers journaux MIP, utilisez 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
  1. Ajoutez un nouveau champ pour mip_config.json définir le AllowPii champ 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 avec de MipContext 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);