Partager via

Kit de développement logiciel (SDK) Microsoft Information Protection - Configuration de diagnostic

Données de diagnostic

Par défaut, le Kit de développement logiciel (SDK) Microsoft Information Protection envoie des données de diagnostic à Microsoft. Ces données sont utiles pour résoudre les bogues, la qualité et les problèmes de performances dans la base d’installation du Kit de développement logiciel (SDK) que nous ne pouvons pas capturer dans nos tests internes. Lors de l’implémentation de votre application avec le Kit de développement logiciel (SDK), il est important de donner aux utilisateurs et aux administrateurs la possibilité de refuser l’envoi de données de diagnostic si nécessaire.

Configuration du diagnostic

Les options de diagnostic dans le SDK MIP peuvent être contrôlées via DiagnosticConfiguration. Créez une instance de cette classe, puis définissez isMinimalTelemetryEnabled sur true. Fournissez l’objet de la classe DiagnosticConfiguration à la fonction utilisée pour créer MipContext.

Événements de diagnostic minimum

Lorsque la configuration de diagnostic est définie sur minimale, un ensemble minimal de données est envoyé à Microsoft. Toutes les informations d’identification personnelle sont supprimées de ces informations. Ces données incluent des informations de pulsation pour comprendre que le Kit de développement logiciel (SDK) est utilisé et les métadonnées système. Aucun contenu utilisateur ni aucune information d’identification de l’utilisateur final n’est définie sur le service.

Passez en revue les tableaux ci-dessous pour voir exactement quels événements et données sont envoyés avec des diagnostics minimaux activés.

Événement : rythme cardiaque

Nom Description Nettoyé
App.ApplicationId Identificateur d’application fourni via mip ::ApplicationInfo. Non
App.ApplicationName Nom de l’application fourni via mip ::ApplicationInfo. Non
App.ApplicationVersion Version de l’application fournie via mip ::ApplicationInfo. Non
ApplicationId Version de l’application fournie via mip ::ApplicationInfo. Non
Nom de l'application Nom de l’application fourni via mip ::ApplicationInfo. Non
CreationTime Heure à laquelle l’événement a été généré. Non
DefaultLabel.Id ID d’étiquette de locataire par défaut. Non
Engine.TenantId GUID du locataire principal de l’utilisateur authentifié. Non
Engine.UserObjectId ID d’objet utilisateur dans Microsoft Entra ID. Non
Event.CorrelationId ID unique généré associé à l’objet qui a déclenché l’événement. Non
Event.CorrelationIdDescription Nom de classe C++ de l’objet qui a déclenché l’événement. Non
Event.ParentCorrelationId ID de corrélation d’événement parent. Non
Event.ParentCorrelationIdDescription ID unique généré associé au parent de l’objet qui a déclenché l’événement. Non
Event.UniqueId L'ID unique générée est attribuée à l'événement. Non
MachineName Nom du système qui a généré l’événement. Oui
MIP.Version Version du Kit de développement logiciel (SDK) MIP. Non
Opération Pulsation Non
Identifiant de l'Organisation GUID du locataire principal de l’utilisateur authentifié. Non
Plate-forme Version du système d’exploitation. Non
ProcessName Nom du processus à l’aide du Kit de développement logiciel (SDK). Non
ProductVersion Identique à « App.ApplicationVersion ». Non
Version du SDK Identique à MIP.Version. Non
ID utilisateur Email’adresse de l’utilisateur. Oui
UserObjectId ID d’objet Microsoft Entra de l’utilisateur. Non
Version Auditer le schéma de version (« 1.1 »). Non

Événement : découverte

Nom Description Nettoyé
ActionId ID d’action unique pour cet événement, utilisé pour la corrélation d’événements. Non
App.ApplicationId Identificateur d’application fourni via mip ::ApplicationInfo. Non
App.ApplicationName Nom de l’application fourni via mip ::ApplicationInfo. Non
App.ApplicationVersion Version de l’application fournie via mip ::ApplicationInfo. Non
ApplicationId Version de l’application fournie via mip ::ApplicationInfo. Non
Nom de l'application Nom de l’application fourni via mip ::ApplicationInfo. Non
CreationTime Heure à laquelle l’événement a été généré. Non
DataState État des données à mesure que l’application agit sur elle « REST », « MOTION », « USE ». Non
DefaultLabel.Id Identificateur d’étiquette par défaut du locataire. Non
Engine.TenantId GUID du locataire principal de l’utilisateur authentifié. Non
Engine.UserObjectId Identificateur d’objet utilisateur dans l’Entra ID de Microsoft. Non
Event.CorrelationId ID unique généré associé à l’objet qui a déclenché l’événement. Non
Event.CorrelationIdDescription Nom de classe C++ de l’objet qui a déclenché l’événement. Non
Event.ParentCorrelationId ID de corrélation d’événement parent. Non
Event.ParentCorrelationIdDescription ID unique généré associé au parent de l’objet qui a déclenché l’événement. Non
Event.UniqueId Identifiant unique généré affecté à l’événement. Non
LabelId Identificateur d’étiquette de contenu sur le fichier ou les données ouverts. Non
MachineName Nom du système qui a généré l’événement. Oui
MIP.Version Version du Kit de développement logiciel (SDK) MIP. Non
Identifiant d'objet Chemin/description du fichier ou des données. Oui
Opération « Découverte ». Non
Identifiant de l'Organisation GUID du locataire principal de l’utilisateur authentifié. Non
Plate-forme Version du système d’exploitation. Non
ProcessName Nom du processus à l’aide du Kit de développement logiciel (SDK). Non
Protégé Booléen indiquant si le fichier est protégé ou non. Non
Protection Identificateur du modèle de protection. Oui
ProtectionOwner Adresse e-mail du propriétaire de la protection. Oui
Version du SDK Identique à MIP.Version. Non
ID utilisateur Email’adresse de l’utilisateur. Oui
UserObjectId ID d'objet Microsoft Entra de l'utilisateur. Non
Version Auditer le schéma de version (« 1.1 »). Non

Événement : Changement d’étiquette

Nom Description Nettoyé
ActionId ID d’action unique pour cet événement, utilisé pour la corrélation d’événements. Non
ActionIdBefore ID d’action précédent. Utilisé pour la liaison à un nouvel identifiant d’action. Non
ActionSource Valeur de MIP::ActionSource. Non
App.ApplicationId ID d’application fourni via mip ::ApplicationInfo. Non
App.ApplicationName Nom de l’application fourni via mip ::ApplicationInfo. Non
App.ApplicationVersion Version de l’application fournie via mip ::ApplicationInfo. Non
ApplicationId ID d’application fourni via mip ::ApplicationInfo. Non
Nom de l'application Nom de l’application fourni via mip ::ApplicationInfo. Non
CreationTime Heure à laquelle l'événement a été généré. Non
DataState État des données à mesure que l’application agit sur elle « REST », « MOTION », « USE ». Non
DefaultLabel.Id Identificateur d’étiquette par défaut du locataire. Non
Engine.TenantId GUID du locataire principal de l’utilisateur authentifié. Non
Engine.UserObjectId Identificateur d'objet utilisateur dans Microsoft Entra ID. Non
Event.CorrelationId ID unique généré associé à l’objet qui a déclenché l’événement. Non
Event.CorrelationIdDescription Nom de classe C++ de l’objet qui a déclenché l’événement. Non
Event.ParentCorrelationId ID de corrélation d’événement parent. Non
Event.ParentCorrelationIdDescription ID unique généré associé au parent de l’objet qui a déclenché l’événement. Non
Event.UniqueId Identifiant unique généré affecté à l’événement. Non
IsLabelChanged Booléen indiquant si l’étiquette a changé. Non
Est-ce que la protection a changé Booléen indiquant si la protection a changé. Non
LabelId ID d’étiquette à appliquer au fichier ou aux données. Non
LabelIdBefore ID d’étiquette précédent figurant sur le fichier ou les données. Non
MachineName Nom du système qui a généré l’événement. Oui
MIP.Version Version du Kit de développement logiciel (SDK) MIP. Non
Identifiant d'objet Chemin/description du fichier ou des données. Oui
Opération « Modifier ». Non
Identifiant de l'Organisation GUID du locataire principal de l’utilisateur authentifié. Non
Plate-forme Version du système d’exploitation. Non
ProcessName Nom du processus à l’aide du Kit de développement logiciel (SDK). Non
Version de produit Non
Protégé Booléen indiquant si le fichier est protégé ou non. Non
Protected Before Booléen indiquant si le fichier a été précédemment protégé ou non. Non
Protection Identificateur du modèle de protection. Non
Protection Before Identificateur du modèle de protection précédent. Non
ProtectionContentId Nouvel identificateur de contenu (GUID). Non
ProtectionContentIdBefore Identificateur de contenu précédent (GUID). Non
ProtectionOwner Adresse e-mail du propriétaire de la protection. Oui
ProtectionOwnerBefore Adresse e-mail précédente du propriétaire de la protection. Oui
Version du SDK Identique à MIP.Version. Non
ID utilisateur Email’adresse de l’utilisateur. Oui
UserObjectId ID d'objet Microsoft Entra de l'utilisateur. Non
Version Auditer le schéma de version (« 1.1 »). Non

Désactivation en C++

Pour définir les diagnostics sur minimum uniquement, créez un pointeur partagé mip::DiagnosticConfiguration() et définissez isMinimalTelemetryEnabled sur true. Transmettez l'objet à MipConfiguration::SetDiagnosticConfiguration() puis utilisez MipConfiguration pour générer 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);

Désactivation dans .NET

Pour définir les données de diagnostic sur le minimum uniquement, créez un objet DiagnosticConfiguration() et définissez isMinimalTelemetryEnabled sur vrai. Définissez la DiagnosticOverride propriété sur MipConfiguration puis créez le 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);
  • Last updated on