Sdílet prostřednictvím

ContentKey

  • Článek

ContentKey poskytuje zabezpečený přístup k prostředku. Kromě vytvoření entity ContentKey musíte také použít ochranný klíč k zašifrování vygenerovaného klíče obsahu. Další informace o načtení ochranného klíče najdete v tématu Šifrování prostředků (volitelné) a funkce rozhraní REST API.

Toto téma poskytuje přehled ContentKey entity a také ukazuje, jak provádět různé operace pomocí rozhraní REST API služby Media Services.

Důležité

Při přístupu k entitě ve službě Media Services musíte v požadavcích HTTP nastavit konkrétní pole hlaviček a hodnoty.
Další informace najdete v tématu Nastavení pro vývoj rozhraní REST API služby Media Services a připojení ke službě Media Services pomocí rozhraní REST API služby Media Services.

Vlastnosti entity ContentKey

Vlastnost Typ Description
Id

Povinná hodnota. Tato hodnota není nastavena službou Media Services.		 Edm.String Jedinečný identifikátor definovaný uživatelem.
Created

Jen pro čtení. Nastavení službou Media Services při vytváření.		 Edm.DateTime Tato hodnota je nastavena službou Media Services při vytváření.
LastModified

Jen pro čtení. Nastaveno službou Media Services.		 Edm.DateTime Tato hodnota je aktualizována službou Media Services po provedení jakýchkoli změn vlastností.
ContentKeyType

Nepovinný parametr.		 Edm.Int32 Hodnota výčtu, která určuje typ klíče obsahu. Platné hodnoty jsou:

- CommonEncryption = 0
– StorageEncryption = 1
– ConfigurationEncryption = 2
- EnvelopeEncryption = 4
EncryptedContentKey

Nepovinný parametr.		 Edm.String Klíč obsahu šifrovaný pomocí veřejného klíče certifikátu X.509. Maximální délka je 4000.
Name

Nepovinný parametr.		 Edm.String Popisný název vašeho ContentKey. Maximální délka je 4000.
ProtectionKeyId

Nepovinný parametr.		 Edm.String Kryptografický otisk certifikátu X.509, který se používá k šifrování úložiště, běžných šifrovacích nebo konfiguračních šifrovacích klíčů. Tato hodnota se vrátí při volání funkce GetProtectionKeyId. Maximální délka je 4000.
ProtectionKeyType

Nepovinný parametr.		 Edm.Int32 Hodnota výčtu, která určuje typ klíče ochrany. Platné hodnoty jsou:

- X509CertificateThumbprint = 0
Checksum

Nepovinný parametr.		 Edm.String Kontrolní součet ContentKey. Maximální délka je 4000.
AuthorizationPolicyId Edm.String ID zásad autorizace přidružené k ContentKey.

Vytvoření contentkey

ContentKeys je možné vytvořit pomocí požadavku POST HTTP.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys> HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu Rest služby Media Services.

POST https://<accountname>.restv2.<location>.media.azure.net/api/ContentKeys HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization:  Bearer <token value>  
Host: media.windows.net  
Content-Length: 572  
Expect: 100-continue  
  
{"Id" : "nb:kid:UUID:316d14d4-b603-4d90-b8db-0fede8aa48f8", "ContentKeyType" : 1, "EncryptedContentKey" : "Y4NPej7heOFa2vsd8ZEOcjjpu/qOq3RJ6GRfxa8CCwtAM83d6J2mKOeQFUmMyVXUSsBCCOdufmieTKi+hOUtNAbyNM4lY4AXI537b9GaY8oSeje0NGU8+QCOuf7jGdRac5B9uIk7WwD76RAJnqyep6U/OdvQV4RLvvZ9w7nO4bY8RHaUaLxC2u4aIRRaZtLu5rm8GKBPy87OzQVXNgnLM01I8s3Z4wJ3i7jXqkknDy4VkIyLBSQvIvUzxYHeNdMVWDmS+jPN9ScVmolUwGzH1A23td8UWFHOjTjXHLjNm5Yq+7MIOoaxeMlKPYXRFKofRY8Qh5o5tqvycSAJ9KUqfg==", "ProtectionKeyId" : "7D9BB04D9D0A4A24800CADBFEF232689E048F69C", "ProtectionKeyType" : 1, "Checksum" : "TfXtjCIlq1Y=" }

Získat adresu URL pro doručování klíčů

Získá adresu URL doručení klíče pro zadanou metodu doručení klíče obsahu. Klient použije vrácenou adresu URL k vyžádání klíče AES nebo licence PlayReady za účelem přehrávání chráněného obsahu.

Zadejte typ adresy URL, která se má dostat do textu požadavku HTTP. Pokud chráníte obsah pomocí PlayReady, požádejte o adresu URL pro získání licence PlayReady služby Media Services pomocí 1keyDeliveryTypepříkazu : {"keyDeliveryType":1}. Pokud chráníte obsah šifrováním obálky, vyžádejte si adresu URL pro získání klíče zadáním 2keyDeliveryType: {"keyDeliveryType":2}.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys>('ContentkeyId')/GetKeyDeliveryUrl HTTP/1.1

Ukázka

Následující příklad si můžete vyzkoušet na kartě Fiddlerův skladatel. Příklad získá adresu URL pro získání licence PlayReady.

Hlavičky požadavků:

POST https://<accountname>.restv2.<location>.media.azure.net/api/ContentKeys('nb:kid:UUID:14e7e815-5db3-4027-9578-a55a416a3367')/GetKeyDeliveryUrl HTTP/1.1  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json  
Accept-Charset: UTF-8  
User-Agent: Microsoft ADO.NET Data Services  
Authorization:  Bearer <token value>  
x-ms-version: 2.19  
Content-Type: application/json  
Host: media.windows.net  
Content-Length: 21

Text požadavku:

{"keyDeliveryType":1}

V případě úspěchu vrátí tato operace stavový kód 200 OK a zadanou adresu URL. Příklad: https://account001.keydelivery.mediaservices.windows.net/PlayReady/.

List ContentKeys

ContentKeys se načítají pomocí požadavku HTTP GET.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys> HTTP/1.1
Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys>('contentkeyid') HTTP/1.1
Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/ContentKeys HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu Rest služby Media Services.

GET https://<accountname>.restv2.<location>.media.azure.net/api/ContentKeys('nb:kid:UUID:58b522a5-be4e-4988-8958-ee0cdb179273') HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization:  Bearer <token value>  
Host: media.windows.net

Odstranění klíče obsahu

ContentKeys se odstraní prostřednictvím požadavku HTTP DELETE.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys>('contentkeyid') HTTP/1.1

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerův skladatel.

Nejnovější verzi najdete v x-ms-version:tématu Rest služby Media Services.

DELETE https://<accountname>.restv2.<location>.media.azure.net/api/ContentKeys('nb:kid:UUID:58b522a5-be4e-4988-8958-ee0cdb179273') HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0

Viz také

Zásady přístupu
Prostředek
AssetFile
Úloha
Pracovní pozice
Lokátor
MediaProcessor
Úkol
TaskTemplate
Kvóty a omezení