FAQ et problèmes liés au kit de développement logiciel (SDK) Microsoft Information Protection (MIP)
Cet article fournit des réponses aux questions fréquentes (FAQ) et des conseils de résolution des problèmes connus et des erreurs courantes.
Forums Aux Questions (FAQ)
question : combien d’étiquettes sont prises en charge par le SDK MIP ?
- Le SDK MIP peut gérer jusqu’à 500 étiquettes de protection et il n’existe aucune limite pour les étiquettes sans protection.
Question : Le SDK MIP prend-il en charge le réétiquetage des types .pfile avec des étiquettes de classification ?
- Non, c’est par conception, car les fichiers pfile sont des types de fichiers protégés. Déchiffrer avec l’étiquette de fichier MPIP avant la classification.
Question : Pourquoi les fichiers protégés téléchargés à partir de Microsoft Teams ne parviennent-ils pas à déchiffrer ?
- Il s’agit d’un problème connu dans les versions non prises en charge du Kit de développement logiciel (SDK) MIP. Effectuez une mise à niveau vers la dernière version du Kit de développement logiciel (SDK) MIP.
Question : Comment vérifier quelles étiquettes sont appliquées lorsque plusieurs étiquettes provenant de différents locataires sont appliquées à un fichier ?
- Interroger le GetLabel dans le contexte de l'utilisateur pour chaque locataire.
Question : Pourquoi mon application web ne parvient-elle pas à initialiser avec « InternalError : « KeyStoreWin32 ::OpenKey failure : NCryptOpenKey :-2147024894 » ?
- Le Kit de développement logiciel (SDK) de stratégie peut ne pas charger un profil pendant l’initialisation de l’application. Définissez WEBSITE_LOAD_USER_PROFILE=1 dans le paramètre de variable d’environnement de votre application web et redémarrez l’application.
- Nom : WEBSITE_LOAD_USER_PROFILE
- Valeur : 1
Question : Pourquoi mon application échoue-t-elle avec « KeyStoreWin32 ::OpenKey failure : NCryptOpenKey :-2146893788 » lorsque la mise en cache OnDiskEncrypted est configurée ?
- Windows peut créer des profils temporaires lorsque votre profil de connexion n’est pas disponible. La lecture du registre Windows pour la mise en cache OnDiskEncrypted Link avec ce profil temporaire provoque l'échec d'OpenKey dans le journal du SDK MIP et est capturé par les journaux d'événements du système d'exploitation Windows avec l'ID d'événement 1511 & 1515. Pour résoudre ce problème, contactez votre administrateur pour résoudre le problème de création de profils temporaires.
Modifications du stockage des métadonnées
Nous avons annoncé que nous apportons une modification à l’emplacement de stockage des métadonnées d’étiquette pour les fichiers Office (Word, Excel, PowerPoint) pour prendre en charge de nouvelles fonctionnalités dans Office 365, SharePoint Online et d’autres services.
FAQ sur les métadonnées
Question : D’autres formats sont-ils affectés, tels que PDF ?
- Non, seuls les fichiers Office, en particulier les fichiers Word, Excel et PowerPoint.
Question : Existe-t-il une version spécifique du SDK MIP requise ?
- Le SDK MIP 1.7 et les versions ultérieures sont entièrement compatibles.
Question : Existe-t-il une version spécifique du client Office requise pour utiliser cet emplacement de stockage ?
- Tous les clients Applications Microsoft 365 publiés après septembre 2021 prennent en charge ce nouvel emplacement de métadonnées. Le nouvel emplacement de stockage n’est pas utilisé tant que les administrateurs clients n’activent pas la fonctionnalité de co-création protégée.
Question : Les métadonnées existantes sont-elles stockées en tant que propriété personnalisée dans custom.xml être conservées à jour ?
- Non. La première fois que le document est enregistré une fois que le nouvel emplacement de stockage est activé, les métadonnées d’étiquette sont déplacées vers le nouvel emplacement. Les métadonnées écrites via
LabelingOptions.ExtendedPropertiesrestent dans custom.xml.
Question : Est-il possible de lire les métadonnées d’étiquette sans sdk MIP ?
- Oui, mais vous devez implémenter votre propre code pour analyser le fichier et extraire les informations.
Question : Actuellement, il est facile de « lire » l’étiquette en extrayant les chaînes de paire clé-valeur du fichier. Les métadonnées peuvent-elles toujours être lues de cette façon ?
- Oui, les métadonnées sont toujours disponibles dans le fichier XML du fichier Office à lire. Votre application doit lire le paramètre de co-création à partir du fichier de stratégie pour savoir que le nouvel ensemble de fonctionnalités est activé. Ce paramètre définit l’emplacement où lire/écrire les données d’étiquette (custom.xml et labelinfo.xml). Consultez MS-OFFCRYPTO : LabelInfo et Propriétés personnalisées du document | Microsoft Docs. pour plus d’informations sur l’implémentation.
Question : Comment faire déterminer si la co-création est activée dans la stratégie d’étiquette ? L’état du paramètre de co-création est retourné par le moteur de stratégie. Une application peut lire les octets bruts du moteur de stratégie pour déterminer l’état de co-création.
Question : Comment les étiquettes sont-elles migrées vers le nouvel emplacement ?
- La logique suivante permet de déterminer quelle section est lue et utilisée pour lire ou écrire des données d’étiquette.
| Action | Fonctionnalité non activée | Fonctionnalité activée |
|---|---|---|
| Lire | Étiquette dans custom.xml (non protégé) ou Doc SummaryInfo (protégé). | Si l’étiquette existe dans labelinfo.xml, il s’agit de l’étiquette effective. S’il n’existe aucune étiquette dans labelinfo.xml, l’étiquette dans custom.xml ou Doc SummaryInfo est l’étiquette effective. |
| Write | Toutes les nouvelles étiquettes sont écrites dans custom.xml (non protégé) ou Doc SummaryInfo (protégé). | Toutes les nouvelles étiquettes sont écrites dans labelinfo.xml. |
Analyse des fichiers
Question : Puis-je écrire dans le même fichier que celui que je lis actuellement avec le kit de développement logiciel (SDK) File ?
Le SDK MIP ne prend pas en charge simultanément la lecture et l’écriture du même fichier. Tous les fichiers étiquetés entraînent une copie du fichier d’entrée avec les actions d’étiquette appliquées. Votre application doit remplacer l’original par le fichier étiqueté.
Gestion des chaînes du SDK
Question : Comment le SDK gère-t-il les chaînes, et quel type de chaîne faut-il utiliser dans mon code ?
Le SDK est destiné à être utilisé sur plusieurs plateformes et utilise UTF-8 (Unicode Transformation Format - 8 bits) pour la gestion des chaînes. Des conseils spécifiques dépendent de la plateforme que vous utilisez :
| Plateforme | Assistance |
|---|---|
| Natif Windows | Pour les clients SDK C++, le type de bibliothèque standard C++ std::string est utilisé pour passer des chaînes vers/depuis des fonctions d’API. Le SDK MIP gère en interne la conversion vers/à partir de UTF-8. Lorsqu’une API std::string est retournée, vous devez vous attendre à un encodage UTF-8 et gérer en conséquence l’éventuelle conversion de la chaîne. Dans certains cas, une chaîne est retournée dans le cadre d’un vecteur uint8_t (par exemple, une licence de publication (PL)), mais doit être traitée comme un objet blob opaque.Pour plus d’informations et d’exemples, consultez :
|
| .NET | Pour les clients SDK .NET, toutes les chaînes utilisent l’encodage UTF-16 par défaut et aucune conversion spéciale n’est nécessaire. Le SDK MIP gère en interne la conversion vers/à partir de UTF-16. |
| Autres plateformes | Toutes les autres plateformes prises en charge par le SDK MIP prennent en charge nativement UTF-8. |
Marquage du contenu
Question : Le SDK MIP prend-il en charge le marquage de contenu ?
Le SDK MIP ne prend pas en charge l’application directe du marquage de contenu, y compris l’en-tête, le pied de page ou le filigrane, sur tous les fichiers. Lorsque les métadonnées d’étiquette sont écrites dans un fichier, le Kit de développement logiciel (SDK) File écrit la propriété de métadonnées contentBits pour indiquer que la protection a été appliquée (si configurée). Elle n’écrit pas les propriétés qui indiquent l’en-tête, le pied de page ou le filigrane ont été appliquées. Lorsque le fichier est ouvert dans une application, la configuration du marquage du contenu doit être évaluée par l’application et écrite dans le fichier lors de l’enregistrement.
Kit de développement logiciel (SDK) de protection et de stratégie sur Android
Question : Quelle bibliothèque partagée dois-je utiliser pour intégrer le SDK MIP dans mon application Android ?
Les fichiers binaires Android du SDK MIP incluent libmip_core.so, libmip_protection_sdk.solibmip_upe_sdk.so et lipmip_unified.so. libmip_unified.so est la bibliothèque recommandée qui inclut les bibliothèques partagées de base, de protection et de stratégie.
Conformité
Question : Microsoft Protection des données SDK Federal Information Processing Standard (FIPS) 140-2 est-il conforme ?
Consultez la validation FIPS 140-2.
Informations de référence sur les problèmes et les erreurs
Erreur : « Format de fichier non pris en charge »
Question : Pourquoi est-ce que j’obtiens l’erreur suivante lors de la tentative de protection ou d’étiquetage d’un fichier PDF ?
Format de fichier non pris en charge
Cette exception résulte de la tentative de protection ou d’étiquetage d’un fichier PDF signé numériquement ou protégé par mot de passe. Consultez la nouvelle prise en charge du chiffrement PDF avec Microsoft Information Protection pour plus d’informations sur la protection et l’étiquetage des fichiers PDF.
Erreur : « NoPolicyException : La stratégie d’étiquette ne contenait pas de données »
Question : Pourquoi est-ce que j’obtiens l’erreur suivante lors de la tentative de lecture d’une étiquette ou d’une liste d’étiquettes via le SDK MIP ?
NoPolicyException : La stratégie d’étiquette ne contenait pas de données, CorrelationId=GUID, CorrelationId.Description=PolicyProfile, NoPolicyError.Category=SyncFile, NoPolicyError.Category=SyncFile
Cette erreur indique qu’une stratégie d’étiquette n’est pas publiée dans le portail de conformité Microsoft Purview. Suivez Créer et configurer des étiquettes de confidentialité et leurs stratégies pour configurer la stratégie d’étiquetage.
Si une stratégie d’étiquetage a été publiée, assurez-vous que le compte d’utilisateur est inclus dans tous les groupes qui font partie de la section publiée dans la section de la configuration de la stratégie d’étiquette. Pour plus d’informations, consultez Créer et publier des étiquettes de confidentialité.
Les utilisateurs externes, y compris les utilisateurs invités, ne peuvent pas accéder aux stratégies d’étiquette d’une autre organisation. Pour prendre en charge ces utilisateurs, implémentez un mécanisme de nouvelle tentative. Si une NoPolicyException exception est levée, définissez la FileEngineSettings propriété ProtectionOnlyEngine sur true et réessayez la requête. Les opérations d’étiquetage ne seront pas disponibles pour cette IFileEngine instance, mais les opérations de protection seront disponibles.
Erreur : « System.ComponentModel.Win32Exception : Échec de LoadLibrary »
Question : Pourquoi est-ce que j’obtiens l’erreur suivante lors de l’utilisation du wrapper .NET du SDK MIP ?
System.ComponentModel.Win32Exception : Échec de LoadLibrary pour : [sdk_wrapper_dotnet.dll] lors de l’appel de MIP.Initialize().
Votre application n’a pas le runtime requis ou n’a pas été générée en tant que version. Pour plus d’informations, consultez Vérifier que votre application dispose du runtime requis.
Erreur : « Exception ProxyAuthError »
Question : Pourquoi est-ce que j’obtiens l’erreur suivante lors de l’utilisation du kit de développement logiciel (SDK) MIP ?
« ProxyAuthenticatonError : l’authentification proxy n’est pas prise en charge »
Le kit de développement logiciel (SDK) MIP ne prend pas en charge l’utilisation de proxys authentifiés. Pour résoudre ce message, les administrateurs de proxy doivent définir les points de terminaison de service Protection des données Microsoft Purview pour contourner le proxy. Une liste de ces points de terminaison est disponible sur la page URL et plages d’adresses IP Office 365. Le kit de développement logiciel (SDK) MIP nécessite que *.protection.outlook.com (ligne 9) et les points de terminaison de service Azure Information Protection (ligne 73) contournent l’authentification proxy.
Erreur : « Erreur inconnue » lors de l’étiquetage d’un fichier image à l’aide d’une sortie de flux
Question : Pourquoi est-ce que j’obtiens une « erreur inconnue » quand j’essaie d’ajouter ou de supprimer une étiquette ou une protection d’un type de fichier image à l’aide d’un flux de sortie ?
Lorsque vous utilisez un flux de sortie, le flux doit avoir à la fois un accès en lecture et en écriture pour modifier l’étiquette ou la protection d’un fichier image.
Question : Existe-t-il des limites de limitation basées sur le service lors de l’utilisation du Kit de développement logiciel (SDK) MIP ?
Le service de protection, utilisé par les opérations de protection ou de protection dans le Kit de développement logiciel (SDK) de fichier, a une limite de 7 500 requêtes par 10 secondes pour toute une organisation. Autrement dit, si l’application A génère 4 000 requêtes par 10 secondes et que l’application B dans la même organisation génère 4 000 requêtes par 10 secondes, les deux applications peuvent commencer à recevoir HTTP 429 Too Many Requests des réponses. Les développeurs doivent implémenter une période d’interruption lorsque ces exceptions sont reçues.