Freigeben über


Konzept – Protokollierung im MIP SDK

Problembehandlung für benutzerdefinierte Anwendungen, die das MIP SDK nutzen, beginnen mit der Prüfung von Mip-Protokollen. Der MIP-Protokollspeicherort ist bei der Erstellung von MipContext konfiguriert und kann mit der Dateierweiterung *.miplog abgefragt werden. Microsoft-Apps und Beispiele speichern MIP-Protokolle unter anwendungspfad\APP_DATA\mip_data.

Masken vertraulicher Daten in MIP-Protokollen

Protokolle im MIP SDK maskieren keine vertraulichen Inhalte, die für einen Kunden ohne zusätzliche Konfiguration persönlich identifizierbar sein können.

Allgemeine vertrauliche Daten in MIP SDK-Protokollen:

  • E-Mail-Namen
  • Dateinamen
  • Bezeichnungsnamen
  • IP-Adressen
  • MAC-Adressen

Um vertrauliche Inhalte in allen Miplog-Dateien zu maskieren, die vom MIP SDK generiert werden, erstellen Sie ein neues Feld in der Konfiguration .json Datei oder konfigurieren sie in MipConfiguration.

Konfigurationsdatei

Konfigurationsdateien sind der empfohlene Pfad zum Konfigurieren von benutzerdefinierten Einstellungen im MIP SDK und verfügbar auf allen unterstützten Plattformen. Verwenden Sie die folgende Methode, um PII in MIP-Protokolldateien zu maskieren.

  1. Erstellen Sie eine Vom MIP SDK zugängliche Konfigurationsdatei für benutzerdefinierte Einstellungen, die aufgerufen mip_config.json werden, und speichern Sie die Datei im folgenden MipConfiguration-Pfad .
mipConfiguration->GetPath()/mip
  1. Fügen Sie ein neues Feld hinzu, um mip_config.json das AllowPii Feld auf "false" festzulegen.
{"MipLogger":{"MaxLogFilesSizeMb":40,"MaxLogFileCount":10,"AllowPii":false}}

Nach der Konfiguration werden vertrauliche Inhalte in allen neuen MIP-Protokollen maskiert, die vom MIP SDK generiert werden.

Konfigurieren in MipConfiguration

Um PII in MIP-Protokolldateien mit MipConfiguration zu maskieren, erstellen Sie ein neues MipConfiguration Objekt, das MipContext mit neuen Werten für die benutzerdefinierten Einstellungen übergeben werden soll.

Diese Methode wird nur für C++ und C# unterstützt. Entwickler, die die C-API oder Java-Wrapper verwenden, werden empfohlen, stattdessen eine Konfigurationsdatei zu erstellen.

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