Jak przeprowadzić migrację z poprzednich wersji PK i serwera

Zalecenia dotyczące usług PlayReady

Firma Microsoft zaleca następujące zasady migracji:

• Upewnij się, że usługa została uaktualniona do najnowszej wersji zestawu PlayReady SDK. Zapewni to najlepszą zgodność na nowych i starszych urządzeniach. Najnowsze wersje zestawu SDK serwera również dodały znaczne ulepszenia wydajności i stabilności. Należy pamiętać, że do uaktualnienia do najnowszej wersji PlayReady Server 4.0 nie są wymagane żadne dodatkowe opłaty licencyjne ani licencje .

• W miarę jak nowe urządzenia kontynuują migrację PlayReady do sprzętu (SoC), będzie coraz więcej urządzeń zgłaszających się do systemu jako PlayReady 3.0 i nowszych oraz SL3000. Na przykład wszystkie urządzenia z systemem Windows 10 są obecnie zgłaszane jako urządzenia PlayReady 3.0 lub nowsze. Usługi są zachęcane do uaktualnienia do najnowszej wersji zestawu SDK serwera w celu zachowania zgodności, a także korzystania z niektórych nowych funkcji.

• Skorzystaj z informacji podanych w tym temacie jako przewodnika po obsłudze przypadków brzegowych, takich jak obsługa starszych usług licencji as-is podczas obsługi nowych urządzeń.

• Posiadacze licencji mogą skontaktować się z askdrm@microsoft.com, aby uzyskać dostęp do naszej strony feedbackowej, aby przesłać pytania dotyczące migracji.

Zalecenia dotyczące producentów urządzeń PlayReady

Zdecydowanie zaleca się, aby producenci OEM uaktualnili swoje urządzenia do wersji PK4.0 wydanej w październiku 2017 r., co jest jedyną wersją umożliwiającą urządzeniom korzystanie z najnowszych funkcji implementowanych przez najważniejsze usługi multimedialne.

Plan uaktualnienia OEM

1. Skontaktuj się z działem usług i upewnij się, że wszystkie migrują lub zainstaluj zestaw SDK serwera w wersji 2.0 lub wyższej.

   • Sprawdź wersję zestawu SDK serwera.

   • Powtórz zagadnienia dotyczące usługi: brak dodatkowych wymagań dotyczących licencjonowania firmy Microsoft i brak dodatkowych opłat.

   • Jeśli uruchamiają usługę licencjonowania opartą na zestawie SDK serwera w wersji 2.0 lub nowszej, prawdopodobnie będą one zgodne. Adresy URL i scenariusze usługi w następnej sekcji mogą pomóc w testowaniu zgodności.

   • Jeśli uruchamiają serwer licencji oparty na zestawie SDK serwera w wersji 1.X, mogą przeprowadzić migrację tego serwera licencji lub dodać nowszy serwer licencji dla nowych klientów, wykorzystując zestaw SDK serwera w wersji 2.0 lub nowszej (zalecana jest najnowsza wersja).

2. Pobierz klucz PK 4.0 od firmy Microsoft.

3. Uzyskaj pomoc techniczną od partnerów firmy Microsoft lub bezpośrednio od firmy Microsoft, wysyłając wiadomość e-mail na adres AskDRM@microsoft.com.

4. Implementuj PK 4.0 i wydaj swój produkt.

Uwagi migracyjne dotyczące usług

Aby uzyskać optymalną zgodność urządzeń, upewnij się, że na serwerze licencji jest uruchomiona najnowsza wersja zestawu SDK serwera. Najnowszy zestaw SDK serwera będzie mógł dostarczać licencje wszystkim klientom PlayReady niezależnie od używanej wersji zestawu Porting Kit. Jeśli klient opracowany z zestawem Device Porting Kit 3.0 lub nowszym próbuje uzyskać licencję z usługi licencyjnej przy użyciu PlayReady SDK 1.x, usługa licencyjna zwróci ogólny błąd SOAP specyficzny dla usługi. Serwer zarejestruje wyjątek w dzienniku systemu Windows, zauważając, że w łańcuchu certyfikatów klienta brakuje wyzwania.

Migrowanie usługi PlayReady do zestawu Server SDK 4.0

Uaktualnienie usługi zwykle nie wiąże się ze zmianami w kodzie, ale tylko ponowną kompilacją i wdrożeniem zaktualizowanych bibliotek. W niektórych przypadkach mogą wystąpić drobne zmiany kodu z powodu niektórych przestarzałych interfejsów API. Ponowne kompilowanie i wdrażanie biblioteki obsługi licencji powinno być przezroczyste dla urządzeń, które uzyskują dostęp do usługi.

Kompilowanie i wdrażanie zaktualizowanej procedury obsługi licencji musi uwzględniać następujące kwestie:

• Projekt będzie musiał usunąć odwołania do starych bibliotek PlayReady i odwołać się do nowych przed ponowną kompilacją.

• Nowsze zestawy SDK serwera wymagają platformy .NET 4.0 lub nowszej. Podczas uaktualniania programu obsługi usługi licencjonowania z wcześniejszej wersji, takiej jak 1.52, platforma docelowa musi zostać zaktualizowana we właściwościach projektu do wersji 4.0 lub nowszej.

  

• Jeśli starszy mechanizm obsługi odwołuje się do innych bibliotek przeznaczonych dla platformy .NET w wersji poniżej 4.0, mogą być konieczne dodatkowe kroki migracyjne. Jednak biblioteka .NET może odwoływać się do mniejszej wersji bez żadnych ogólnych problemów. Warto zbadać możliwość ponownego skompilowania bibliotek do wersji handlera lub uzyskania aktualizacji bibliotek dla składników innych firm.

• W projekcie należy odwołać się tylko do pliku Microsoft.Media.Drm.RMCore. Podczas wdrażania rozwiązania inne biblioteki DLL należy wdrożyć w katalogu bin witryny internetowej. Nie trzeba się do nich odwoływać w projekcie, podobnie jak w przypadku wcześniejszych zestawów SDK.

  

• Minimalna wersja środowiska .NET CLR w wersji 4.0 jest wymagana dla puli aplikacji używanej przez usługę licencji. Jeśli usługa licencji była uruchomiona w wersji 2.0 lub starszej, prawdopodobnie jest uruchomiona w środowisku .NET CLR w wersji mniejszej niż 4.0.

  

• Najnowszy zestaw PLAYReady Server SDK jest obsługiwany tylko w systemie Windows Server 2012 i nowszych wersjach. System Windows Server 2008 R2 nie jest jednak znany z problemów z zestawem SDK serwera.

Obsługa różnych wersji zestawu SDK serwera dla usługi

Firma Microsoft zaleca przeprowadzenie migracji do najnowszej wersji zestawu SDK wkrótce po jej wydaniu. W niektórych przypadkach jednak usługa może chcieć uruchomić wiele wersji zestawu Sdk serwera. Może to być spowodowane utrzymywaniem starszych i archiwalnych usług i punktów końcowych, które nie są łatwo aktualizowane. W takim przypadku usługa może wskazywać nowych klientów na zaktualizowaną usługę licencji, pozostawiając starszą usługę nietkniętą. Na przykład usługa może mieć wiele starszych urządzeń w ekosystemie z uruchomionym klientem utworzonym za pomocą zestawu PlayReady PK 1.2. Ich nowe urządzenia są opracowywane przy użyciu zestawu PlayReady PK 4.0. Nowy klient musi wskazać usługę licencji utworzoną przy użyciu zestawu Server SDK 2.0 lub nowszego. Jeśli zarówno starsze, jak i nowe urządzenia używają tej samej aplikacji (na przykład platformy aplikacji opartej na kodzie HTML), logika musi zostać dodana do aplikacji w celu wykrycia wersji klienta. Następnie aplikacja kliencka może kierować żądania licencji do nowszej usługi licencji.

Zalecana migracja polega na zaktualizowaniu usługi licencji do najnowszej wersji zestawu SDK serwera. Może to zapewnić zgodność ze wszystkimi urządzeniami dla wielu usług. Aby zweryfikować zgodność, usługa będzie musiała przetestować na różnych klientach.

Jeśli usługa nie chce wprowadzać zmian w starszej konfiguracji klienta i usługi, zaleca się hostowanie drugiej usługi licencji, która została uaktualniona do najnowszej wersji zestawu SDK i jest używana przez nowoczesnych klientów.

Jeśli usługa używa pojedynczej aplikacji klienckiej na obu starszych urządzeniach (PlayReady 1.X) i nowszych (PlayReady 3.0 lub nowszych), musi obsługiwać dwa serwery licencji PlayReady (PlayReady 1.X i PlayReady 3.0 lub nowsze), aby obsługiwać licencje na wszystkie te urządzenia. Aplikacja może zawierać logikę do kierowania żądań do odpowiedniego serwera licencji na podstawie wersji bazowego klienta PlayReady lub usługi może używać serwera proxy usługi, który kieruje żądania pochodzące ze wszystkich tych urządzeń w jednym adresie URL do odpowiedniego serwera licencji.

Można to zrobić na serwerze proxy, sprawdzając wyzwanie dotyczące licencji. Wersja PK zostanie zanotowana w elemencie <CLIENTVERSION>.

Element znajduje się w wyzwaniu SOAP pod następującym elementem.

<Challenge><LA><CLIENTINFO><CLIENTVERSION>3.1.0.1017</CLIENTVERSION> 

Obsługa klientów opartych na protokole PK 3.0 lub nowszym ze starszymi usługami licencji

Urządzenie klienckie opracowane przy użyciu zestawu PlayReady Device Porting Kit 3.0 lub nowszego prawdopodobnie będzie działać z istniejącymi usługami opracowanymi z zestawem Server SDK 2.0 lub nowszym. Jak wspomniano powyżej, usługa musi przetestować klientów PK 3.0 lub nowszych, aby zweryfikować zgodność.

Jeśli urządzenie ma certyfikat SL3000, poziom SecurityLevel uwidoczniony za pośrednictwem certyfikatu klienta w procedurze obsługi licencji będzie zgłaszany jako 3000. Może to spowodować problemy z niektórymi procedurami obsługi licencji, jeśli szukają określonej wartości SecurityLevel, aby odróżnić urządzenia produkcyjne i testowe.

Różnicowanie między poziomami zabezpieczeń jest powszechne w przypadku usług, które zapewniają ograniczony dostęp do treści dla urządzeń testowych, aby potwierdzić ważność licencji odtwarzania z usługi działającej na żywo. Tylko urządzenia zgłoszone jako SecurityLevel 2000 miałyby licencje odtwarzania dostarczane dla zawartości komercyjnej. Usługa zgłosi wyjątek specyficzny dla usługi, który spowoduje błąd protokołu SOAP na kliencie.

W poniższym przykładzie element SecurityLevel jest sprawdzany w certyfikacie klienta, aby upewnić się, że jest to urządzenie produkcyjne. Ponieważ został on zakodowany na stałe do 2000 roku, urządzenia o poziomie zabezpieczeń 3000 nie będą postrzegane jako urządzenia produkcyjne.

W następnym przykładzie sprawdzanie poziomu zabezpieczeń zostaje zaktualizowane pod kątem tego, czy poziom ten jest większy lub równy 2000. Zapewni to zgodność z urządzeniami SL3000.

Obsługa funkcji PlayReady w wersji 3.X i nowszych dla usług

Oprócz nowego sprzętowego poziomu zabezpieczeń DRM, wersje PlayReady 3.0 i nowsze również wprowadziły różne nowe funkcje. Aby móc korzystać z tych nowych funkcji, usługa musi najpierw określić, czy klient może korzystać z funkcji PlayReady 3.0 i nowszych. Klasa certyfikatów klienta obsługuje teraz metodę GetSupportedFeatures, która zwróci kolekcję funkcji, aby ułatwić logikę definiowania zasad w programie obsługi. Jeśli klient został opracowany przy użyciu zestawu Device Porting Kit 3.0, będzie miał właściwość SupportedFeature.PlayReady3Features w kolekcji. Istnieją dodatkowe przydatne funkcje w zbiorze, takie jak to, czy klient korzysta z bezpiecznego zegara lub zegara zapobiegającego cofaniu czasu.

Oto przykład wykrywania, czy urządzenie jest klientem PlayReady 3.0.

Po wykryciu, obsługujący może dodać zasady, takie jak Secure Stop, wygaśnięcie licencji w czasie rzeczywistym oraz MaxResDecode, na przykład.

Obsługa zarówno SL2000, jak i SL3000 w usługach

PlayReady wprowadziło nowy poziom zabezpieczeń SL3000, który jest raportowany przez urządzenia spełniające poziom zabezpieczeń sprzętowych PlayReady do działania w zaufanym środowisku wykonawczym, zgodnie z określeniem w zasadach zgodności i solidności. Często zdarza się, że niektóre usługi będą raportować klientów jako SL2000, a inne będą raportować jako SL3000. Na przykład w systemie Windows starsze urządzenia, które zostały uaktualnione do systemu Windows 10, mogą być zgłaszane jako SL2000. Nowe urządzenia z systemem Windows 10 będą raportowane jako SL3000, gdzie DRM został włączony do nowszych układów.

Oto przykład usługi dostarczającej różne polityki zgodnie z zgłoszonym poziomem zabezpieczeń przez problem klienta.

Usługa określi, w jaki sposób zasady powinny się różnić między klientami DRM opartymi na oprogramowaniu i klientami DRM opartymi na sprzęcie. Te zasady mogą wynikać z wymagań studia. Na przykład, studio może wymagać w przyszłości, że zawartość Ultra-HD lub 4K może być ograniczona do urządzeń obsługujących sprzętowy DRM PlayReady.

Zasady PlayReady 3.0 i wyższych dotyczące rozdzielczości można realizować na kilka różnych sposobów. Jednym ze sposobów jest ustawienie zasad MaxResDecode licencji SL2000 na dozwolone limity udostępniane przez właściciela zawartości. Urządzenia SL3000 nie będą miały tego ograniczenia zasad. Inną opcją stosowaną w technologii adaptacyjnego przesyłania strumieniowego jest użycie innego identyfikatora KeyID podczas ochrony różnych rozdzielczości. Podczas wykrywania poziomu zabezpieczeń usługa może następnie udostępniać licencje tylko dla rozwiązań dozwolonych dla klienta opartego na oprogramowaniu. Klient raportujący poziom zabezpieczeń SL3000 uzyska licencje odtwarzania dla wszystkich rozdzielczości. PlayReady wprowadziło nowy nagłówek DRM (wersja 4.2.0.0 i nowsze) do wsparcia tego ostatniego scenariusza przez włączenie wielu identyfikatorów KeyID w schemacie.

Zobacz też

Wersje produktów PlayReady

Jak testować klientów PlayReady przy użyciu wersji zestawu PlayReady Server SDK