ContentKey

  • Artykuł

Element ContentKey zapewnia bezpieczny dostęp do zasobu. Oprócz tworzenia jednostki ContentKey należy również użyć klucza ochrony do szyfrowania wygenerowanego klucza zawartości. Aby uzyskać więcej informacji na temat pobierania klucza ochrony, zobacz Szyfrowanie zasobu (opcjonalnie) i funkcji interfejsu API REST.

Ten temat zawiera omówienie ContentKey jednostki, a także pokazuje, jak wykonywać różne operacje za pomocą interfejsu API REST usługi Media Services.

Ważne

Podczas uzyskiwania dostępu do jednostek w usłudze Media Services należy ustawić określone pola nagłówka i wartości w żądaniach HTTP.
Aby uzyskać więcej informacji, zobacz Konfigurowanie tworzenia interfejsu API REST usługi Media Services i nawiązywanie połączenia z usługą Media Services przy użyciu interfejsu API REST usługi Media Services.

Właściwości jednostki ContentKey

Właściwość Typ Opis
Id

Wymagane. Ta wartość nie jest ustawiana przez usługę Media Services.		 Edm.String Unikatowy identyfikator zdefiniowany przez użytkownika.
Created

Tylko do odczytu. Ustaw przez usługę Media Services w czasie tworzenia.		 Edm.DateTime Ta wartość jest ustawiana przez usługę Media Services w czasie tworzenia.
LastModified

Tylko do odczytu. Ustaw przez usługę Media Services.		 Edm.DateTime Ta wartość jest aktualizowana przez usługę Media Services po wprowadzeniu wszelkich zmian właściwości.
ContentKeyType

Opcjonalny.		 Edm.Int32 Wartość wyliczenia określająca typ klucza zawartości. Prawidłowe wartości:

- CommonEncryption = 0
- StorageEncryption = 1
- ConfigurationEncryption = 2
- KopertaSzyfrowanie = 4
EncryptedContentKey

Opcjonalny.		 Edm.String Klucz zawartości zaszyfrowany przy użyciu klucza publicznego certyfikatu X.509. Maksymalna długość to 4000.
Name

Opcjonalny.		 Edm.String Przyjazna nazwa elementu ContentKey. Maksymalna długość to 4000.
ProtectionKeyId

Opcjonalny.		 Edm.String Odcisk palca certyfikatu X.509 używanego do szyfrowania magazynu, wspólnego szyfrowania lub kluczy szyfrowania konfiguracji. Ta wartość jest zwracana podczas wywoływania funkcji GetProtectionKeyId. Maksymalna długość to 4000.
ProtectionKeyType

Opcjonalny.		 Edm.Int32 Wartość wyliczenia określająca typ klucza ochrony. Prawidłowe wartości:

- X509CertificateThumbprint = 0
Checksum

Opcjonalny.		 Edm.String Suma kontrolna klucza zawartości. Maksymalna długość to 4000.
AuthorizationPolicyId Edm.String Identyfikator zasad autoryzacji skojarzony z elementem ContentKey.

Tworzenie klucza zawartości

Identyfikatory ContentKey można utworzyć przy użyciu żądania HTTP POST.

Metoda Identyfikator URI żądania Wersja protokołu HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys> HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz 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=" }

Uzyskiwanie adresu URL dostarczania kluczy

Pobiera adres URL dostarczania klucza dla określonej metody dostarczania klucza zawartości. Klient używa zwróconego adresu URL do żądania klucza AES lub licencji PlayReady w celu odtwarzania chronionej zawartości.

Określ typ adresu URL, który ma być pobierany w treści żądania HTTP. Jeśli chronisz zawartość za pomocą elementu PlayReady, poproś o adres URL pozyskiwania licencji PlayReady usługi Media Services przy użyciu polecenia 1keyDeliveryType: {"keyDeliveryType":1}. Jeśli chronisz zawartość przy użyciu szyfrowania koperty, poproś o adres URL pozyskiwania klucza, określając 2 wartość keyDeliveryType: {"keyDeliveryType":2}.

Metoda Identyfikator URI żądania Wersja protokołu HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys>('ContentkeyId')/GetKeyDeliveryUrl HTTP/1.1

Przykład

Możesz wypróbować poniższy przykład na karcie Kompozytor programu Fiddler. W przykładzie jest pobierany adres URL pozyskiwania licencji PlayReady.

Nagłówki żądań:

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

Treść żądania:

{"keyDeliveryType":1}

Jeśli operacja zakończy się pomyślnie, ta operacja zwróci kod stanu OK 200 OK i określony adres URL. Na przykład: https://account001.keydelivery.mediaservices.windows.net/PlayReady/.

Lista elementów ContentKeys

Identyfikatory ContentKey są pobierane przy użyciu żądania HTTP GET.

Metoda Identyfikator URI żądania Wersja protokołu HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys> HTTP/1.1
Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys>('contentkeyid') HTTP/1.1
Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/ContentKeys HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Artykuł Usługa 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

Usuwanie klucza zawartości

Klucz zawartości jest usuwany za pośrednictwem żądania HTTP DELETE.

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys>('contentkeyid') HTTP/1.1

Przykładowe żądanie

Możesz wypróbować poniższy przykład na karcie Composer programu Fiddler.

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Artykuł Usługa 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

Zobacz też

AccessPolicy
Zasób
AssetFile
Zadanie
JobTemplate
Lokalizator
MediaProcessor
Zadanie
TaskTemplate
Limity przydziału i ograniczenia