So ermitteln Sie, welche Features ein Client unterstützt

Ab PlayReady Device Porting Kit, Version 4.4, sendet der Client Informationen darüber, welche Features er unterstützt, im Rahmen seiner Lizenzerwerbsabfrage an den Lizenzserver. Dazu gehören sowohl die Features der Rich Execution Environment (REE) als auch die der Trusted Execution Environment (TEE).

Ab PlayReady Server SDK Version 4.4 werden diese Informationen öffentlich über die LicenseChallenge-Klasse für eine Anwendung verfügbar gemacht. (In früheren Versionen des PlayReady Server SDK werden diese Informationen ignoriert, wenn sie in der Lizenzerwerbsabfrage vorhanden sind.) Auf dieser Seite wird beschrieben, wie Sie dieses Feature verwenden, um Entscheidungen in einer Serveranwendung zu treffen, die darauf basiert, welche Funktionalität der Client implementiert hat.

Features werden über die LicenseChallenge-Klasse in drei verschiedenen Catagories verfügbar gemacht: TEE-Eigenschaften, TEE-APIs und REE-Features. Um auf eine einzelne Kategorie von Clientfeatures zuzugreifen, können Sie die Eigenschaften der Lizenzabfrage verwenden, um entweder eine Liste der Enumerationen abzurufen, die den einzelnen Features entsprechen, oder auf den unformatierten XML-Code zugreifen, der Featureinformationen enthält, die innerhalb der Lizenzabfrage gesendet werden. Die in der LicenseChallenge-Klasse ab Version 4.4 verfügbar gemachten Features sind unten mit den entsprechenden Enumerationswerten aufgeführt.

TeePropertyList:
SUPPORTS_HEVC_HW_DECODING
SUPPORTS_REMOTE_PROVISIONING
SUPPORTS_PRE_PROCESS_ENCRYPTED_DATA
REQUIRES_PRE_PROCESS_ENCRYPTED_DATA_WITH_FULL_FRAMES
REQUIRES_SAMPLE_PROTECTION
SUPPORTS_SECURE_CLOCK
SUPPORTS_SECURE_STOP
Unterstützung für sicheres HDCP Typ 1
REQUIRES_PREPARE_POLICY_INFO
SUPPORTS_DEBUG_TRACING
Erfordert minimale Widerrufsdaten
SUPPORTS_OPTIMIZED_CONTENT_KEY2

TeeApiList:
DRM_TEE_BASE_AllocTEEContext
DRM_TEE_BASE_FreeTEEContext
DRM_TEE_BASE_SignDataWithSecureStoreKey
DRM_TEE_BASE_CheckDeviceKeys
DRM_TEE_BASE_GetDebugInformation
DRM_TEE_BASE_GenerateNonce
DRM_TEE_BASE_GetSystemTime
DRM_TEE_LPROV_GenerateDeviceKeys
DRM_TEE_RPROV_GenerateBootstrapChallenge
DRM_TEE_RPROV_ProcessBootstrapResponse
DRM_TEE_RPROV_GenerateProvisioningRequest
DRM_TEE_RPROV_ProcessProvisioningResponse
DRM_TEE_LICPREP_PackageKey
DRM_TEE_SAMPLEPROT_PrepareSampleProtectionKey
DRM_TEE_DECRYPT_PreparePolicyInfo
DRM_TEE_DECRYPT_PrepareToDecrypt
DRM_TEE_DECRYPT_CreateOEMBlobFromCDKB
DRM_TEE_AES128CTR_DecryptContent
DRM_TEE_SIGN_SignHash
DRM_TEE_DOM_PackageKeys
DRM_TEE_RESERVED_20
DRM_TEE_RESERVED_21
DRM_TEE_RESERVED_22
DRM_TEE_RESERVED_23
DRM_TEE_REVOCATION_IngestRevocationInfo
DRM_TEE_LICGEN_CompleteLicense
DRM_TEE_LICGEN_AES128CTR_EncryptContent
DRM_TEE_RESERVED_27
DRM_TEE_RESERVED_28
DRM_TEE_RESERVED_29
DRM_TEE_RESERVED_30
DRM_TEE_RESERVED_31
DRM_TEE_RESERVED_32
DRM_TEE_RESERVED_33
DRM_TEE_H264_PreProcessEncryptedData
DRM_TEE_SECURESTOP_GetGenerationID
DRM_TEE_AES128CTR_DecryptAudioContentMultiple
DRM_TEE_SECURETIME_GenerateChallengeData
DRM_TEE_SECURETIME_ProcessResponseData
DRM_TEE_AES128CTR_DecryptContentMultiple
DRM_TEE_AES128CBC_DecryptContentMultiple
DRM_TEE_SECURESTOP2_GetSigningKeyBlob
DRM_TEE_SECURESTOP2_SignChallenge
DRM_TEE_BASE_GetFeatureInformation

ReeFeatureList:
Versammlung
PersistentStorePrealloc
ECCProfiling
ForceAlign
InlineDwordCopy
Dateisperrung
MultiThreading
Native64BitTypes
PrecomputedECCGlobalTable
Tracing
PersistentStoreWriteThrough
AddLicenseWriteThrough
Keine Optimierungen
DebugBuild
Profiling
Aktivierung
AntirollbackClock
CDMI
CleanStore
ErrorCodeContract
PKCRT
DeviceAssets
Domänen
Eingebetteter Lizenzspeicher
PersistentStore
PersistentStoreBlockHeaderCache
CDMIPersistentStore
Inhaltsschlüsselgenerierung
Lokale Lizenzgenerierung
MeteringCertificateRevocation
Messung
Modellzertifikatswiderruf
InMemoryOnlyLicenses
Leistung
Reaktivierung
Widerruf
SecureDelete
SecureStop
SecureStop2
SecureTime
StrukturierteSerialisierung
XmlParsingCache
LicenseAcquisition
LegacyXmlZertifikate
AESCBCS

Es gibt einige allgemeine Zustände, die die Klasse LicenseChallenge in Bezug auf die zur Verfügung gestellten Funktionen des Clients einnehmen kann.

• Wenn die TeePropertyList, TeeApiList und ReeFeatureList alle leer sind, bedeutet dies, dass der Client eine Version der PK ausführt, die älter als 4.4 ist.
• Wenn die ReeFeatureList nicht leer ist und die TeePropertyList und TeeApiList beide leer sind, kann dies eines von zwei Dingen bedeuten.
  • Auf Windows-Clients wird der Client entweder im Software-DRM ausgeführt, oder der TEE des Clients ist älter als PK Version 4.4.
  • Auf Nicht-Windows-Clients wird vom REE des Clients die PK-Version 4.4+ ausgeführt, während die TEE des Clients älter als PK-Version 4.4 ist.
• Wenn "TeePropertyList", "TeeApiList" und "ReeFeatureList" nicht leer sind, wird der Client für alle Komponenten PK Version 4.4+ ausführen.
  • Hinweis: Die TeePropertyList und TeeApiList werden von der TEE des Clients bereitgestellt und können entsprechend ihrer Sicherheitsstufe vertrauenswürdig sein.