Megosztás a következőn keresztül:


Microsoft Information Protection SDK – Diagnosztikai konfiguráció

Diagnosztikai adatok

Alapértelmezés szerint a Microsoft Information Protection SDK diagnosztikai adatokat küld a Microsoftnak. Ezek az adatok olyan hibák, minőség és teljesítményproblémák elhárításához hasznosak az SDK-telepítési bázison, amelyeket esetleg nem rögzítünk a belső tesztelés során. Amikor az alkalmazást az SDK-val valósítja meg, fontos, hogy a felhasználók és a rendszergazdák szükség esetén letiltsák a diagnosztikai adatok küldését.

Diagnosztikai konfiguráció

A MIP SDK diagnosztikai beállításai a következőn keresztül DiagnosticConfigurationvezérelhetők: . Hozzon létre egy példányt ennek az osztálynak, majd állítsa igazra azMinimalTelemetryEnabled értéket. Adja meg a DiagnosticConfiguration osztály objektumát a MipContext létrehozásához használt függvénynek.

Minimális diagnosztikai események

Ha a diagnosztikai konfiguráció minimálisra van állítva, a rendszer minimális adatkészletet küld a Microsoftnak. Minden személyazonosításra alkalmas információ le van súrolva ebből az információból. Ezek az adatok szívverési információkat tartalmaznak az SDK használatának megértéséhez, valamint a rendszer metaadatait. A szolgáltatáshoz nincs beállítva felhasználói tartalom vagy végfelhasználói azonosításra alkalmas információ.

Tekintse át az alábbi táblázatokat, és nézze meg, hogy pontosan milyen eseményeket és adatokat küld a rendszer a minimális diagnosztika engedélyezésével.

Esemény: Szívverés

Name Leírás Átengedni
App.ApplicationId A mip::ApplicationInfo fájlon keresztül megadott alkalmazásazonosító. Nem
App.ApplicationName A mip::ApplicationInfo fájlon keresztül megadott alkalmazásnév. Nem
App.ApplicationVersion A mip::ApplicationInfo alkalmazásverzió. Nem
ApplicationId A mip::ApplicationInfo alkalmazásverzió. Nem
ApplicationName A mip::ApplicationInfo fájlon keresztül megadott alkalmazásnév. Nem
Létrehozási idő Az időesemény létrejött. Nem
DefaultLabel.Id Bérlő alapértelmezett címkeazonosítója. Nem
Engine.TenantId A hitelesített felhasználó otthoni bérlői GUID azonosítója. Nem
Engine.UserObjectId Felhasználói objektum azonosítója a Microsoft Entra-azonosítóban. Nem
Event.CorrelationId Az eseményt aktiváló objektumhoz társított egyedi azonosító. Nem
Event.CorrelationIdDescription Az eseményt kiváltó objektum C++ osztályneve. Nem
Event.ParentCorrelationId Szülőesemény korrelációs azonosítója. Nem
Event.ParentCorrelationIdDescription Az eseményt kiváltó objektum szülőjével társított egyedi azonosító. Nem
Event.UniqueId Az eseményhez hozzárendelt egyedi azonosító. Nem
MachineName Az eseményt létrehozó rendszer neve. Igen
MIP. Változat A MIP SDK verziója. Nem
Operation Szívverés Nem
Szervezeti azonosító A hitelesített felhasználó otthoni bérlői GUID azonosítója. Nem
Platform Operációs rendszer verziója. Nem
ProcessName A folyamat neve az SDK használatával. Nem
ProductVersion Ugyanaz, mint az "App.ApplicationVersion". Nem
SDKVersion Ugyanaz, mint a MIP. Változat. Nem
UserId A felhasználó e-mail-címe. Igen
UserObjectId A felhasználó Microsoft Entra objektumazonosítója. Nem
Verzió Verzióséma naplózása ("1.1"). Nem

Esemény: Felderítés

Name Leírás Átengedni
Műveletazonosító Az esemény egyedi műveletazonosítója, amelyet eseménykorrelációhoz használnak. Nem
App.ApplicationId A mip::ApplicationInfo fájlon keresztül megadott alkalmazásazonosító. Nem
App.ApplicationName A mip::ApplicationInfo fájlon keresztül megadott alkalmazásnév. Nem
App.ApplicationVersion A mip::ApplicationInfo alkalmazásverzió. Nem
ApplicationId A mip::ApplicationInfo alkalmazásverzió. Nem
ApplicationName A mip::ApplicationInfo fájlon keresztül megadott alkalmazásnév. Nem
Létrehozási idő Az időesemény létrejött. Nem
DataState Az adatok állapota, ahogy az alkalmazás a "REST", a "MOTION", az "U Standard kiadás" állapotot használja. Nem
DefaultLabel.Id Bérlő alapértelmezett címkeazonosítója. Nem
Engine.TenantId A hitelesített felhasználó otthoni bérlői GUID azonosítója. Nem
Engine.UserObjectId Felhasználói objektum azonosítója a Microsoft Entra-azonosítóban. Nem
Event.CorrelationId Az eseményt aktiváló objektumhoz társított egyedi azonosító. Nem
Event.CorrelationIdDescription Az eseményt kiváltó objektum C++ osztályneve. Nem
Event.ParentCorrelationId Szülőesemény korrelációs azonosítója. Nem
Event.ParentCorrelationIdDescription Az eseményt kiváltó objektum szülőjével társított egyedi azonosító. Nem
Event.UniqueId Az eseményhez hozzárendelt egyedi azonosító. Nem
LabelId Tartalomcímke-azonosító a megnyitott fájlon vagy adatokon. Nem
MachineName Az eseményt létrehozó rendszer neve. Igen
MIP. Változat A MIP SDK verziója. Nem
ObjectId A fájl vagy adatok elérési útja/leírása. Igen
Operation "Felderítés". Nem
Szervezeti azonosító A hitelesített felhasználó otthoni bérlői GUID azonosítója. Nem
Platform Operációs rendszer verziója. Nem
ProcessName A folyamat neve az SDK használatával. Nem
Védett Bool jelzi, hogy a fájl védett-e vagy sem. Nem
Védelem A védelmi sablon azonosítója. Igen
ProtectionOwner A védelem tulajdonosának e-mail-címe. Igen
SDKVersion Ugyanaz, mint a MIP. Változat. Nem
UserId A felhasználó e-mail-címe. Igen
UserObjectId A felhasználó Microsoft Entra objektumazonosítója. Nem
Verzió Verzióséma naplózása ("1.1"). Nem

Esemény: Címke módosítása

Name Leírás Átengedni
Műveletazonosító Az esemény egyedi műveletazonosítója, amelyet eseménykorrelációhoz használnak. Nem
ActionIdBefore Előző műveletazonosító. Az új műveletazonosítók láncolásához használatos. Nem
ActionSource A MIP értéke::ActionSource. Nem
App.ApplicationId A mip::ApplicationInfo fájlon keresztül megadott alkalmazásazonosító. Nem
App.ApplicationName A mip::ApplicationInfo fájlon keresztül megadott alkalmazásnév. Nem
App.ApplicationVersion A mip::ApplicationInfo alkalmazásverzió. Nem
ApplicationId A mip::ApplicationInfo fájlon keresztül megadott alkalmazásazonosító. Nem
ApplicationName A mip::ApplicationInfo fájlon keresztül megadott alkalmazásnév. Nem
Létrehozási idő Az esemény létrehozásának időpontja. Nem
DataState Az adatok állapota, ahogy az alkalmazás a "REST", a "MOTION", az "U Standard kiadás" állapotot használja. Nem
DefaultLabel.Id Bérlő alapértelmezett címkeazonosítója. Nem
Engine.TenantId A hitelesített felhasználó otthoni bérlői GUID azonosítója. Nem
Engine.UserObjectId Felhasználói objektum azonosítója a Microsoft Entra-azonosítóban. Nem
Event.CorrelationId Az eseményt aktiváló objektumhoz társított egyedi azonosító. Nem
Event.CorrelationIdDescription Az eseményt kiváltó objektum C++ osztályneve. Nem
Event.ParentCorrelationId Szülőesemény korrelációs azonosítója. Nem
Event.ParentCorrelationIdDescription Az eseményt kiváltó objektum szülőjével társított egyedi azonosító. Nem
Event.UniqueId Az eseményhez hozzárendelt egyedi azonosító. Nem
IsLabelChanged Bool jelzi, ha a címke megváltozott. Nem
IsProtectionChanged Bool jelzi, hogy változott-e a védelem. Nem
LabelId A fájlra vagy adatokra alkalmazni kívánt címkeazonosító. Nem
LabelIdBefore A fájlon vagy adatokon lévő korábbi címkeazonosító. Nem
MachineName Az eseményt létrehozó rendszer neve. Igen
MIP. Változat A MIP SDK verziója. Nem
ObjectId A fájl vagy adatok elérési útja/leírása. Igen
Operation "Változás". Nem
Szervezeti azonosító A hitelesített felhasználó otthoni bérlői GUID azonosítója. Nem
Platform Operációs rendszer verziója. Nem
ProcessName A folyamat neve az SDK használatával. Nem
Termékverzió Nem
Védett Bool jelzi, hogy a fájl védett-e vagy sem. Nem
Védelem előtt Bool jelzi, hogy a fájl korábban védett volt-e, vagy sem. Nem
Védelem A védelmi sablon azonosítója. Nem
Védelem előtt Az előző védelmi sablon azonosítója. Nem
ProtectionContentId Az új tartalomazonosító (GUID). Nem
ProtectionContentIdBefore Az előző tartalomazonosító (GUID). Nem
ProtectionOwner A védelem tulajdonosának e-mail-címe. Igen
ProtectionOwnerBefore A védelmi tulajdonos korábbi e-mail-címe. Igen
SDKVersion Ugyanaz, mint a MIP. Változat. Nem
UserId A felhasználó e-mail-címe. Igen
UserObjectId A felhasználó Microsoft Entra objektumazonosítója. Nem
Verzió Verzióséma naplózása ("1.1"). Nem

Letiltás a C++ alkalmazásban

Ha a diagnosztikát csak minimálisra szeretné állítani, hozzon létre egy megosztott mutatót a mip::D iagnosticConfiguration() elemhez, és állítsa az IsMinimalTelemetryEnabled értéket igaz értékre. Adja át az objektumot a MipConfiguration::SetDiagnosticConfiguration() létrehozáshozMipContext.MipConfiguration

auto diagnosticConfig = std::make_shared<mip::DiagnosticConfiguration>();
diagnosticConfig->isMinimalTelemetryEnabled = true;
					   
// Create MipConfiguration. 
// Initialize MipConfiguration.
std::shared_ptr<mip::MipConfiguration> mipConfiguration = std::make_shared<mip::MipConfiguration>(mAppInfo,
                                                                                                 "file_sample",
				                                                                                 mip::LogLevel::Trace,
				                                                                                 false);

// Set DiagnosticConfig
mipConfiguration->SetDiagnosticConfiguration(diagnosticConfig);

mMipContext = mip::MipContext::Create(mipConfiguration);

Leiratkozás a .NET-ben

Ha a diagnosztikai adatokat csak minimálisra szeretné beállítani, hozzon létre egy DiagnosticConfiguration() objektumot, és állítsa az IsMinimalTelemetryEnabled értéket igaz értékre. Állítsa be a DiagnosticOverride tulajdonságot, MipConfiguration majd hozza létre a MipContext.

DiagnosticConfiguration diagnosticConfiguration = new DiagnosticConfiguration();
diagnosticConfiguration.IsMinimalTelemetryEnabled = true;

// Create MipConfiguration.
MipConfiguration mipConfiguration = new MipConfiguration(appInfo, "mip_data", LogLevel.Trace, false);

// Set Diagnostic Override.
mipConfiguration.DiagnosticOverride = diagnosticConfiguration;

// Create MipContext.
MipContext mipContext = MIP.CreateMipContext(mipConfiguration);