Microsoft Information Protection (MIP) SDK'sı hakkında SSS ve sorunlar
Bu makalede Sık Sorulan Sorulara (SSS) yanıtlar ve bilinen sorunlar ve yaygın hatalar için sorun giderme kılavuzu sağlanır.
Sık Sorulan Sorular
Meta Veri Depolama Değişiklikleri
Meta veriler hakkında SSS
Soru: PDF gibi diğer biçimler etkileniyor mu?
- Hayır, yalnızca Office dosyaları, özellikle Word, Excel ve PowerPoint dosyaları.
Soru: MIP SDK'sının gereken belirli bir sürümü var mı?
- MIP SDK 1.7 ve üzeri tamamen uyumludur.
Soru: Office istemcisinin bu depolama konumunu kullanması için gereken belirli bir sürümü var mı?
- Eylül 2021'de yayımlanan tüm Microsoft 365 Uygulamaları istemcileri bu yeni meta veri konumunu destekler. Korumalı birlikte yazma özelliği kiracı yöneticileri tarafından etkinleştirilene kadar yeni depolama konumu kullanılmaz.
Soru: Mevcut meta veriler custom.xml'da özel bir özellik olarak depolanıyor mu?
- Hayır Yeni depolama konumu etkinleştirildikten sonra belge ilk kez kaydedildiğinde etiket meta verileri yeni konuma taşınır. aracılığıyla
LabelingOptions.ExtendedPropertiesyazılan meta veriler custom.xml kalır.
Soru: MIP SDK'sı olmadan etiket meta verilerini okumak mümkün mü?
- Evet, ancak dosyayı ayrıştırmak ve bilgileri ayıklamak için kendi kodunuzu uygulamanız gerekir.
Soru: Şu anda dosyadan anahtar/değer çifti dizelerini ayıklayarak etiketi "okumak" kolaydır. Meta veriler hala bu şekilde okunabilir mi?
- Evet, meta veriler Office dosyası XML'sinde okunmaya devam eder. Uygulamanızın, yeni özellik kümesinin etkinleştirildiğini bilmesi için ilke dosyasından birlikte yazma ayarını okuması gerekir. Bu, etiket verilerinin okunacağı/yazıldığı yeri tanımlar (custom.xml ve labelinfo.xml). MS-OFFCRYPTO: LabelInfo ve Özel Belge Özelliklerini Gözden Geçirme | Microsoft Docs. uygulama ayrıntıları için.
Soru: Etiketler yeni konuma nasıl geçirilir?
- Etiket verilerini okumak veya yazmak için hangi bölümün okunup kullanıldığını belirlemek için aşağıdaki mantık kullanılır.
| Eylem | Özellik Etkin Değil | Özellik Etkin |
|---|---|---|
| Okundu | custom.xml (korumasız) veya Doc SummaryInfo (korumalı) içindeki etiket. | etiket labelinfo.xml varsa, geçerli etikettir. labelinfo.xml etiket yoksa, custom.xml veya Doc SummaryInfo'daki etiket etkili etikettir. |
| Write | Tüm yeni etiketler custom.xml (korumasız) veya Doc SummaryInfo'ya (korumalı) yazılır. | Tüm yeni etiketler labelinfo.xml yazılır. |
Dosya Ayrıştırma
Soru: Şu anda Dosya SDK'sı ile okuduğum dosyaya yazabilir miyim?
MIP SDK'sı aynı dosyayı eşzamanlı olarak okumayı ve yazmayı desteklemez. Etiketlenmiş tüm dosyalar, giriş dosyasının etiket eylemleri uygulanmış bir kopyasına neden olabilir. Uygulamanızın özgün dosyayı etiketlenmiş dosyayla değiştirmesi gerekir.
SDK dize işleme
Soru: SDK dizeleri nasıl işler ve kodumda hangi dize türünü kullanmalıyım?
SDK' nın platformlar arası kullanılması amaçlanmıştır ve dize işleme için UTF-8 (Unicode Dönüştürme Biçimi - 8 bit) kullanır. Belirli yönergeler, kullandığınız platforma bağlıdır:
| Platform | Rehber |
|---|---|
| Windows yerel | C++ SDK istemcileri için C++ Standart Kitaplığı türü std::string , API işlevlerine/api'den dizeleri geçirmek için kullanılır. UTF-8'e/UTF-8'den dönüştürme, MIP SDK'sı tarafından dahili olarak yönetilir. std::string BIR API'den döndürüldüğünde, dizeyi dönüştürürken UTF-8 kodlamasını beklemeniz ve buna göre yönetmeniz gerekir. Bazı durumlarda, bir dize bir uint8_t vektör (yayımlama lisansı (PL) gibi) kapsamında döndürülür, ancak opak blob olarak ele alınmalıdır.Daha fazla bilgi ve örnek için bkz:
|
| .NET | .NET SDK istemcileri için tüm dizeler varsayılan UTF-16 kodlamasını kullanır ve özel dönüştürme gerekmez. UTF-16'ya/UTF-16'dan dönüştürme, MIP SDK'sı tarafından dahili olarak yönetilir. |
| Diğer platformlar | MIP SDK tarafından desteklenen diğer tüm platformlar UTF-8 için yerel desteğe sahiptir. |
İçerik İşaretleme
Soru: MIP SDK'sı içerik işaretlemeyi destekliyor mu?
MIP SDK herhangi bir dosyada üst bilgi, alt bilgi veya filigran dahil olmak üzere doğrudan içerik işaretleme uygulamasını desteklemez. Etiket meta verileri bir dosyaya yazıldığında, Dosya SDK'sı korumanın uygulandığını (yapılandırıldıysa) belirtmek için contentBits meta veri özelliğini yazar. Üst bilgi, alt bilgi veya filigranın uygulandığını belirten özellikleri yazmaz. Dosya, içerik işaretlemeyi destekleyen bir uygulamada açıldığında, içerik işaretleme yapılandırması uygulama tarafından değerlendirilmeli ve kaydetme sırasında dosyaya yazılmalıdır.
Android'de Koruma ve İlke SDK'ları
Soru: MIP SDK'sını Android uygulamamla tümleştirmek için hangi paylaşılan kitaplığı kullanmalıyım?
MIP SDK Android ikili dosyaları , libmip_protection_sdk.sove libmip_upe_sdk.solipmip_unified.soiçerirlibmip_core.so. libmip_unified.so çekirdek, koruma ve ilke paylaşılan kitaplıklarını içeren önerilen kitaplıktır.
Uyumluluk
Soru: Microsoft Information Protection SDK FIPS 140-2 uyumlu mu?
Microsoft Information Protection SDK'sı FIPS 140-2 onaylı şifrelemeleri kullanır ancak fiPS 140-2 tarafından doğrulanmış şifreleme kitaplıklarını bugün kullanmaz. MIP SDK'sını kullanan uygulamaların şu anda SDK'nın FIPS uyumlu olarak kabul edilmediğinin farkında olması gerekir. Daha fazla bilgi için FIPS 140-2 uyumluluğu makalesine bakın.
Sorunlar ve hatalar başvurusu
Hata: "Dosya biçimi desteklenmiyor"
Soru: PDF dosyasını korumaya veya etiketlemeye çalışırken neden aşağıdaki hatayı alıyorum?
Dosya biçimi desteklenmiyor
Bu özel durum, dijital olarak imzalanmış veya parola korumalı bir PDF dosyasını korumaya veya etiketlemeye çalışmaktan kaynaklanmıştır. PDF dosyalarını koruma ve etiketleme hakkında daha fazla bilgi için bkz . Microsoft Information Protection ile PDF şifrelemesi için yeni destek.
Hata: "Alınan Uyumluluk İlkesi ayrıştırılamadı"
Soru: MIP SDK'sını indirdikten ve tüm etiketleri listelemek için dosya örneğini kullanmayı denedikten sonra neden aşağıdaki hatayı alıyorum?
Kötü bir şey oldu: Alınan Uyumluluk İlkesi ayrıştırılamadı. Başarısız: [class mip::CompliancePolicyParserException] Etiket bulunamadı: policy, NodeType: 15, Name: No Name Found, Value: , Ancestors:
<SyncFile><Content>, correlationId:[34668a40-blll-4ef8-b2af-00005aa674z9]
Bu hata, etiketlerinizi Azure Information Protection'dan birleşik etiketleme deneyimine geçirmediğinize işaret eder. Etiketleri geçirmek için Azure Information Protection etiketlerini birleşik duyarlılık etiketlerine geçirme bölümünü izleyin ve ardından Office 365 Güvenlik ve uyumluluk portalında etiket ilkesi oluşturun.
Hata: "NoPolicyException: Etiket ilkesi veri içermiyordu"
Soru: MIP SDK'sı aracılığıyla etiket veya liste etiketlerini okumaya çalışırken neden aşağıdaki hatayı alıyorum?
NoPolicyException: Etiket ilkesi veri içermiyordu, CorrelationId=GUID, CorrelationId.Description=PolicyProfile, NoPolicyError.Category=SyncFile, NoPolicyError.Category=SyncFile
Bu hata, bir etiket ilkesinin Microsoft Purview uyumluluk portalı yayımlanmadığını gösterir. Etiketleme ilkesini yapılandırmak için Duyarlılık etiketleri ve bunların ilkelerini oluşturma ve yapılandırma'yı izleyin.
Hata: "System.ComponentModel.Win32Exception: LoadLibrary başarısız oldu"
Soru: MIP SDK .NET Sarmalayıcısını kullanırken neden aşağıdaki hatayı alıyorum?
System.ComponentModel.Win32Exception: LoadLibrary, MIP çağrılırken [sdk_wrapper_dotnet.dll] için başarısız oldu. Initialize().
Uygulamanızın gerekli çalışma zamanı yok veya Yayın olarak derlenmedi. Daha fazla bilgi için bkz . Uygulamanızın gerekli çalışma zamanına sahip olduğundan emin olun.
Hata: "ProxyAuthError özel durumu"
Soru: MIP SDK'sını kullanırken neden aşağıdaki hatayı alıyorum?
"ProxyAuthenticatonError: Proxy kimlik doğrulaması desteklenmiyor"
MIP SDK'sı, kimliği doğrulanmış ara sunucuların kullanımını desteklemez. Bu iletiyi düzeltmek için ara sunucu yöneticileri Microsoft Purview Bilgi Koruması hizmet uç noktalarını ara sunucuyu atlayacak şekilde ayarlamalıdır. Bu uç noktaların listesini Office 365 URL'leri ve IP adresi aralıkları sayfasında bulabilirsiniz. MIP SDK'sı *.protection.outlook.com , (satır 9) ve Azure Information Protection hizmet uç noktalarının (satır 73) proxy kimlik doğrulamasını atlamasına ihtiyaç duyar.
Hata: Akış çıktısı kullanarak bir görüntü dosyasını etiketlerken "Bilinmeyen Hata"
Soru: Çıkış için akış kullanarak bir resim dosyası türüne etiket veya koruma eklemeye veya kaldırmaya çalışırken neden "bilinmeyen bir hata" alıyorum?
Çıkış için bir akış kullanırken, bir görüntü dosyasının etiketini veya korumasını değiştirmek için akışın hem okuma hem de yazma erişimi olmalıdır.
Soru: MIP SDK'sını kullanırken hizmet tabanlı azaltma sınırları var mı?
Dosya SDK'sında koruma SDK'sı veya koruma işlemleri tarafından kullanılan koruma hizmetinin, kuruluşun tamamı için on saniyede 7.500 istek sınırı vardır. Başka bir deyişle, Uygulama A on saniyede 4.000 istek oluşturuyorsa ve aynı organzasyonda Applicaiton B on saniyede 4.000 istek oluşturuyorsa, her iki uygulama da yanıt almaya HTTP 429 Too Many Requests başlayabilir. Bu özel durumlar alındığında geliştiricilerin geri alma süresi uygulaması gerekir.
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin