zestaw SDK Microsoft Information Protection — konfiguracja diagnostyczna
Dane diagnostyczne
Domyślnie zestaw SDK pakietu Microsoft Information Protection wysyła dane diagnostyczne do firmy Microsoft. Te dane są przydatne do rozwiązywania problemów z błędami, jakością i wydajnością w całej bazie instalacji zestawu SDK, które mogą nie zostać przechwycone podczas testów wewnętrznych. Podczas implementowania aplikacji za pomocą zestawu SDK należy dać użytkownikom i administratorom możliwość rezygnacji z wysyłania danych diagnostycznych, jeśli będzie to konieczne.
Konfiguracja diagnostyczna
Opcje diagnostyczne w zestawie SDK miP można kontrolować za pośrednictwem DiagnosticConfiguration . Utwórz wystąpienie tej klasy, a następnie ustaw wartośćMinimalTelemetryEnabled na prawda. Podaj obiekt DiagnosticConfiguration klasy funkcji służącej do tworzenia tekstu MipContext.
Minimalne zdarzenia diagnostyczne
Gdy konfiguracja diagnostyczna jest ustawiona na wartość minimalną, do firmy Microsoft jest wysyłany minimalny zestaw danych. Wszelkie informacje umożliwiające identyfikację użytkownika są przesuwane po tych informacjach. Te dane zawierają informacje pulsu, aby zrozumieć, że używany jest zestaw SDK, oraz metadane systemowe. W usłudze nie jest ustawiana żadna zawartość użytkownika ani informacje umożliwiające identyfikację użytkownika końcowego.
Przejrzyj poniższe tabele, aby zobaczyć dokładnie, jakie zdarzenia i dane są wysyłane z włączoną minimalną diagnostyką.
Zdarzenie: Puls
| Nazwa | Opis | Przesuwanie |
|---|---|---|
| App.ApplicationId | Identyfikator aplikacji podany za pośrednictwem mip::ApplicationInfo. | Nie |
| App.ApplicationName | Nazwa aplikacji zapewniana przez mip::ApplicationInfo. | Nie |
| App.ApplicationVersion | Wersja aplikacji dostępna za pośrednictwem mip::ApplicationInfo. | Nie |
| ApplicationId | Wersja aplikacji dostępna za pośrednictwem mip::ApplicationInfo. | Nie |
| Nazwa_aplikacji | Nazwa aplikacji zapewniana przez mip::ApplicationInfo. | Nie |
| CreationTime | Zdarzenie czasu zostało wygenerowane. | Nie |
| DefaultLabel.Id | Domyślny identyfikator etykiety dzierżawy. | Nie |
| Engine.TenantId | Identyfikator GUID dzierżawy głównej uwierzytelnionego użytkownika. | Nie |
| Engine.UserObjectId | Identyfikator obiektu użytkownika w Azure Active Directory. | Nie |
| Event.CorrelationId | Wygenerowano unikatowy identyfikator skojarzony z obiektem, który wyzwolił zdarzenie. | Nie |
| Event.CorrelationIdDescription | C++ nazwa klasy obiektu, który wyzwolył zdarzenie. | Nie |
| Event.ParentCorrelationId | Identyfikator korelacji zdarzenia nadrzędnego. | Nie |
| Event.ParentCorrelationIdDescription | Wygenerowano unikatowy identyfikator skojarzony z elementem nadrzędnym obiektu, który wyzwolył zdarzenie. | Nie |
| Event.UniqueId | Wygenerowano unikatowy identyfikator przypisany do zdarzenia. | Nie |
| MachineName | Nazwa systemu, który wygenerował zdarzenie. | Tak |
| MIP. Wersja | Wersja zestawu SDK miP. | Nie |
| Operacja | Puls | Nie |
| OrganizationId | Identyfikator GUID dzierżawy głównej uwierzytelnionego użytkownika. | Nie |
| Platforma | Wersja systemu operacyjnego. | Nie |
| ProcessName | Nazwa procesu przy użyciu zestawu SDK. | Nie |
| ProductVersion | Taki sam jak "App.ApplicationVersion". | Nie |
| SDKVersion | Taki sam jak w przypadku miP. Wersja. | Nie |
| UserId | Adres e-mail użytkownika. | Tak |
| UserObjectId | Identyfikator obiektu usługi Azure AD użytkownika. | Nie |
| Wersja | Inspekcja schematu wersji ("1.1"). | Nie |
Zdarzenie: odnajdowanie
| Nazwa | Opis | Przesuwanie |
|---|---|---|
| ActionId | Unikatowy identyfikator działania dla tego zdarzenia, używany do korelacji zdarzenia. | Nie |
| App.ApplicationId | Identyfikator aplikacji podany za pośrednictwem mip::ApplicationInfo. | Nie |
| App.ApplicationName | Nazwa aplikacji zapewniana przez mip::ApplicationInfo. | Nie |
| App.ApplicationVersion | Wersja aplikacji dostępna za pośrednictwem mip::ApplicationInfo. | Nie |
| ApplicationId | Wersja aplikacji dostępna za pośrednictwem mip::ApplicationInfo. | Nie |
| Nazwa_aplikacji | Nazwa aplikacji zapewniana przez mip::ApplicationInfo. | Nie |
| CreationTime | Zdarzenie czasu zostało wygenerowane. | Nie |
| DataState | Stan danych, gdy aplikacja działa na nich "REST", "MOTION", "USE". | Nie |
| DefaultLabel.Id | Domyślny identyfikator etykiety dzierżawy. | Nie |
| Engine.TenantId | Identyfikator GUID dzierżawy głównej uwierzytelnionego użytkownika. | Nie |
| Engine.UserObjectId | Identyfikator obiektu użytkownika w Azure Active Directory. | Nie |
| Event.CorrelationId | Wygenerowano unikatowy identyfikator skojarzony z obiektem, który wyzwolił zdarzenie. | Nie |
| Event.CorrelationIdDescription | C++ nazwa klasy obiektu, który wyzwolył zdarzenie. | Nie |
| Event.ParentCorrelationId | Identyfikator korelacji zdarzenia nadrzędnego. | Nie |
| Event.ParentCorrelationIdDescription | Wygenerowano unikatowy identyfikator skojarzony z elementem nadrzędnym obiektu, który wyzwolył zdarzenie. | Nie |
| Event.UniqueId | Wygenerowano unikatowy identyfikator przypisany do zdarzenia. | Nie |
| LabelId | Identyfikator etykiety zawartości w otwieranych plikach lub danych. | Nie |
| MachineName | Nazwa systemu, który wygenerował zdarzenie. | Tak |
| MIP. Wersja | Wersja zestawu SDK miP. | Nie |
| ObjectId | Ścieżka pliku/opis pliku lub danych. | Tak |
| Operacja | "Odnajdowanie". | Nie |
| OrganizationId | Identyfikator GUID dzierżawy głównej uwierzytelnionego użytkownika. | Nie |
| Platforma | Wersja systemu operacyjnego. | Nie |
| ProcessName | Nazwa procesu przy użyciu zestawu SDK. | Nie |
| Chroniony | Wartość logiczna wskazująca, czy plik jest chroniony. | Nie |
| Ochrona | Identyfikator szablonu ochrony. | Tak |
| ProtectionOwner | Adres e-mail właściciela ochrony. | Tak |
| SDKVersion | Taki sam jak w przypadku miP. Wersja. | Nie |
| UserId | Adres e-mail użytkownika. | Tak |
| UserObjectId | Identyfikator obiektu usługi Azure AD użytkownika. | Nie |
| Wersja | Inspekcja schematu wersji ("1.1"). | Nie |
Zdarzenie: Zmiana etykiety
| Nazwa | Opis | Przesuwanie |
|---|---|---|
| ActionId | Unikatowy identyfikator działania dla tego zdarzenia, używany do korelacji zdarzenia. | Nie |
| ActionIdBefore | Identyfikator poprzedniej akcji. Służy do łańcucha po nowy identyfikator akcji. | Nie |
| ActionSource (Źródło Akcji) | Wartość właściwości MIP::ActionSource. | Nie |
| App.ApplicationId | Identyfikator aplikacji podany za pośrednictwem mip::ApplicationInfo. | Nie |
| App.ApplicationName | Nazwa aplikacji zapewniana przez mip::ApplicationInfo. | Nie |
| App.ApplicationVersion | Wersja aplikacji dostępna za pośrednictwem mip::ApplicationInfo. | Nie |
| ApplicationId | Identyfikator aplikacji podany za pośrednictwem mip::ApplicationInfo. | Nie |
| Nazwa_aplikacji | Nazwa aplikacji zapewniana przez mip::ApplicationInfo. | Nie |
| CreationTime | Godzina wygenerowania zdarzenia. | Nie |
| DataState | Stan danych, gdy aplikacja działa na nich "REST", "MOTION", "USE". | Nie |
| DefaultLabel.Id | Domyślny identyfikator etykiety dzierżawy. | Nie |
| Engine.TenantId | Identyfikator GUID dzierżawy głównej uwierzytelnionego użytkownika. | Nie |
| Engine.UserObjectId | Identyfikator obiektu użytkownika w Azure Active Directory. | Nie |
| Event.CorrelationId | Wygenerowano unikatowy identyfikator skojarzony z obiektem, który wyzwolił zdarzenie. | Nie |
| Event.CorrelationIdDescription | C++ nazwa klasy obiektu, który wyzwolył zdarzenie. | Nie |
| Event.ParentCorrelationId | Identyfikator korelacji zdarzenia nadrzędnego. | Nie |
| Event.ParentCorrelationIdDescription | Wygenerowano unikatowy identyfikator skojarzony z elementem nadrzędnym obiektu, który wyzwolył zdarzenie. | Nie |
| Event.UniqueId | Wygenerowano unikatowy identyfikator przypisany do zdarzenia. | Nie |
| IsLabelChanged | Wartość logiczna wskazująca, czy etykieta uległa zmianie. | Nie |
| IsProtectionChanged | Wartość logiczna wskazująca, czy zmiana ochrony uległa zmianie. | Nie |
| LabelId | Identyfikator etykiety, który ma zostać zastosowany do pliku lub danych. | Nie |
| LabelIdBefore | Poprzedni identyfikator etykiety, który był w pliku lub danych. | Nie |
| MachineName | Nazwa systemu, który wygenerował zdarzenie. | Tak |
| MIP. Wersja | Wersja zestawu SDK miP. | Nie |
| ObjectId | Ścieżka pliku/opis pliku lub danych. | Tak |
| Operacja | "Zmień". | Nie |
| OrganizationId | 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 | |
| Chroniony | Wartość logiczna wskazująca, czy plik jest chroniony. | Nie |
| Chroniony przed | Wartość logiczna wskazująca, czy plik był wcześniej chroniony. | Nie |
| Ochrona | Identyfikator szablonu ochrony. | Nie |
| Ochrona przed | Poprzedni identyfikator szablonu ochrony. | Nie |
| ProtectionContentId | Nowy identyfikator zawartości (GUID). | Nie |
| ProtectionContentIdBefore | Poprzedni identyfikator zawartości (GUID). | Nie |
| ProtectionOwner | Adres e-mail właściciela ochrony. | Tak |
| ProtectionOwnerBefore | Poprzedni adres e-mail właściciela ochrony. | Tak |
| SDKVersion | Taki sam jak w przypadku miP. Wersja. | Nie |
| UserId | Adres e-mail użytkownika. | Tak |
| UserObjectId | Identyfikator obiektu usługi Azure AD użytkownika. | Nie |
| Wersja | Inspekcja schematu wersji ("1.1"). | Nie |
Rezygnacja w C++
Aby ustawić tylko minimalną wartość diagnostyki, utwórz udostępniony wskaźnik mip::D iadiagsticConfiguration() i ustaw wartośćMinimalTelemetryEnabled na prawda. Przekaż obiekt, aby MipConfiguration::SetDiagnosticConfiguration() następnie użyć go do MipConfiguration 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 w programie .NET
Aby ustawić dane diagnostyczne tylko jako minimalne, utwórz obiekt DiagnosticConfiguration(), a następnie ustaw wartośćMinimalTelemetryEnabled na prawda. Ustaw właściwość DiagnosticOverrideMipConfiguration na, 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);