Udostępnij za pośrednictwem


Microsoft Information Protection SDK — konfiguracja diagnostyczna

Dane diagnostyczne

Domyślnie zestaw SDK usługi Microsoft Information Protection wysyła dane diagnostyczne do firmy Microsoft. Te dane są przydatne do rozwiązywania problemów z usterkami, jakością i wydajnością w bazie instalacji zestawu SDK, których możemy nie przechwycić w ramach testów wewnętrznych. Podczas implementowania aplikacji przy użyciu zestawu SDK ważne jest, aby w razie potrzeby umożliwić użytkownikom i administratorom rezygnację z wysyłania danych diagnostycznych.

Konfiguracja diagnostyczna

Opcje diagnostyczne w pakiecie MIP SDK można kontrolować za pomocą DiagnosticConfiguration. Utwórz wystąpienie tej klasy, a następnie ustaw wartość isMinimalTelemetryEnabled na true. Podaj obiekt klasy DiagnosticConfiguration funkcji używanej do utworzenia obiektu MipContext.

Minimalne zdarzenia diagnostyczne

Gdy konfiguracja diagnostyczna jest ustawiona na minimum, do firmy Microsoft jest wysyłany minimalny zestaw danych. Wszystkie dane osobowe są wyczyszczone z tych informacji. Te dane zawierają informacje o tętnie, aby wykazać, że SDK jest używany, oraz metadane systemowe. Żadna zawartość użytkownika ani informacje umożliwiające zidentyfikowanie użytkownika końcowego nie są ustawione na usługę.

Przejrzyj poniższe tabele, aby zobaczyć dokładnie, jakie zdarzenia i dane są wysyłane z minimalną włączoną diagnostyką.

Zdarzenie: puls

Nazwa Opis Wyczyszczony
App.IdentyfikatorAplikacji Identyfikator aplikacji udostępniany za pośrednictwem mip::ApplicationInfo. Nie.
Aplikacja.ApplicationName Nazwa aplikacji podana za pośrednictwem polecenia mip::ApplicationInfo. Nie.
Aplikacja.WersjaAplikacji Wersja aplikacji udostępniana za pośrednictwem mip::ApplicationInfo. Nie.
Identyfikator aplikacji Wersja aplikacji podawana za pośrednictwem mip::ApplicationInfo. Nie.
Nazwa Aplikacji Nazwa aplikacji podana za pośrednictwem polecenia mip::ApplicationInfo. Nie.
CzasUtworzenia Zdarzenie czasu zostało wygenerowane. Nie.
EtykietaDomyślna.Id Domyślny identyfikator etykiety najemcy. Nie.
Engine.TenantId Identyfikator GUID dzierżawy głównej uwierzytelnionego użytkownika. Nie.
Engine.UserObjectId Identyfikator obiektu użytkownika w Microsoft Entra ID. Nie.
Event.CorrelationId Wygenerowano unikatowy identyfikator skojarzony z obiektem, który wyzwolił zdarzenie. Nie.
OpisIdentyfikatoraKorelacjiZdarzenia Nazwa klasy języka C++ obiektu, który wyzwolił zdarzenie. Nie.
Event.ParentCorrelationId Identyfikator korelacji zdarzenia nadrzędnego. Nie.
Zdarzenie.OpisIdentyfikatoraRelacjiRodzica Wygenerowano unikalny identyfikator skojarzony z rodzicem obiektu, który wyzwolił zdarzenie. Nie.
Event.UniqueId Wygenerowany unikatowy identyfikator przypisany do zdarzenia. Nie.
NazwaMaszyny Nazwa systemu, który wygenerował zdarzenie. Tak
MIP. Wersja Wersja zestawu MIP SDK. Nie.
Operacja Puls Nie.
Identyfikator organizacji Identyfikator GUID najemcy głównego uwierzytelnionego użytkownika. Nie.
Platforma Wersja systemu operacyjnego. Nie.
ProcessName Nazwa procesu przy użyciu zestawu SDK. Nie.
Wersja produktu To samo co "App.ApplicationVersion". Nie.
SDKVersion Tak jak wersja MIP. Nie.
Identyfikator użytkownika Email adres użytkownika. Tak
IdentyfikatorObiektuUżytkownika Microsoft Entra identyfikator obiektu użytkownika. Nie.
Wersja Przeprowadź inspekcję schematu wersji ("1.1"). Nie.

Zdarzenie: odnajdywanie

Nazwa Opis Wyczyszczony
Identyfikator akcji Unikatowy identyfikator akcji dla tego zdarzenia używany do korelacji zdarzeń. Nie.
App.ApplicationId Identyfikator aplikacji dostarczany przez mip::ApplicationInfo. Nie.
Aplikacja.NazwaAplikacji Nazwa aplikacji podana za pośrednictwem polecenia mip::ApplicationInfo. Nie.
WersjaAplikacjiApp Wersja aplikacji dostarczona za pośrednictwem mip::ApplicationInfo. Nie.
Identyfikator aplikacji Wersja aplikacji udostępniana za pośrednictwem mip::ApplicationInfo. Nie.
Nazwa Aplikacji Nazwa aplikacji podana za pośrednictwem polecenia mip::ApplicationInfo. Nie.
CzasUtworzenia Zdarzenie czasowe zostało wygenerowane. Nie.
DataState Stan danych, gdy aplikacja działa na nim "REST", "MOTION", "USE". Nie.
DomyślnaEtykieta.Identyfikator Domyślny identyfikator etykiety dzierżawy. Nie.
Engine.TenantId Identyfikator GUID dzierżawy głównej uwierzytelnionego użytkownika. Nie.
IdentyfikatorObiektuUżytkownika.Silnik Identyfikator obiektu użytkownika w identyfikatorze Entra firmy Microsoft. Nie.
Event.CorrelationId Wygenerowano unikatowy identyfikator skojarzony z obiektem, który wyzwolił zdarzenie. Nie.
OpisIdentyfikatoraKorelacjiWydarzenia Nazwa klasy języka C++ obiektu, który wyzwolił zdarzenie. Nie.
Event.ParentCorrelationId Identyfikator korelacji zdarzenia nadrzędnego. Nie.
OpisIdentyfikatoraRodzicaZdarzenia Wygenerowano unikatowy identyfikator skojarzony z elementem nadrzędnym obiektu, który wyzwolił zdarzenie. Nie.
Zdarzenie.UnikalnyIdentyfikator Wygenerowany unikatowy identyfikator przypisany do zdarzenia. Nie.
Identyfikator etykiety Identyfikator etykiety zawartości w otwartym pliku lub danych. Nie.
NazwaMaszyny Nazwa systemu, który wygenerował zdarzenie. Tak
MIP. Wersja Wersja zestawu MIP SDK. Nie.
ObjectId (identyfikator obiektu) Ścieżka/opis pliku lub danych. Tak
Operacja "Odnajdywanie". Nie.
Identyfikator organizacji Identyfikator GUID lokalnej dzierżawy uwierzytelnionego użytkownika. Nie.
Platforma Wersja systemu operacyjnego. Nie.
ProcessName Nazwa procesu przy użyciu zestawu SDK. Nie.
Zabezpieczone Wartość logiczna wskazująca, czy plik jest chroniony, czy nie. Nie.
Ochrona Identyfikator szablonu ochrony. Tak
Właściciel ochrony Adres e-mail właściciela ochrony. Tak
SDKVersion Tak samo jak MIP.Version. Nie.
Identyfikator użytkownika Email adres użytkownika. Tak
IdentyfikatorObiektuUżytkownika Microsoft Entra identyfikator obiektu użytkownika. Nie.
Wersja Przeprowadź inspekcję schematu wersji ("1.1"). Nie.

Zdarzenie: Zmiana etykiety

Nazwa Opis Wyczyszczony
Identyfikator akcji Unikatowy identyfikator akcji dla tego zdarzenia używany do korelacji zdarzeń. Nie.
ActionIdBefore Poprzedni identyfikator działania. Służy do łączenia się z nowym identyfikatorem działania. Nie.
ActionSource Wartość MIP::ActionSource. Nie.
App.IdentyfikatorAplikacji Identyfikator aplikacji podany za pośrednictwem mip::ApplicationInfo. Nie.
Aplikacja.NazwaAplikacji Nazwa aplikacji podana za pośrednictwem polecenia mip::ApplicationInfo. Nie.
App.WersjaAplikacji Wersja aplikacji udostępniana za pośrednictwem polecenia mip::ApplicationInfo. Nie.
Identyfikator aplikacji Identyfikator aplikacji podany za pośrednictwem polecenia mip::ApplicationInfo. Nie.
Nazwa Aplikacji Nazwa aplikacji podana za pośrednictwem polecenia mip::ApplicationInfo. Nie.
CzasUtworzenia Czas wygenerowania zdarzenia. Nie.
DataState Stan danych, gdy aplikacja działa na nim "REST", "MOTION", "USE". Nie.
DefaultLabel.Id Identyfikator etykiety najemcy domyślny. Nie.
Silnik.IdentyfikatorNajemcy Identyfikator GUID lokalnej dzierżawy uwierzytelnionego użytkownika. Nie.
Engine.UserObjectId Identyfikator obiektu użytkownika w identyfikatorze Entra firmy Microsoft. Nie.
Event.CorrelationId Wygenerowano unikatowy identyfikator skojarzony z obiektem, który wyzwolił zdarzenie. Nie.
Zdarzenie.OpisIdentyfikatoraKorelacji Nazwa klasy języka C++ obiektu, który wyzwolił zdarzenie. Nie.
Event.ParentCorrelationId Identyfikator korelacji zdarzenia nadrzędnego. Nie.
Opis Korelacji Identyfikatora Nadrzędnego Zdarzenia Wygenerowano unikatowy identyfikator skojarzony z elementem nadrzędnym obiektu, który wyzwolił zdarzenie. Nie.
Event.UniqueId Wygenerowany unikatowy identyfikator przypisany do zdarzenia. Nie.
CzyEtykietaZmieniona Wartość logiczna wskazująca, czy etykieta uległa zmianie. Nie.
CzyOchronaZostałaZmieniona Wartość logiczna wskazująca, czy ochrona została zmieniona. Nie.
ID etykiety Identyfikator etykiety, który ma zostać zastosowany do pliku lub danych. Nie.
LabelIdBefore Poprzedni identyfikator etykiety, który znajdował się w pliku lub danych. Nie.
NazwaMaszyny Nazwa systemu, który wygenerował zdarzenie. Tak
MIP.Wersja Wersja pakietu MIP SDK. Nie.
ObjectId (identyfikator obiektu) Ścieżka/opis pliku lub danych. Tak
Operacja "Zmień". Nie.
Identyfikator organizacji Identyfikator GUID dzierżawy głównej uwierzytelnionego użytkownika. Nie.
Platforma Wersja systemu operacyjnego. Nie.
ProcessName Nazwa procesu przy użyciu zestawu SDK. Nie.
Wersja produktu Nie.
Zabezpieczone Wartość logiczna wskazująca, czy plik jest chroniony, czy nie. Nie.
Chronione wcześniej Bool wskazujący, czy plik był wcześniej chroniony. Nie.
Ochrona Identyfikator szablonu ochrony. Nie.
Ochrona wcześniej Poprzedni identyfikator szablonu ochrony. Nie.
IdentyfikatorZawartościOchrony Nowy identyfikator zawartości (GUID). Nie.
IdentyfikatorZawartościOchronyPrzed Poprzedni identyfikator zawartości (GUID). Nie.
Właściciel ochrony Adres e-mail właściciela ochrony. Tak
OchronaWłaścicielaPrzed Poprzedni adres e-mail właściciela ochrony. Tak
SDKVersion Tak jak MIP.Version. Nie.
Identyfikator użytkownika Email adres użytkownika. Tak
IdentyfikatorObiektuUżytkownika Identyfikator obiektu użytkownika w Microsoft Entra. Nie.
Wersja Kontrola schematu wersji („1.1”). Nie.

Rezygnacja w języku C++

Aby ustawić diagnostykę na minimum, utwórz współdzielony wskaźnik mip::DiagnosticConfiguration() i ustaw isMinimalTelemetryEnabled na true. Przekaż obiekt do MipConfiguration::SetDiagnosticConfiguration(), następnie użyj MipConfiguration do wygenerowania 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);

Rezygnacja na platformie .NET

Aby ustawić dane diagnostyczne na wartość minimalną, utwórz obiekt DiagnosticConfiguration() i ustaw wartość true dla parametru isMinimalTelemetryEnabled . Ustaw właściwość DiagnosticOverride na MipConfiguration, a następnie utwórz 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);