Konzept – Protokollierung im MIP SDK

Bei der Problembehandlung von benutzerdefinierten Anwendungen, die das MIP SDK nutzen, beginnt die Untersuchung von MIP-Protokollen. Sie konfigurieren den Speicherort des MIP-Protokolls, wenn Sie erstellen MipContext, und Sie können Protokolle mithilfe der *.miplog Dateierweiterung abfragen. Microsoft-Apps und Beispielanwendungen speichern MIP-Protokolle unter application path\APP_DATA\mip_data.

Sensible Daten in MIP-Protokollen maskieren

Protokolle im MIP SDK maskieren keine vertraulichen Inhalte, die einen Kunden persönlich identifizieren können, es sei denn, Sie konfigurieren die Maskierung.

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 JSON-Konfigurationsdatei oder konfigurieren MipConfiguration.

Konfigurationsdatei

Verwenden Sie Konfigurationsdateien, um benutzerdefinierte Einstellungen im MIP SDK auf allen unterstützten Plattformen zu konfigurieren. Verwenden Sie die folgende Methode, um PII in MIP-Protokolldateien zu maskieren.

1. Erstellen Sie eine Konfigurationsdatei mit benutzerdefinierten Einstellungen, mip_config.json auf die das MIP SDK zugreifen kann, und speichern Sie die Datei im folgenden MipConfiguration-Pfad .

mipConfiguration->GetPath()/mip

1. 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}}

Nachdem Sie diese Einstellung konfiguriert haben, maskiert das MIP SDK vertrauliche Inhalte in allen neuen MIP-Protokollen.

Konfigurieren in MipConfiguration

Um PII in MIP-Protokolldateien mit MipConfiguration zu maskieren, erstellen Sie ein neues MipConfiguration-Objekt, das die neuen benutzerdefinierten Einstellungswerte zur Übergabe an MipContext enthält.

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

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