Konzept – Protokollierung im MIP SDK

Die Problembehandlung für benutzerdefinierte Anwendungen, die das MIP SDK verwenden, beginnt mit der Überprüfung der MIP-Protokolle. Der MIP-Protokollspeicherort ist bei der Erstellung von MipContext konfiguriert und kann mit der Dateierweiterung *.miplog abgefragt werden. Microsoft-Apps und Beispielanwendungen speichern MIP-Protokolle im Anwendungspfad\APP_DATA\mip_data.

Sensible Daten in MIP-Protokollen maskieren

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 für das MIP SDK zugängliche Konfigurationsdatei für benutzerdefinierte Einstellungen mit dem Namen mip_config.json und speichern Sie sie im folgenden MipConfiguration-Pfad.

mipConfiguration->GetPath()/mip

2. Fügen Sie mip_config.json ein neues Feld hinzu, um das Feld AllowPii auf „falsch“ zu setzen.

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