Dela via

ContentKey

  • Artikel

En ContentKey ger säker åtkomst till en tillgång. Förutom att skapa en ContentKey-entitet måste du även använda en skyddsnyckel för att kryptera den innehållsnyckel som du genererar. Mer information om hur du hämtar skyddsnyckeln finns i Kryptera tillgången (valfritt) och REST API Functions.

Det här avsnittet ger en översikt över ContentKey entiteten och visar även hur du kör olika åtgärder med Media Services REST API.

Viktigt

När du kommer åt entiteter i Media Services måste du ange specifika rubrikfält och värden i dina HTTP-begäranden.
Mer information finns i Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API (Installation för Media Services REST API Development and Connecting to Media Services with the Media Services REST API).

Egenskaper för ContentKey-entitet

Egenskap Typ Description
Id

Krävs. Det här värdet anges inte av Media Services.		 Edm.String Användardefinierad unik identifierare.
Created

Skrivskyddad. Anges av Media Services vid skapandetillfället.		 Edm.DateTime Det här värdet anges av Media Services när det skapas.
LastModified

Skrivskyddad. Anges av Media Services.		 Edm.DateTime Det här värdet uppdateras av Media Services när eventuella egenskapsändringar har gjorts.
ContentKeyType

Valfritt.		 Edm.Int32 Ett uppräkningsvärde som anger innehållsnyckeltypen. Giltiga värden är:

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

Valfritt.		 Edm.String Innehållsnyckel krypterad med den offentliga nyckeln för X.509-certifikatet. Maximal längd är 4 000.
Name

Valfritt.		 Edm.String Eget namn för din ContentKey. Maximal längd är 4 000.
ProtectionKeyId

Valfritt.		 Edm.String Tumavtryck för X.509-certifikatet som används för att kryptera lagring, vanlig kryptering eller konfigurationskrypteringsnycklar. Det här värdet returneras till dig när du anropar funktionen GetProtectionKeyId. Maximal längd är 4 000.
ProtectionKeyType

Valfritt.		 Edm.Int32 Ett uppräkningsvärde som anger skyddsnyckeltypen. Giltiga värden är:

- X509CertificateThumbprint = 0
Checksum

Valfritt.		 Edm.String Kontrollsumman för ContentKey. Maximal längd är 4 000.
AuthorizationPolicyId Edm.String Det auktoriseringsprincip-ID som är associerat med ContentKey.

Skapa en ContentKey

ContentKeys kan skapas med en POST HTTP-begäran.

Metod URI för förfrågan HTTP-version
POST <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys> HTTP/1.1

Exempelförfrågan

Information om hur du får det senaste x-ms-version:finns i Media Services REST.

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=" }

Hämta URL för nyckelleverans

Hämtar nyckelleverans-URL:en för den angivna leveransmetoden för innehållsnyckeln. En klient använder den returnerade URL:en för att begära en AES-nyckel eller en PlayReady-licens för att spela upp det skyddade innehållet.

Ange vilken typ av URL som ska visas i brödtexten i HTTP-begäran. Om du skyddar ditt innehåll med PlayReady begär du en URL för PlayReady-licensförvärv i Media Services med hjälp av 1 för keyDeliveryType: {"keyDeliveryType":1}. Om du skyddar ditt innehåll med kuvertkryptering begär du en URL för nyckelförvärv genom att 2 ange för keyDeliveryType: {"keyDeliveryType":2}.

Metod URI för förfrågan HTTP-version
POST <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys>('ContentkeyId')/GetKeyDeliveryUrl HTTP/1.1

Exempel

Du kan prova följande exempel på fliken Fiddler's Composer. Exemplet hämtar URL:en för PlayReady-licensförvärv.

Begärandehuvuden:

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

Begärandetext:

{"keyDeliveryType":1}

Om åtgärden lyckas returneras statuskoden 200 OK och den angivna URL:en. Exempel: https://account001.keydelivery.mediaservices.windows.net/PlayReady/.

Visa innehållsnycklar

ContentKeys hämtas med hjälp av en GET HTTP-begäran.

Metod URI för förfrågan HTTP-version
GET <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys> HTTP/1.1
Metod URI för förfrågan HTTP-version
GET <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys>('contentkeyid') HTTP/1.1
Metod URI för förfrågan HTTP-version
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/ContentKeys HTTP/1.1

Exempelförfrågan

Information om hur du får det senaste x-ms-version:finns i Media Services REST.

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

Ta bort en ContentKey

ContentKeys tas bort via en DELETE HTTP-begäran.

Metod URI för förfrågan HTTP-version
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys>('contentkeyid') HTTP/1.1

Exempelförfrågan

Du kan prova följande exempel på fliken Fiddler's Composer.

Information om hur du får det senaste x-ms-version:finns i Media Services REST.

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

Se även

AccessPolicy
Tillgång
AssetFile
Jobb
JobTemplate
Locator
MediaProcessor
Uppgift
TaskTemplate
Kvoter och begränsningar