Especificação do cabeçalho PlayReady

1. Introdução

Esta especificação aplica-se a qualquer produto final criado com o PlayReady Server SDK, PlayReady Device Porting Kit, Windows, Xbox, Windows Phone e Silverlight.

1.1. Histórico de alterações

2. Objeto PlayReady (PRO)

O objeto PlayReady (PRO) contém os seguintes campos.

2.1 Registros de objetos PlayReady

O objeto PlayReady consiste em subobjetos adicionais chamados PlayReady Object Records. Os registros de objeto PlayReady contêm os seguintes campos.

O campo Tipo de Registro tem um dos seguintes valores.

2.2. Exemplos de objetos PlayReady

A figura a seguir mostra um arquivo MP4 segmentado com um objeto PlayReady que contém um cabeçalho PlayReady:

A figura a seguir mostra a visualização HEX deste arquivo MP4:

3. Cabeçalho PlayReady (PRH)

O cabeçalho PlayReady (PRH) é usado por um cliente para localizar ou adquirir uma licença para a parte do conteúdo em que está armazenado. É codificado usando UTF-16.

3.1 Matriz de suporte de versão

Observações:

1. Versão 1709 ou superior da Xbox One é cliente PlayReady 4.X.
2. O Windows 10 (todas as versões) e a versão 1703 ou inferior da Xbox One são Clientes PlayReady 3.X. Os dispositivos não Windows mais recentes (por exemplo, Smart TVs) lançados após 2017 são clientes PlayReady 3.X.
3. O Silverlight e o Windows 8, 8.1 são clientes PlayReady 2.X. A maioria dos dispositivos não Windows (por exemplo, Smart TVs) lançados entre 2011 e 2017 são clientes PlayReady 2.X.
4. A maioria dos dispositivos não Windows (por exemplo, Smart TVs) lançados entre 2008 e 2011 são clientes PlayReady 1.X.

3.2. Requisitos de sintaxe

3.2.1. Canonicalizado

O XML deve ser canonicalizado.

3.2.2. Os nomes de nós e atributos são sensíveis a maiúsculas e minúsculas

Suportado

<KID VALUE="PV1LM/VEVk+kEOB8qqcWDg=="> </KID>

Não suportado

<KID value="PV1LM/VEVk+kEOB8qqcWDg=="> </KID>
<kid VALUE="PV1LM/VEVk+kEOB8qqcWDg=="> </kid>

3.2.3. As tags de fechamento devem ser explícitas

Todos os nós XML devem ser explicitamente fechados por uma marca de fechamento, incluindo aqueles em nós dentro do nó CUSTOMATTRIBUTES.

Suportado

<KID VALUE="PV1LM/VEVk+kEOB8qqcWDg=="> </KID>
<CUSTOMATTRIBUTES> <MyNode FooAttribute="Foo"> </MyNode> </CUSTOMATTRIBUTES>

Não suportado

<KID VALUE="PV1LM/VEVk+kEOB8qqcWDg=="> <CUSTOMATTRIBUTES> <MyNode FooAttribute="Foo"> </CUSTOMATTRIBUTES>

3.2.4. Atributos de namespace

Todos os atributos de namespace devem aparecer antes dos atributos que não são namespaces.

Suportado

<WRMHEADER xmlns="http://schemas.microsoft.com/DRM/2007/03/PlayReadyHeader" version="4.3.0.0">

Não suportado

<WRMHEADER version="4.3.0.0" xmlns="http://schemas.microsoft.com/DRM/2007/03/PlayReadyHeader>

3.2.5. Ordem alfabética

Todos os atributos devem estar em ordem alfabética, incluindo aqueles presentes em nós dentro do nó CUSTOMATTRIBUTES.

Suportado

<KID ALGID="AESCBC" VALUE="PV1LM/VEVk+kEOB8qqcWDg=="> </KID>
<CUSTOMATTRIBUTES> <MyNode BarAttribute="Bar" FooAttribute="Foo"> </MyNode> </CUSTOMATTRIBUTES>

Não suportado

<KID VALUE="PV1LM/VEVk+kEOB8qqcWDg==" ALGID="AESCBC"> </KID>
<CUSTOMATTRIBUTES> <MyNode FooAttribute="Foo" BarAttribute="Bar"> </MyNode> </CUSTOMATTRIBUTES>

3.3. v4.3.0.0

O PlayReady Header v4.3.0.0 foi introduzido com a versão 4.0 do PlayReady em setembro de 2017 para dar suporte a chaves AESCBC num cabeçalho. Este suporte permite a encriptação de conteúdos em modo CBC, em particular para os modos de encriptação comum 'cbcs'. Também aumenta a interoperabilidade dos clientes PlayReady com outros sistemas DRM, bem como o conteúdo existente.

3.3.1. Diferenças com outras versões

A partir da versão 4.0, os SDKs e Clientes PlayReady são capazes de processar as versões 4.0, 4.1, 4.2 e 4.3 do PlayReady Header. Os SDKs PlayReady anteriores à versão 4.0 retornarão um erro de "versão não suportada" quando fornecidos com cabeçalhos v4.3.

O formato de cabeçalho PlayReady v.4.3.0.0 tem as seguintes alterações em comparação com v4.2.0.0:

• O atributo version do elemento WRMHEADER é definido como a cadeia de caracteres "4.3.0.0".
• O atributo ALGID localizado dentro do elemento KID pode estar ausente em uma solicitação de aquisição de licença. A Microsoft recomenda que o atributo ALGID tenha um valor válido no cabeçalho incluído no conteúdo.
• Quando o atributo ALGID está presente em qualquer elemento KID e há mais de um elemento KID no elemento KIDS , todos os elementos KID devem incluir o atributo ALGID e os valores do atributo devem ser os mesmos.
• O atributo ALGID localizado dentro do elemento KID agora pode ter o valor "AESCBC", além de "AESCTR", desde que:
  • Quando o atributo ALGID é definido como "AESCBC", o atributo CHECKSUM não deve ser incluído.

3.3.2. Exemplos

Segue-se um exemplo de um cabeçalho PlayReady com chaves AESCBC, versão 4.3.0.0:

<WRMHEADER xmlns="http://schemas.microsoft.com/DRM/2007/03/PlayReadyHeader" version="4.3.0.0">
  <DATA>
    <PROTECTINFO>
      <KIDS>
        <KID ALGID="AESCBC" VALUE="PV1LM/VEVk+kEOB8qqcWDg=="></KID>
        <KID ALGID="AESCBC" VALUE="tuhDoKUN7EyxDPtMRNmhyA=="></KID>
      </KIDS>
    </PROTECTINFO>
    <LA_URL>http://rm.contoso.com/rightsmanager.asmx</LA_URL>
    <DS_ID>AH+03juKbUGbHl1V/QIwRA==</DS_ID>
  </DATA>
</WRMHEADER>

Segue-se um exemplo de um cabeçalho PlayReady 4.3.0.0 com um ALGID em falta:

<WRMHEADER xmlns="http://schemas.microsoft.com/DRM/2007/03/PlayReadyHeader" version="4.3.0.0">
  <DATA>
    <PROTECTINFO>
      <KIDS>
        <KID VALUE="PV1LM/VEVk+kEOB8qqcWDg=="></KID>
      </KIDS>
    </PROTECTINFO>
    <LA_URL>http://rm.contoso.com/rightsmanager.asmx</LA_URL>
    <DS_ID>AH+03juKbUGbHl1V/QIwRA==</DS_ID>
    <DECRYPTORSETUP>ONDEMAND</DECRYPTORSETUP>
  </DATA>
</WRMHEADER>

3.3.3. Formato

O cabeçalho PlayReady v4.3.0.0 tem a seguinte sintaxe:

<WRMHEADER xmlns="http://schemas.microsoft.com/DRM/2007/03/PlayReadyHeader" version="4.3.0.0">
  <DATA>
      <PROTECTINFO LICENSEREQUESTED="true">
        <KIDS>
          <KID ALGID="value" CHECKSUM="base64-encoded value" VALUE="base64-encoded guid"></KID>
          <KID ALGID="value" CHECKSUM="base64-encoded value" VALUE="base64-encoded guid"></KID>
          <KID ALGID="value" CHECKSUM="base64-encoded value" VALUE="base64-encoded guid"></KID>
        </KIDS>
      </PROTECTINFO>
      <LA_URL> URL for license acquisition </LA_URL>
      <LUI_URL>
        URL for Non-silent license acquisition web page
      </LUI_URL>
    <DS_ID> base64-encoded guid </DS_ID>
    <CUSTOMATTRIBUTES xmlns="">
      <mm:Publisher xmlns:mm="urn:schema-musicmogul-com">
           <mm:Author>
                Elvis Presley
           </mm:Author>
           <mm:CreationDate>
                2007/08/21:12:00:00
           </mm:CreationDate>
        </mm:Publisher>
    </CUSTOMATTRIBUTES>
    <DECRYPTORSETUP>ONDEMAND</DECRYPTORSETUP>
  </DATA>
</WRMHEADER>

As tags são descritas abaixo.

3.4. v4.2.0.0

PlayReady Header v4.2.0.0 foi introduzido com PlayReady versão 3.0 em abril de 2015 para permitir vários KIDs em um único cabeçalho. Isso significa que várias chaves podem ser usadas para criptografar um único ativo, por exemplo, quando as faixas de áudio devem ser criptografadas com uma chave diferente das faixas de vídeo.

3.4.1. Diferenças com outras versões

Os SDKs do PlayReady 3.0 e posteriores e os Clientes podem processar as versões de cabeçalho PlayReady v4.0, v4.1 e v4.2. SDKs PlayReady anteriores retornam um erro de "versão não suportada" quando fornecidos com cabeçalhos v4.2. Ao usar o cabeçalho v4.2, o cliente precisa saber qual versão do servidor está usando por meio de um mecanismo personalizado específico do aplicativo. Os SDKs PlayReady não fornecem nenhuma maneira nativa de obter essas informações de versão.

O formato de cabeçalho PlayReady v.4.2.0.0 tem as seguintes alterações em comparação com v4.1.0.0:

• O atributo version do elemento WRMHEADER é definido como a cadeia de caracteres "4.2.0.0".
• O elemento KID localizado dentro do elemento PROTECTINFO foi renomeado para KIDS e ainda é opcional.
• Vários elementos KID estão localizados dentro do elemento KIDS .

3.4.2. Exemplo

PlayReady Header 4.2.0.0 com duas teclas AESCTR:

<WRMHEADER xmlns="http://schemas.microsoft.com/DRM/2007/03/PlayReadyHeader" version="4.2.0.0">
  <DATA>
    <PROTECTINFO>
      <KIDS>
        <KID ALGID="AESCTR" CHECKSUM="xNvWVxoWk04=" VALUE="0IbHou/5s0yzM80yOkKEpQ=="></KID>
        <KID ALGID="AESCTR" CHECKSUM="GnKaQIRacPU=" VALUE="/qgG2xbs4k2SKCxx6bhWqw=="></KID>
      </KIDS>
    </PROTECTINFO>
    <LA_URL>http://rm.contoso.com/rightsmanager.asmx</LA_URL>
    <DS_ID>AH+03juKbUGbHl1V/QIwRA==</DS_ID>
  </DATA>
</WRMHEADER>

3.4.3. Formato

O cabeçalho PlayReady v4.2.0.0 tem a seguinte sintaxe:

<WRMHEADER xmlns="http://schemas.microsoft.com/DRM/2007/03/PlayReadyHeader" version="4.2.0.0">
  <DATA>
      <PROTECTINFO>
        <KIDS>
          <KID ALGID="AESCTR" CHECKSUM="base64-encoded value" VALUE="base64-encoded guid"></KID>
          <KID ALGID="AESCTR" CHECKSUM="base64-encoded value" VALUE="base64-encoded guid"></KID>
          <KID ALGID="AESCTR" CHECKSUM="base64-encoded value" VALUE="base64-encoded guid"></KID>
        </KIDS>
      </PROTECTINFO>
      <LA_URL> URL for license acquisition </LA_URL>
      <LUI_URL>
        URL for Non-silent license acquisition web page
      </LUI_URL>
    <DS_ID> base64-encoded guid </DS_ID>
    <CUSTOMATTRIBUTES xmlns="">
      <mm:Publisher xmlns:mm="urn:schema-musicmogul-com">
           <mm:Author>
                Elvis Presley
           </mm:Author>
           <mm:CreationDate>
                2007/08/21:12:00:00
           </mm:CreationDate>
        </mm:Publisher>
    </CUSTOMATTRIBUTES>
    <DECRYPTORSETUP>ONDEMAND</DECRYPTORSETUP>
  </DATA>
</WRMHEADER>

As tags são descritas abaixo.

3.5. v4.1.0.0

PlayReady Header v4.1.0.0 foi introduzido com a versão 2.0 do PlayReady em setembro de 2011 para dar suporte a transmissões lineares ao vivo, com licenças subsidiárias escaláveis incorporadas no fluxo. Esse tipo de fluxo requer que os clientes vinculem uma licença raiz escalável sem conhecimento da chave de criptografia de conteúdo que será usada no desencriptador.

3.5.1. Diferenças com outras versões

As SDKs PlayReady 2.0 e os Clientes subsequentes conseguem processar as versões de cabeçalho PlayReady v4.0 e v4.1. SDKs PlayReady anteriores retornam um erro de "versão não suportada" quando fornecidos com cabeçalhos v4.1.

O formato de cabeçalho PlayReady v.4.1.0.0 tem as seguintes alterações em comparação com v4.0.0.0:

• O atributo version do elemento WRMHEADER é definido como a cadeia de caracteres "4.1.0.0".
• O elemento DATA contém um elemento DECRYPTORSETUP opcional.
• O elemento KID está localizado dentro do elemento PROTECTINFO e é opcional em vez de obrigatório.
• O elemento KID contém os atributos ALGID (obrigatório), CHECKSUM (opcional) e VALUE (obrigatório).
• O elemento KEYLEN foi removido. O atributo KEYLEN foi anteriormente usado para desambiguar licenças de cocktail com chaves de comprimentos diferentes. O cabeçalho v4.1 quebrará a capacidade de suportar qualquer coisa, exceto teclas de coquetel de 8 bytes. Se você usar teclas de coquetel que não são de 8 bytes, deverá usar cabeçalhos v4.0.
• Os elementos ALGID e CHECKSUM foram removidos, uma vez que seus dados estão contidos em atributos do elemento KID .

3.5.2. Formato

O cabeçalho PlayReady v4.1.0.0 tem a seguinte sintaxe:

<WRMHEADER xmlns="http://schemas.microsoft.com/DRM/2007/03/PlayReadyHeader" version="4.1.0.0">
  <DATA>
      <PROTECTINFO>
        <KID ALGID="AESCTR" CHECKSUM="base64-encoded value" VALUE="base64-encoded guid"></KID>
      </PROTECTINFO>
      <LA_URL> URL for license acquisition </LA_URL>
      <LUI_URL>
        URL for Non-silent license acquisition web page
      </LUI_URL>
    <DS_ID> base64-encoded guid </DS_ID>
    <CUSTOMATTRIBUTES xmlns="">
      <mm:Publisher xmlns:mm="urn:schema-musicmogul-com">
           <mm:Author>
                Elvis Presley
           </mm:Author>
           <mm:CreationDate>
                2007/08/21:12:00:00
           </mm:CreationDate>
        </mm:Publisher>
    </CUSTOMATTRIBUTES>
    <DECRYPTORSETUP>ONDEMAND</DECRYPTORSETUP>
  </DATA>
</WRMHEADER>

As tags são descritas abaixo.

Notas para v4.1:

• Todas as marcas XML e atributos no cabeçalho PlayReady são definidos pela Microsoft. A única exceção é o conteúdo do elemento CUSTOMATTRIBUTES . Os desenvolvedores de aplicativos PlayReady PC não devem adicionar nenhuma tag personalizada fora do elemento CUSTOMATTRIBUTES .
• O cabeçalho PlayReady deve obedecer às especificações W3C Canonical XML v1.1.
• O cabeçalho PlayReady não contém uma tag ?XML de nível superior, que é necessária em XML bem formado.
• Recomenda-se que o tamanho deste campo não exceda 1 KB.

3.6. v4.0.0.0

PlayReady Header v4.0.0.0 foi introduzido com PlayReady versão 1.0 em 2008 e permite uma única chave AESCTR para suportar conteúdo criptografado AES, ou uma chave COCKTAIL para suportar conteúdo criptografado WMDRM.

3.6.1. Exemplos

Cabeçalho PlayReady 4.0.0.0

<WRMHEADER xmlns="http://schemas.microsoft.com/DRM/2007/03/PlayReadyHeader" version="4.0.0.0">
  <DATA>
    <PROTECTINFO>
      <ALGID>AESCTR</ALGID>
      <KEYLEN>16</KEYLEN>
    </PROTECTINFO>
    <KID>q5HgCTj40kGeNVhTH9Gexw==</KID>
    <CHECKSUM>w+OZVr8vzrQ=</CHECKSUM>
    <LA_URL>http://rm.contoso.com/rightsmanager.asmx</LA_URL>
    <CUSTOMATTRIBUTES>
      <IIS_DRM_VERSION>8.0.1705.19</IIS_DRM_VERSION>
    </CUSTOMATTRIBUTES>
  </DATA>
</WRMHEADER>

Objeto PlayReady codificado em Base64 contendo um cabeçalho PlayReady 4.0.0.0

Infelizmente, não é possível apresentar uma tradução fluente, pois o texto fornecido está em formato codificado/base64 e não em linguagem compreensível. Por favor, forneça o texto decodificado ou legível para que o mesmo possa ser eficazmente traduzido.

3.6.2. Formato

O cabeçalho PlayReady v4.0.0.0 tem a seguinte sintaxe:

<WRMHEADER xmlns="http://schemas.microsoft.com/DRM/2007/03/PlayReadyHeader" version="4.0.0.0">
<DATA>
      <PROTECTINFO>
        <ALGID>AESCTR</ALGID>
        <KEYLEN>16</KEYLEN>
      </PROTECTINFO>
      <LA_URL> URL for license acquisition </LA_URL>
      <LUI_URL>
        URL for Non-silent license acquisition web page
      </LUI_URL>
    <DS_ID>base64-encoded guid</DS_ID>
    <KID>base64-encoded kid</KID>
    <CUSTOMATTRIBUTES xmlns="">
      <mm:Publisher xmlns:mm="urn:schema-musicmogul-com">
           <mm:Author>
                Elvis Presley
           </mm:Author>
           <mm:CreationDate>
                2007/08/21:12:00:00
           </mm:CreationDate>
        </mm:Publisher>
    </CUSTOMATTRIBUTES>
    <CHECKSUM>
      checksum of the content key for verification
    </CHECKSUM>
  </DATA>
</WRMHEADER>

A tabela a seguir descreve as diferentes tags.

Notas para v4.0:

• Todas as marcas XML e atributos no cabeçalho PlayReady são definidos pela Microsoft. A única exceção é o conteúdo do elemento CUSTOMATTRIBUTES . Os desenvolvedores de aplicativos PlayReady PC não devem adicionar nenhuma tag personalizada fora do elemento CUSTOMATTRIBUTES , pois isso pode entrar em conflito com marcas futuras que a Microsoft define.
• A ordem dos elementos filho dentro de um elemento de contêiner não importa.
• Observe que o cabeçalho PlayReady não contém uma tag de nível ?XML superior que é necessária em XML bem formado.
• Recomenda-se que o tamanho deste campo não exceda 1 KB.
• CHECKSUM é necessário para o PlayReady Server SDK até a versão 1.2. Desde a versão 1.5, o PlayReady Server SDK trata a CHECKSUM como opcional. PlayReady Porting Kit 1.2 de forma padrão requer a soma de verificação. O PlayReady Porting Kit 2.0 trata a CHECKSUM como opcional.

4. Loja de Licenças Incorporadas (ELS)

É uma boa prática adicionar um Embedded License Store vazio ao objeto PlayReady nas seguintes condições:

• O objeto PlayReady deve ser inserido em um arquivo de conteúdo.
• O conteúdo pode ser usado em um contexto de domínios PlayReady com licenças incorporadas.

Isso permite que um cliente PlayReady incorpore ainda mais uma licença vinculada ao domínio no objeto PlayReady simplesmente preenchendo o Embedded License Store existente e economiza o esforço de ter que recabelar o arquivo inteiro com um novo objeto PlayReady de um tamanho maior do que o inicial.

5. Algoritmo de soma de verificação de chave

O algoritmo de verificação de soma no cabeçalho PlayReady destina-se a proteger contra chaves discrepantes. Nos primórdios do DRM, as músicas eram criptografadas com chaves rotuladas incorretamente. Isso resultou em ruído branco sendo reproduzido quando as músicas foram descriptografadas. E se as músicas fossem tocadas em alto volume, o equipamento de reprodução acabava por se destruir. Com a soma de verificação, a chave de conteúdo pode ser confirmada como a chave utilizada para encriptar o ficheiro. O algoritmo funciona da seguinte forma:

Para um valor ALGID definido como "AESCBC", não há nenhum algoritmo de soma de verificação de chave definido. O atributo CHECKSUM deve ser omitido.

Para um valor ALGID definido como "AESCTR", o ID da chave de 16 bytes é criptografado com uma chave de conteúdo AES de 16 bytes usando o modo ECB. Os primeiros 8 bytes do buffer são extraídos e codificados em base64.

Para um valor ALGID definido como "COCKTAIL", execute as seguintes etapas:

1. Um buffer de 21 bytes é criado.

2. A chave de conteúdo é colocada no buffer e o restante do buffer é preenchido com zeros.

3. Para cinco iterações:

   a) buffer = SHA-1 (buffer).

4. Os primeiros 7 bytes do buffer são extraídos e codificados em base64.

5. Depois que essas etapas são executadas, os bytes codificados em base64 são usados como a soma de verificação.

6. ATRIBUTOS PERSONALIZADOS

Um provedor de serviços pode adicionar XML proprietário dentro do elemento CUSTOMATTRIBUTES do cabeçalho PlayReady. Quaisquer tags usadas dentro do elemento CUSTOMATTRIBUTES têm a garantia de não entrar em conflito com futuras tags definidas pela Microsoft.

O código da Microsoft não atua em nenhum XML dentro desse elemento. O back-end do provedor de serviços ou o código do lado do cliente são os únicos que normalmente interpretam o valor desse elemento. Por exemplo, digamos que um serviço white label representa serviços front-end AAA, BBB, CCC. Esse serviço pode encriptar a sua biblioteca de conteúdos apenas uma vez (uma vez que se trata de uma operação dispendiosa), mas quando fornece conteúdo a um utilizador final, pode definir os CUSTOMATTRIBUTES como o nome do serviço front-end específico que o utilizador final subscreve. Quando o usuário final solicita uma licença para esse conteúdo, isso permite que o serviço white label determine qual serviço front-end o usuário final assina, para que ele possa emitir uma licença diferente.

O tamanho deste campo não deve exceder 1 kilobyte (KB).