Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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
Soru: MIP SDK tarafından kaç etiket desteklenir?
- MIP SDK'sı en fazla 500 koruma etiketini işleyebilir ve koruma olmadan etiketler için bir sınır yoktur.
Soru: MIP SDK'sı sınıflandırma etiketleriyle .pfile türlerini yeniden etiketlemeyi destekliyor mu?
- Hayır, bu tasarım gereğidir çünkü pfile'lar korumalı dosya türleridir. Sınıflandırmadan önce MPIP Dosya Etiketleyicisi ile şifresini çöz.
Soru: Microsoft Teams'den indirilen korumalı dosyaların şifresi neden çözülemiyor?
- Bu, MIP SDK'sının desteklenmeyen sürümlerinde bilinen bir sorundur. MIP SDK'sının en son sürümüne yükseltin.
Soru: Bir dosyaya farklı kiracılardan birden çok etiket uygulandığında hangi etiketlerin uygulandığını nasıl denetleyebilirim?
- GetLabel'i kullanıcı bağlamında her kiracı için sorgula.
Soru: Web uygulamam neden "InternalError: 'KeyStoreWin32::OpenKey failure: NCryptOpenKey:-2147024894'" ile başlatılamıyor?
- İlke SDK'sı, uygulama başlatma sırasında bir profili yükleyemeyebilir. Web uygulamanızın ortam değişkeni ayarında WEBSITE_LOAD_USER_PROFILE=1 değerini ayarlayın ve uygulamayı yeniden başlatın.
- Adı: WEBSITE_KULLANICI_PROFİLİ_YÜKLE
- Değer: 1
Soru: OnDiskEncrypted önbelleğe alma yapılandırıldığında uygulamam neden "KeyStoreWin32::OpenKey hatası: NCryptOpenKey:-2146893788" ile başarısız oluyor?
- Oturum açma profiliniz kullanılamadığında Windows geçici profiller oluşturabilir. Windows kayıt defterinden OnDiskEncrypted önbelleğe alma için okuma, bu geçici profil ile bağlantısı, MIP SDK günlüğünde OpenKey hatasına neden olur ve Windows işletim sistemi olay günlüklerinde Olay Kimliği 1511 & 1515 ile kaydedilir. Bu sorunu çözmek için geçici profil oluşturma sorununu çözmek için yöneticinize başvurun.
Meta Veri Depolama Değişiklikleri
Meta verilerle ilgili 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'den sonra yayımlanan tüm Microsoft 365 Uygulamaları bu yeni meta veri konumunu destekler. Kiracı yöneticileri korumalı birlikte yazma özelliğini etkinleştirene kadar yeni depolama konumu kullanılmaz.
Soru: Var olan meta veriler custom.xml dosyasında özel bir özellik olarak mı depolanıyor ve güncel tutuluyor mu?
- Hayır Yeni depolama konumu etkinleştirildikten sonra belge ilk kez kaydedildiğinde etiket meta verileri yeni konuma taşınır.
LabelingOptions.ExtendedPropertiesaracılığıyla yazılan meta veriler custom.xml dosyasında 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 hâlâ okunabilir. Uygulamanızın, yeni özellik kümesinin etkinleştirildiğini bilmesi için ilke dosyasından birlikte yazma ayarını okuması gerekir. Bu ayar etiket verilerinin okunacağı/yazıldığı yeri tanımlar (custom.xml ve labelinfo.xml). Uygulama ayrıntıları için MS-OFFCRYPTO: LabelInfo ve Özel Belge Özelliklerini Microsoft Docs'ta inceleyin.
Soru: Etiket politikasında ortak yazmanın etkin olup olmadığını nasıl belirlerim? Birlikte yazma ayarının durumu, politika motorundan döndürülür. Bir uygulama, birlikte yazma durumunu belirlemek amacıyla ilke motorundan ham baytları okuyabilir.
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. | Eğer etiket labelinfo.xml dosyasında varsa, geçerli etikettir. Eğer labelinfo.xml'de bir etiket yoksa, custom.xml veya Doc SummaryInfo'daki etiket geçerli etiket olarak kabul edilir. |
| Yaz | Tüm yeni etiketler custom.xml (korumasız) veya Doc SummaryInfo'ya (korumalı) yazılır. | Tüm yeni etiketler labelinfo.xml dosyasına 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:
| Platforma | 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. MIP SDK, UTF-8'e dönüştürmeyi dahili olarak yönetir. Bir API'den std::string döndüğü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ü (örn. yayımlama lisansı (PL)) olarak döndürülür, ancak opak bir verikümesi 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. MIP SDK'sı UTF-16'ya dönüştürmeyi dahili olarak yönetir. |
| 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. Başlık, dipnot veya filigranın uygulandığını belirten özellikleri yazmaz. Dosya 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'sı
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_core.so, libmip_protection_sdk.so, libmip_upe_sdk.so ve libmip_unified.so içerir. Önerilen kitaplık olan libmip_unified.so, çekirdek, koruma ve ilke paylaşılan kitaplıklarını içerir.
Uyumluluk
Soru: Microsoft Information Protection SDK Federal Information Processing Standard (FIPS) 140-2 uyumlu mu?
Bkz. FIPS 140-2 Doğrulama.
Sorunlar ve hatalar referansı
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 imzalanan veya parola korumalı bir PDF dosyasını korumaya veya etiketlemeye çalışmaktan kaynaklanı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: "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 politikası veri içermiyor, CorrelationId=GUID, CorrelationId.Description=PolicyProfile, NoPolicyError.Category=SyncFile, NoPolicyError.Category=SyncFile
Bu hata, bir etiket ilkesinin Microsoft Purview portalında yayımlanmadığını gösterir. Etiketleme ilkesini yapılandırmak amacıyla Duyarlılık etiketlerini ve bunların ilkelerini oluşturma ve yapılandırma adımlarını izleyin.
Bir etiketleme ilkesi yayımlandıysa, kullanıcı hesabının etiket ilkesi yapılandırmasının yayımlandığı bölümün parçası olan tüm gruplara dahil olduğundan emin olun. Daha fazla bilgi için Duyarlılık Etiketleri Oluşturma ve Yayımlama'yı gözden geçirin.
Konuk kullanıcılar da dahil olmak üzere dış kullanıcılar başka bir kuruluşun etiket ilkelerine erişemez. Bu kullanıcıların ihtiyaçlarını karşılamak için bir yeniden deneme mekanizması uygulayın. Eğer bir NoPolicyException atılırsa, FileEngineSettings özelliğini ProtectionOnlyEngine true olarak ayarlayın ve isteği yeniden deneyin. Bu örnek için IFileEngine etiketleme işlemleri kullanılamaz, ancak koruma işlemleri kullanılabilir olacaktır.
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: MIP.Initialize() çağrılırken [sdk_wrapper_dotnet.dll] için LoadLibrary başarısız oldu.
Uygulamanızın gerekli çalışma zamanı bulunmuyor veya Yayın sürümü olarak derlenmedi. Daha fazla bilgi için bkz. Uygulamanızın gerekli bağımlılıklara sahip olduğundan emin olun .
Hata: "ProxyAuthError hatası"
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 Microsoft Purview 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.
Azaltma Sınırları
Soru: MIP SDK'sını kullanırken herhangi bir hizmet tabanlı kısıtlama sınırı var mı?
Dosya SDK'sında koruma SDK'sı veya koruma işlemleri tarafından kullanılan Rights Management Service'in tüm kuruluş için 10 saniyede 7.500 istek sınırı vardır. Başka bir ifadeyle, A Uygulaması 10 saniyede 4.000 istek oluşturuyorsa ve aynı kuruluştaki B Uygulaması 10 saniyede 4.000 istek oluşturuyorsa, her iki uygulama da yanıt almaya HTTP 429 Too Many Requests başlayabilir. Bu istisnalar alındığında, geliştiricilerin bir geri çekilme süresi uygulaması gerekir. MIP SDK'sının gelecekteki sürümleri bu geri alma süresini dahili olarak uygulayacaktır.