Microsoft Information Protection SDK – Konfigurace diagnostiky

Diagnostická data

Ve výchozím nastavení sada Microsoft Information Protection SDK odesílá diagnostická data společnosti Microsoft. Tato data jsou užitečná při řešení chyb, kvality a problémů s výkonem v instalační databázi sady SDK, kterou nemusíme zachytit v interním testování. Při implementaci aplikace pomocí sady SDK je důležité dát uživatelům a správcům možnost v případě potřeby odhlásit odesílání diagnostických dat.

Konfigurace diagnostiky

Diagnostické možnosti v sadě MIP SDK je možné řídit pomocí DiagnosticConfiguration. Vytvořte instanci této třídy a pak nastavte isMinimalTelemetryEnabled na true. Předejte objekt třídy DiagnosticConfiguration do funkce použité k vytvoření MipContext.

Minimální diagnostické události

Pokud je konfigurace diagnostiky nastavená na minimum, odešle se do Microsoft minimální sada dat. Všechny identifikovatelné osobní údaje se z těchto informací vyčistí. Tyto údaje zahrnují informace o heartbeatu ke zjištění, zda je sada SDK používána, a systémová metadata. Pro službu není nastavený žádný obsah uživatele ani identifikovatelné informace koncového uživatele.

Projděte si následující tabulky a podívejte se, jaké události a data se odesílají s minimální povolenou diagnostikou.

Událost: Heartbeat

Název Description Vyčištěno
App.ApplicationId Identifikátor aplikace poskytnutý prostřednictvím mip::ApplicationInfo. Ne
App.ApplicationName Název aplikace zadaný prostřednictvím mip::ApplicationInfo. Ne
App.ApplicationVersion Verze aplikace poskytovaná prostřednictvím mip::ApplicationInfo. Ne
ApplicationId Verze aplikace poskytovaná prostřednictvím mip::ApplicationInfo. Ne
ApplicationName Název aplikace zadaný prostřednictvím mip::ApplicationInfo. Ne
Čas vytvoření Vygenerovala se časová událost. Ne
DefaultLabel.Id ID výchozího štítku tenanta Ne
Engine.TenantId GUID domovského tenanta ověřeného uživatele Ne
Engine.UserObjectId ID objektu uživatele v Microsoft Entra ID Ne
Event.CorrelationId Vygenerované jedinečné ID přidružené k objektu, který aktivoval událost. Ne
Event.CorrelationIdDescription Název třídy C++objektu, který aktivoval událost. Ne
Event.ParentCorrelationId ID korelace pro nadřazenou událost Ne
Event.ParentCorrelationIdDescription Vygenerované jedinečné ID přidružené k rodiči objektu, který aktivoval událost. Ne
Event.UniqueId Vygenerované jedinečné ID přiřazené události. Ne
název stroje Název systému, který událost vygeneroval. Yes
MIP.Verze Verze sady SDK MIP. Ne
Operace Srdeční tep Ne
Id organizace GUID domovského tenanta ověřeného uživatele Ne
Platforma Verze operačního systému. Ne
ProcessName Název procesu pomocí sady SDK Ne
Verze produktu Stejné jako App.ApplicationVersion. Ne
SDKVersion Stejné jako MIP.Version. Ne
UserId Email adresu uživatele. Yes
UserObjectId (identifikátor objektu uživatele) Microsoft Entra ID objektu uživatele. Ne
Verze Schéma verze auditu ("1.1"). Ne

Událost: Zjištění

Název Description Vyčištěno
Identifikátor akce Jedinečné ID akce pro tuto událost, které se používá pro korelaci událostí. Ne
App.ApplicationId Identifikátor aplikace poskytnutý prostřednictvím mip::ApplicationInfo. Ne
App.ApplicationName Název aplikace zadaný prostřednictvím mip::ApplicationInfo. Ne
App.ApplicationVersion Verze aplikace poskytovaná prostřednictvím mip::ApplicationInfo. Ne
ApplicationId Verze aplikace poskytovaná prostřednictvím mip::ApplicationInfo. Ne
ApplicationName Název aplikace zadaný prostřednictvím mip::ApplicationInfo. Ne
Čas vytvoření Vygenerovala se časová událost. Ne
DataState Stav dat při tom, jak s nimi aplikace pracuje: „REST“, „MOTION“, „USE“. Ne
DefaultLabel.Id Výchozí identifikátor popisku tenanta Ne
Engine.TenantId GUID domovského tenanta ověřeného uživatele Ne
Engine.UserObjectId Identifikátor objektu uživatele v Microsoft Entra ID Ne
Event.CorrelationId Vygenerované jedinečné ID přidružené k objektu, který aktivoval událost. Ne
Event.CorrelationIdDescription Název třídy C++objektu, který aktivoval událost. Ne
Event.ParentCorrelationId ID korelace nadřazené události Ne
Event.ParentCorrelationIdDescription Vygenerované jedinečné ID přidružené k nadřazené objektu, který aktivoval událost. Ne
Event.UniqueId Vygenerované jedinečné ID přiřazené události. Ne
LabelId Identifikátor popisku obsahu u otevřeného souboru nebo dat. Ne
název stroje Název systému, který událost vygeneroval. Yes
MIP.Verze Verze sady SDK MIP. Ne
Identifikátor objektu (ObjectId) Cesta k souboru nebo popis souboru nebo dat. Yes
Operace Objevování Ne
Id organizace GUID domovského tenanta ověřeného uživatele Ne
Platforma Verze operačního systému. Ne
ProcessName Název procesu pomocí sady SDK Ne
Chráněno Logická hodnota určující, zda je soubor chráněný, nebo ne. Ne
Ochrana Identifikátor šablony ochrany. Yes
Vlastník ochrany E-mailová adresa vlastníka ochrany Yes
SDKVersion Stejné jako MIP.Version. Ne
UserId Email adresu uživatele. Yes
UserObjectId (identifikátor objektu uživatele) Microsoft Entra ID objektu uživatele. Ne
Verze Schéma verze auditu ("1.1"). Ne

Událost: Změna popisku

Název Description Vyčištěno
Identifikátor akce Jedinečné ID akce pro tuto událost, které se používá pro korelaci událostí. Ne
ActionIdBefore ID předchozí akce Používá se k navázání na nové ID akce. Ne
ActionSource Hodnota MIP::ActionSource. Ne
App.ApplicationId ID aplikace poskytnuté prostřednictvím mip::ApplicationInfo. Ne
App.ApplicationName Název aplikace zadaný prostřednictvím mip::ApplicationInfo. Ne
App.ApplicationVersion Verze aplikace poskytovaná prostřednictvím mip::ApplicationInfo. Ne
ApplicationId ID aplikace poskytnuté prostřednictvím mip::ApplicationInfo. Ne
ApplicationName Název aplikace zadaný prostřednictvím mip::ApplicationInfo. Ne
Čas vytvoření Čas vygenerování události Ne
DataState Stav dat při tom, jak s nimi aplikace pracuje: „REST“, „MOTION“, „USE“. Ne
DefaultLabel.Id Výchozí identifikátor popisku tenanta Ne
Engine.TenantId GUID domovského tenanta ověřeného uživatele Ne
Engine.UserObjectId Identifikátor objektu uživatele v Microsoft Entra ID Ne
Event.CorrelationId Vygenerované jedinečné ID přidružené k objektu, který aktivoval událost. Ne
Event.CorrelationIdDescription Název třídy C++objektu, který aktivoval událost. Ne
Event.ParentCorrelationId ID korelace nadřazené události Ne
Event.ParentCorrelationIdDescription Vygenerované jedinečné ID přidružené k nadřazené objektu, který aktivoval událost. Ne
Event.UniqueId Vygenerované jedinečné ID přiřazené události. Ne
IsLabelChanged Booleovská hodnota udávající, zda se popisek změnil. Ne
Je ochrana změněna Booleovská hodnota určující, zda se ochrana změnila. Ne
LabelId ID popisku, které se má použít u souboru nebo dat. Ne
LabelIdBefore Předchozí ID štítku, které bylo v souboru nebo datech Ne
název stroje Název systému, který událost vygeneroval. Yes
MIP.Verze Verze sady SDK MIP. Ne
Identifikátor objektu (ObjectId) Cesta k souboru nebo popis souboru nebo dat. Yes
Operace "Změnit". Ne
Id organizace GUID domovského tenanta ověřeného uživatele Ne
Platforma Verze operačního systému. Ne
ProcessName Název procesu pomocí sady SDK Ne
Verze produktu Ne
Chráněno Logická hodnota určující, zda je soubor chráněný, nebo ne. Ne
Chráněno před Logická hodnota určující, zda byl soubor dříve chráněn, či nikoli. Ne
Ochrana Identifikátor šablony ochrany. Ne
Ochrana před Předchozí identifikátor šablony ochrany. Ne
ProtectionContentId Nový identifikátor obsahu (GUID). Ne
ProtectionContentIdBefore Předchozí identifikátor obsahu (GUID). Ne
Vlastník ochrany E-mailová adresa vlastníka ochrany Yes
Vlastník ochrany předtím Předchozí e-mailová adresa vlastníka ochrany Yes
SDKVersion Stejné jako MIP.Version. Ne
UserId Email adresu uživatele. Yes
UserObjectId (identifikátor objektu uživatele) Microsoft Entra ID objektu uživatele. Ne
Verze Schéma verze auditu ("1.1"). Ne

Odhlášení v jazyce C++

Pokud chcete nastavit diagnostiku pouze na minimum, vytvořte sdílený ukazatel mip::D iagnosticConfiguration() a nastavte isMinimalTelemetryEnabled na hodnotu true. Předejte objekt do MipConfiguration::SetDiagnosticConfiguration() a pak pomocí MipConfiguration vygenerujte MipContext.

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

Odhlášení v .NET

Chcete-li nastavit diagnostická data pouze na minimum, vytvořte objekt DiagnosticConfiguration() a nastavte isMinimalTelemetryEnabled na true. Nastavte vlastnost DiagnosticOverride u MipConfiguration a potom vytvořte 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);