Sürüm notları

  • Makale

Önemli

Mart 2020'den önce yayımlanan Microsoft Rights Management Service SDK sürümleri kullanım dışı bırakılmıştır; önceki sürümleri kullanan uygulamaların Mart 2020 sürümünü kullanacak şekilde güncelleştirilmiş olması gerekir. Tüm ayrıntılar için kullanımdan kaldırma bildirimine bakın.

Microsoft Rights Management Service SDK'sı için başka geliştirme planlanmıyor. Sınıflandırma, etiketleme ve koruma hizmetleri için Microsoft Bilgi Koruması SDK'sının benimsenmesini kesinlikle öneririz.

Bu makale, RMS SDK 2.1'in bu ve önceki sürümleri hakkında önemli bilgiler içerir.

Ekim 2019 - güncelleştirme

  • Bazı durumlarda simetrik anahtar kimlik doğrulamasının kullanılması azure RMS ile kullanıcının kimliğini doğrulayamaz ve bu da içeriğin korunmasını ve korunmasını önler.
  • Rms istemcisi, daha önce korunan ve korumasız olan bazı PDF belgelerinin şu anda korunup korunmadığını denetlemeye çalışırken kilitlenebilir.
  • Özel bağlantı noktalarında yapılandırılmış AD RMS sunucuları için DNS yeniden yönlendirmesi kullanılması düzgün çalışmaz.

Eylül 2019 - güncelleştirme

  • Başlatma yöntemlerini diğer bazı RMS istemci yöntemleriyle aynı anda çağırmaya çalışırken oluşabilecek bir kilitlenme düzeltildi.
  • Parola korumalı Office dosyalarının RMS korumalı olup olmadığını belirlemeyle ilgili bir sorun düzeltildi.
  • Özel amaçlı lisanslar için lisans doğrulamayı güncelleştirin.
  • PDF koruyucusunun güncelleştirmeleri.
  • Diğer hata düzeltmeleri.
  • C çalışma zamanı kitaplıklarına statik olarak bağlanacak şekilde güncelleştirin.

Nisan 2019 - güncelleştirme

  • Dosya API'sindeki hata düzeltmeleri.
  • Dosya API'si, içeriğin şifresini çözerken EXTRACT hakkı yerine EXPORT hakkını denetlemek için güncelleştirildi.
  • Yükseltme sırasında yeni PDF v2 koruyucusunun yüklendiğinden emin olmak için yükleyici düzeltmesi.
  • Telemetri değişiklikleri. Bu değişiklik, C çalışma zamanı kitaplıklarını yükleyen yükleme paketinde bir güncelleştirme gerektiriyor.
  • Hizmet arka uç kimlik doğrulaması değişiklikleri, uygulamalarınız için simetrik anahtar kimlik doğrulaması kullanıyorsanız kesintiyi en aza indirirken lütfen bu SDK sürümüne güncelleştirin
  • VC 15.9 desteği

Ekim 2017 - güncelleştirme

Şubat 2016 - SDK belge güncelleştirmeleri

Not

Bu bölümdeki özellik belgesi güncelleştirmeleri 11/12/2015 tarihli SDK indirmesi için geçerlidir.

  • Geliştirilmiş kimlik doğrulama akışı - Azure Active Directory Kimlik Doğrulama Kitaplığı (ADAL) aracılığıyla OAuth2 belirteç tabanlı kimlik doğrulaması kullanma. Bu işlem ve bunun API uzantıları hakkında daha fazla bilgi için bkz. RMS özellikli uygulamanız için ADAL kimlik doğrulaması.

  • ADAL Güncelleştirmesi - Uygulamanızı Microsoft Online Oturum Açma Yardımcısı yerine ADAL kimlik doğrulaması kullanmak üzere güncelleştirdiğinizde siz ve müşterileriniz aşağıdakileri gerçekleştirebilirsiniz:

    • Çok faktörlü kimlik doğrulaması kullanma
    • Makine için yönetici ayrıcalıklarına gerek duymadan RMS 2.1 istemcisini yükleme
    • Uygulama için Windows 10 onayı alma

  • RMS SDK ile Microsoft Çevrimiçi Oturum Açma Yardımcısı (SIA) desteği kaldırılıyor. Desteğin durdurulacağı altı ay boyunca SIA kullanımını desteklemeye devam edeceğiz.

Aralık 2015 güncelleştirmesi

  • Aşağıdakiler dahil birçok alanda performans iyileştirmeleri uygulanmıştır:

    • Yalnızca lisans sunucuları kullanılırken birincil lisans sunucusundan yayımlama.
    • Ağ bağlantısı olmadığında RMS SDK 2.1’in daha hızlı başarısız olması.

  • Hata iletilerini ve sorun giderme deneyimini geliştirmeye yönelik çok sayıda güncelleştirme.

  • Ayrıca Desteklenen platformlar listeleri de güncelleştirilmiştir.

  • Üretim öncesi ortam ve uygulama bildirimi kullanımı gereksinimi RMS SDK 2.1'den kaldırılmıştır. Bu geliştirici belgeleri kümesinin bu bölümleri kaldırıldı ve belgeler genel olarak basitleştirilip yeniden düzenlendi.

Mayıs 2015 güncelleştirmesi

Nisan 2015 güncelleştirmesi

  • Belge izleme artık bir dizi yeni API ile mümkündür. Daha fazla bilgi için bkz. İçeriği İzleme.

  • Şifreleme türü - Şifreleme paketinin seçimi için API düzey denetimi artık desteklenmektedir. Daha fazla bilgi için bkz. Şifreleme ile çalışma.

    Not Artık API'mizde IPC_LI_DEPRECATED_ENCRYPTION_ALGORITHMS bayrağını açığa çıkarmayacağız. Bu durum, bu bayrağa başvurmaları durumunda gelecekteki uygulamaların artık derlenmeyeceği, ancak bayrağı API kodunda özel olarak değerlendirdiğimizden daha önce oluşturulan uygulamaların çalışmaya devam edeceği anlamına gelir. Sadece bir bayrak değiştirilerek, eski kullanım dışı şifreleme algoritmaları bayrağının avantajından hala yararlanılabilir. Daha fazla bilgi için bkz. Şifreleme ile çalışma.

  • IPC_API_MODE_SERVERAPI modu değerleri kullanan Sunucu Modu Uygulamaları artık bir uygulama bildirimi gerektirmez. Uygulamanızı bir üretim RMS sunucusuna karşı sınayabilirsiniz ve üretim ortamına geçiş yaparken bir üretim lisansı almanız gerekli değildir. Sunucu modu uygulamaları hakkında daha fazla bilgi için bkz. Uygulama türleri.

  • Günlük kaydı artık hem dosya hem de Windows yöntemleri için Olay İzleme ile uygulanmaktadır.

  • Windows 7 SP1 veya Windows Server 2008 R2 makinesi üzerinde çalışıyorsanız "Önemli geliştirici notları" altındaki nota bakın.

Ocak 2015 güncelleştirmesi

  • Desteklenen korumalı dosya (pfile) boyutu artışı - Bundan böyle bir gigabayttan (1 GB) büyük pfile boyutları desteklenmektedir. Pfile’lar hakkında daha fazla bilgi için bkz. Desteklenen Dosya Biçimleri.

  • Daha iyi tanılama için geliştirilmiş günlük kaydı - Günlük kaydı düzeyleri gözden geçirilmesi gereken iletiler için HATA veya UYARI ifadesini gösterir. Hala görüntülenen özel durumlar da dahil olmak üzere diğer tüm iletiler BİlGİ olarak günlüğe kaydedilir.

    Hiçbir ayrıntıyı kaybetmemek için bu yaklaşım seçilmiştir. Şu anda yalnızca önemli iletiler UYARI düzeyi ile gösterilmektedir.

  • Şirket şablonlarını alma – Müşteri raporlarına ve geri bildirimlerine göre şablon alma kodunda önemli düzeltmeler.

  • Geliştirilmiş yerelleştirme tutarlılığı

Ekim 2014 güncelleştirmesi

Temmuz 2014 güncelleştirmesi

SDK'nın Dosya API'sinin bileşeni genişletilmiştir ve aşağıdaki özellikleri sunar:

Nisan 2014 güncelleştirmesi

  • Özellikle büyük PFiles için Dosya API’si bellek kullanımı önemli ölçüde iyileştirilmiştir.

  • İçerik Kimliği artık IPC_LI_CONTENT_ID özelliği aracılığıyla yazılabilir. Daha fazla bilgi için bkz. Lisans özelliği türleri.

  • Üretim bildirimi gereksinimi - RMS özellikli uygulamanız/hizmetiniz sunucu modunda çalışırken bundan böyle bildirim gerekli değildir. Daha fazla bilgi için bkz. Uygulama türleri.

  • Belge güncelleştirmeleri

    En iyi test yöntemi - Azure RMS ile test etmeden önce şirket içi sunucunun kullanımına ilişkin yönergeler eklenmiştir. Daha fazla bilgi için, bkz. Hizmet uygulamanızın bulut tabanlı RMS ile çalışmasını sağlama.

Önemli geliştirici notları

  • Tüm dosya türleri için yerel destek

    Rights Management Services SDK 2.1’in bu sürümü ile herhangi bir dosya türü (uzantı) için yerel destek eklenebilir. Örneğin, herhangi bir uzantı ext> (office ve pdf olmayan) için, bu uzantının <yönetici yapılandırması "YEREL" ise *.pext<> kullanılır.

    Desteklenen dosya türleri hakkında daha fazla bilgi için bkz. Dosya API'sini yapılandırma.

  • Windows 7 SP1 ve Windows Server 2008 R2 SP1 makineleri, KB2533623 güncelleştirmesi olmadan herhangi bir Office dosyasını korumayla ilgili şu hatayı verebilir: "Parametre hatalı. Hata kodu 0x80070057". Bunu görürseniz lütfen güncelleştirmeyi yükleyip yeniden deneyin. Hala sorunlarla karşılaşıyorsanız lütfen RMS SDK Beta Geri Bildirim diğer adı rmcstbeta@microsoft.com ile iletişim kurun.

    Not Nisan 2015 sürümünden itibaren bu KB için yükleme işlemine bir denetim eklenmiştir.

  • Dosya API’si tümleştirme

    Active Directory Rights Management Services Dosya API’si, Dosya API’sinin eklenmesiyle birlikte aşağıdaki faydaları ve özellikleri sağlar.

    • Çeşitli dosya biçimleri tarafından kullanılan Bilgi Hakları Yönetimi (IRM) uygulamasının ayrıntılarını bilmek zorunda kalmadan gizli verileri otomatik bir şekilde koruyabilirsiniz.

    • Microsoft Office dosyaları, Taşınabilir Belge Biçimi (PDF) dosyaları ve bazı diğer dosya türleri, yerel koruma kullanılarak korunabilir. Yerel koruma ile korunabilen dosya türlerinin tam listesi için bkz. Dosya API’si yapılandırması.

    • Sistem dosyaları ve Office dosyaları hariç tüm dosyalar RMS Korumalı Dosya Biçimi (PFile) kullanılarak korunabilir.

    Dosya API'si şu dört yeni işlev aracılığıyla uygulanır: IpcfDecryptFile, IpcfEncryptFile, IpcfGetSerializedLicenseFromFile ve IpcfIsFileEncrypted.

    Dosya API’si, istemci bilgisayara Rights Management Service İstemcisi 2.1’in yüklenmesini ve bilgisayarın bir RMS sunucusuna bağlanabilmesini gerektirir. RMS sunucusu, RMS istemcisi ve işlevleri hakkında daha fazla bilgi için, RMS için BT Uzmanı belgeleri ile ilgili TechNet içeriğine bakın.

  • Sorun: Sıfırdan lisans oluşturulurken sahiplik hakları açıkça verilmelidir.

    Çözüm: IpcCreateLicenseFromScratch kullanılarak sıfırdan lisans oluşturulurken uygulamanız lisans sahibine Sahip haklarını açıkça eklemelidir. Daha fazla bilgi için bkz. Açık sahip hakları ekleme.

  • Sorun: Bir uygulama tanıtıcısını kullanarak aynı pencere için IpcProtectWindow veya IpcUnprotectWindow'u iki kez çağırırsa, RMS SDK 2.1 HRESULT'ta bir hata döndürür.

    Çözüm: Bu duruma özel yönergeler için IpcProtectWindow ve IpcUnprotectWindow içindeki Açıklamalar bölümüne bakın.

  • Sorun: Birden fazla mimari için oluştururken bu yönergeleri kullanmanız gerekir.

    Çözüm: Farklı bir mimari için Ipcsecproc*isv.dll kullanmak istiyorsanız (örneğin, 64 bit SDK'yı 64 bit bir bilgisayara yüklediniz, ancak şimdi Ipcsecproc*isv.dll gerektiren 32 bit bir bilgisayara dağıtmak istiyorsunuz), 32 bit SDK'yı farklı bir bilgisayara yüklemeniz ve "%PROGRAMFILES%\Microsoft Bilgi Koruması Ipcsecproc*isv.dll dosyalarını oraya kopyalamanız gerekir And Control" klasörü (varsayılan konum veya SDK'yı yüklemeyi seçtiğiniz her yerde).

Sık sorulan sorular

S: Varsayılan dil davranışı bir LCID parametresi alan işlevlerle nasıl çalışır?

C: Varsayılan yerel ayar için 0 kullanın. Bu durumda, AD RMS İstemcisi 2.1 aşağıdaki sırayla adları ve açıklamaları arar ve kullanılabilir ilk seçeneği alır:

  1. Kullanıcı tercih edilen LCID.
  2. Sistem yerel ayarı LCID.
  3. Rights Management Server (RMS) şablonunda belirtilen ilk kullanılabilir dil.

Hiçbir ad ve açıklama alınamazsa hata döndürülür. Belirli bir LCID için yalnızca bir ad ve açıklama olabilir.