View a markdown version of this page

API SPEKE v2.0 - Componentes de carga útil padrão - Especificação da API do Secure Packager and Encoder Key Exchange

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

API SPEKE v2.0 - Componentes de carga útil padrão

Por meio de uma única solicitação SPEKE, o criptografador pode solicitar várias chaves de conteúdo, juntamente com a sinalização de manifestação necessária para vários formatos de empacotamento, de acordo com o contrato de criptografia definido para um determinado conteúdo.

Para cobrir todos esses aspectos, um documento CPIX padrão é composto por três seções de lista obrigatórias, além de uma seção de lista opcional para rotação de chaves de conteúdo em tempo real.

<cpix: ContentKeyList > seção e elemento cpix:cpix de nível < superior >

Esta é uma seção obrigatória, relevante para streaming ao vivo e VOD, definindo as diferentes chaves de conteúdo que precisam ser usadas pelo criptografador. O elemento <cpix:ContentKeyList> pode conter um ou vários elementos <cpix:ContentKey> secundários, cada um deles descrevendo uma chave de conteúdo distinta.

De acordo com a especificação CPIX, os valores possíveis do ContentKey@commonEncryptionScheme atributo são definidos na especificação Criptografia comum em arquivos de formato de arquivo de mídia base ISO (ISO/IEC 23001-7:2016):

  • 'cen': AES-CTR modo de amostra completa e criptografia de subamostra NAL de vídeo

  • 'cbc1': AES-CBC modo de amostra completa e criptografia de subamostra NAL de vídeo

  • 'cens': AES-CTR modo de criptografia parcial do padrão NAL de vídeo

  • 'cbcs': AES-CBC modo de criptografia parcial do padrão NAL de vídeo

O exemplo a seguir mostra um documento CPIX com uma única chave de conteúdo não criptografada:

<cpix:CPIX contentId="abc123" version="2.3" xmlns:cpix="urn:dashif:org:cpix" xmlns:pskc="urn:ietf:params:xml:ns:keyprov:pskc">
	<cpix:ContentKeyList>
		<cpix:ContentKey explicitIV="OFj2IjCsPJFfMAxmQxLGPw==" kid="98ee5596-cd3e-a20d-163a-e382420c6eff" commonEncryptionScheme="cbcs">
			<cpix:Data>
				<pskc:Secret>
					<pskc:PlainValue>5dGAgwGuUYu4dHeHtNlxJw==</pskc:PlainValue>
				</pskc:Secret>
			</cpix:Data>
		</cpix:ContentKey>
	</cpix:ContentKeyList>
	...
</cpix:CPIX>

Por padrão, as chaves de conteúdo não são criptografadas, como no exemplo abaixo. Mas a criptografia das chaves de conteúdo pode ser solicitada pelo criptografador por meio da inclusão do elemento<cpix : >. DeliveryDataList Consulte a seção Criptografia de chave de conteúdo para obter mais detalhes.

Elemento suportado pelo SPEKE Atributos obrigatórios Atributos opcionais Elementos secundários obrigatórios Elementos secundários opcionais

<cpix:CPIX>

contentId, version, xmlns:cpix, xmlns:pskc

name, xmlns:enc

um <cpix: ContentKeyList >, um<cpix : >, um <cpix: DRMSystemList > ContentKeyUsageRuleList

um <cpix: DeliveryDataList >, um <cpix : >ContentKeyPeriodList

<cpix : >ContentKeyList

-

id

pelo menos um <cpix : >ContentKey

-

<cpix : >ContentKey

criança, comumEncryptionScheme, dados

id, Algorithm, explicitIV

um <pskc:Secret>

-

<pskc:Secret>

PlainValue or EncryptedValue

ValueMAC

-

<enc: EncryptionMethod >, <enc : >CipherData
<cpix: seção DRMSystemList >

Esta é uma seção obrigatória, relevante para streaming ao vivo e VOD, definindo os diferentes sistemas DRM que precisam ser aproveitados junto com as chaves de conteúdo.

O exemplo a seguir mostra uma lista de sistemas DRM com uma única especificação de sistema PlayReady DRM:

<cpix:DRMSystemList>
	<cpix:DRMSystem kid="98ee5596-cd3e-a20d-163a-e382420c6eff" systemId="9a04f079-9840-4286-ab92-e65be0885f95">
		<cpix:HLSSignalingData playlist="media">HicXmbZ2m[...]4==</cpix:HLSSignalingData>
		<cpix:HLSSignalingData playlist="master">HicXmbZ2m[...]jEi</cpix:HLSSignalingData>
		<cpix:ContentProtectionData>t7WwH24FI[...]YCC</cpix:ContentProtectionData>
		<cpix:PSSH>FFFFanBzc[...]A==</cpix:PSSH>
		<cpix:SmoothStreamingProtectionHeaderData>s5RrJ12HL[...]UBB</cpix:SmoothStreamingProtectionHeaderData>
	</cpix:DRMSystem>
</cpix:DRMSystemList>

Para obter uma lista completa dos SystemIDs de DRM, consulte a seção Proteção de conteúdo do repositório de DASH-IF identificadores.

Elemento suportado pelo SPEKE Atributos obrigatórios Atributos opcionais Elementos secundários obrigatórios Elementos secundários opcionais

<cpix : >DRMSystemList

-

id

pelo menos um <cpix:DRMSystem>

-

<cpix:DRMSystem>

kid, systemId

id, name, PSSH

-

ContentProtectionData, SmoothStreamingProtectionHeaderData, dois elementos <cpix: HLSSignalingData > com valor de atributo de playlist diferente

DRMSystem@PSSHé obrigatório se o ISO-BMFF encapsulamento for aplicado a segmentos de mídia. DRMSystem.ContentProtectionDataO <pssh> elemento innerXML é aproveitado pelo criptografador somente para fins de sinalização de manifesto.

Se DRMSystem@PSSH estiver presente e DRMSystem.ContentProtectionData contiver um <pssh> elemento innerXML, ambos os valores devem ser idênticos.

Se a sinalização DRMSystem deve ser transmitida em manifestos HLS, ambos os elementos <cpix:HLSSignalingData playlist="media"> e <cpix:HLSSignalingData playlist="master"> devem ser incluídos na solicitação e na resposta do CPIX.

<cpix: seção ContentKeyPeriodList >

Essa é uma seção opcional, relevante somente para transmissão em tempo real, que define os períodos criptográficos aplicados ao conteúdo.

O elemento <cpix:ContentKeyPeriodList> pode conter um ou vários elementos <cpix:ContentKeyPeriod> secundários, cada um deles descrevendo uma chave de conteúdo distinta. Usar UUIDs como parte do valor do atributo id é uma abordagem comumente usada.

<cpix:ContentKeyPeriodList>
	<cpix:ContentKeyPeriod id="keyPeriod_0909829f-40ff-4625-90fa-75da3e53278f" index="1" />
</cpix:ContentKeyPeriodList>
Elemento suportado pelo SPEKE Atributos obrigatórios Atributos opcionais Elementos secundários obrigatórios Elementos secundários opcionais

<cpix : >ContentKeyPeriodList

-

id

pelo menos um <cpix : >ContentKeyPeriod

-

<cpix : >ContentKeyPeriod

id, index

-

-

-

Se forem usados períodos criptográficos, as chaves de criptografia também precisarão ser anexadas a um dos períodos criptográficos no documento CPIX, conforme mostrado na seção abaixo.

<cpix: seção ContentKeyUsageRuleList >

Esta é uma seção obrigatória, relevante para streaming ao vivo e VOD, que define como as diferentes chaves de conteúdo protegerão as faixas dentro do streamset e durante os períodos criptográficos.

O elemento <cpix: ContentKeyUsageRuleList > pode conter um ou vários elementos secundários <cpix: ContentKeyUsageRule >, cada um deles descrevendo as faixas às quais uma determinada chave de conteúdo é aplicada pelo criptografador, potencialmente durante um período criptográfico específico. É necessário que pelo menos um elemento <cpix: AudioFilter > ou <cpix: VideoFilter > esteja presente em um elemento<cpix : >. ContentKeyUsageRule

O exemplo a seguir mostra uma lista simples com apenas uma regra aplicando uma única chave de conteúdo a todas as faixas de áudio e vídeo durante um período criptográfico específico.

<cpix:ContentKeyUsageRuleList>
	<cpix:ContentKeyUsageRule kid="98ee5596-cd3e-a20d-163a-e382420c6eff" intendedTrackType="ALL">
		<cpix:KeyPeriodFilter periodId="keyPeriod_0909829f-40ff-4625-90fa-75da3e53278f"/>
		<cpix:AudioFilter />
		<cpix:VideoFilter />
	</cpix:ContentKeyUsageRule>
</cpix:ContentKeyUsageRuleList>
Elemento suportado pelo SPEKE Atributos obrigatórios Atributos opcionais Elementos secundários obrigatórios Elementos secundários opcionais

<cpix : >ContentKeyUsageRuleList

-

id

pelo menos um <cpix : >ContentKeyUsageRule

-

<cpix : >ContentKeyUsageRule

criança, pretendida TrackType

-

pelo menos um <cpix: AudioFilter > ou um <cpix : >(*) VideoFilter

<cpix : >KeyPeriodFilter

<cpix : >KeyPeriodFilter

periodId

-

-

-

<cpix : >AudioFilter

-

minChannels, maxChannels

-

-

<cpix : >VideoFilter

-

minPixels, maxPixels, hdr, minFps, maxFps

-

-

(*) Para obter uma explicação detalhada sobre o uso de uma ou várias chaves de conteúdo para proteger uma ou várias faixas em um streamset, consulte a seção Documentação do Contrato de Criptografia.