ContentKey

  • Makale

ContentKey bir Varlığa güvenli erişim sağlar. ContentKey varlığı oluşturmaya ek olarak, oluşturduğunuz içerik anahtarını şifrelemek için bir koruma anahtarı da kullanmanız gerekir. Koruma anahtarını alma hakkında daha fazla bilgi için bkz. Varlığı Şifreleme (İsteğe Bağlı) ve REST API İşlevleri.

Bu konu, varlığa genel bir bakış ContentKey sağlar ve ayrıca Media Services REST API'siyle çeşitli işlemlerin nasıl yürütüleceklerini gösterir.

Önemli

Media Services'teki varlıklara erişirken, HTTP isteklerinizde belirli üst bilgi alanlarını ve değerlerini ayarlamanız gerekir.
Daha fazla bilgi için bkz. Media Services REST API Geliştirme kurulumu ve Media Services REST API ile Media Services'e Bağlanma.

ContentKey Varlık Özellikleri

Özellik Tür Description
Id

Gereklidir. Bu değer Media Services tarafından ayarlanmaz.		 Edm.String Kullanıcı tanımlı benzersiz tanımlayıcı.
Created

Salt okunur. Media Services tarafından oluşturma zamanında ayarlanır.		 Edm.DateTime Bu değer Media Services tarafından oluşturma zamanında ayarlanır.
LastModified

Salt okunur. Media Services tarafından ayarlanır.		 Edm.DateTime Özellik değişiklikleri yapıldıktan sonra bu değer Media Services tarafından güncelleştirilir.
ContentKeyType

İsteğe bağlı.		 Edm.Int32 İçerik anahtarı türünü belirten bir numaralandırma değeri. Geçerli değerler:

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

İsteğe bağlı.		 Edm.String İçerik anahtarı, X.509 sertifikasının ortak anahtarıyla şifrelenir. Maksimum uzunluk 4000'dir.
Name

İsteğe bağlı.		 Edm.String ContentKey'inizin kolay adı. Maksimum uzunluk 4000'dir.
ProtectionKeyId

İsteğe bağlı.		 Edm.String Depolama, ortak şifreleme veya yapılandırma şifreleme anahtarlarını şifrelemek için kullanılan X.509 sertifikasının parmak izi. GetProtectionKeyId işlevi çağrılırken bu değer döndürülür. Maksimum uzunluk 4000'dir.
ProtectionKeyType

İsteğe bağlı.		 Edm.Int32 Koruma anahtarı türünü belirten bir numaralandırma değeri. Geçerli değerler:

- X509CertificateThumbprint = 0
Checksum

İsteğe bağlı.		 Edm.String ContentKey sağlama toplamı. Maksimum uzunluk 4000'dir.
AuthorizationPolicyId Edm.String ContentKey ile ilişkili yetkilendirme ilkesi kimliği.

ContentKey Oluşturma

ContentKeys, POST HTTP isteği kullanılarak oluşturulabilir.

Yöntem İstek URI'si HTTP Sürümü
POST <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys> HTTP/1.1

Örnek İstek

En son x-ms-version:sürümü edinmek için bkz. 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=" }

Anahtar Teslim URL'sini alma

İçerik anahtarının belirtilen teslim yöntemi için anahtar teslim URL'sini alır. İstemci, korumalı içeriği kayıttan yürütmek için AES anahtarı veya PlayReady lisansı istemek için döndürülen URL'yi kullanır.

HTTP isteğinin gövdesine eklenecek URL'nin türünü belirtin. İçeriğinizi PlayReady ile koruyorsanız, şunu kullanarak 1 bir Media Services PlayReady lisans alma URL'si keyDeliveryTypeisteyin: {"keyDeliveryType":1}. İçeriğinizi zarf şifrelemesiyle koruyorsanız, için belirterek 2 bir anahtar alma URL'si isteyin: {"keyDeliveryType":2}.keyDeliveryType

Yöntem İstek URI'si HTTP Sürümü
POST <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys>('ContentkeyId')/GetKeyDeliveryUrl HTTP/1.1

Örnek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz. Örnek PlayReady lisans alma URL'sini alır.

İstek üst bilgileri:

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

İstek gövdesi:

{"keyDeliveryType":1}

Başarılı olursa, bu işlem 200 Tamam durum kodunu ve belirtilen URL'yi döndürür. Örneğin: https://account001.keydelivery.mediaservices.windows.net/PlayReady/.

İçerik Tuşlarını Listele

ContentKey'ler GET HTTP isteği kullanılarak alınır.

Yöntem İstek URI'si HTTP Sürümü
GET <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys> HTTP/1.1
Yöntem İstek URI'si HTTP Sürümü
GET <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys>('contentkeyid') HTTP/1.1
Yöntem İstek URI'si HTTP Sürümü
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/ContentKeys HTTP/1.1

Örnek İstek

En son x-ms-version:sürümü edinmek için bkz. 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

ContentKey silme

ContentKeys bir DELETE HTTP isteği aracılığıyla silinir.

Yöntem İstek URI'si HTTP Sürümü
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys>('contentkeyid') HTTP/1.1

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. 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

Ayrıca Bkz.

AccessPolicy
Varlık
AssetFile
İş
JobTemplate
Konumlandırıcı
MediaProcessor
Görev
Görev Şablonu
Kotalar ve Sınırlamalar