ContentKey
本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

ContentKey

 

ContentKey 提供資產安全存取。 除了建立 ContentKey 實體,您也必須使用保護金鑰來加密您產生的內容金鑰。 如需擷取保護金鑰的詳細資訊,請參閱 加密資產 (選擇性) 和 REST API 函式

本主題概述 ContentKey 實體同時也會示範如何執行各種作業使用媒體服務 REST API。

System_CAPS_important重要事項

當使用媒體服務 REST API,適用下列考量:

  • 中存取實體時 媒體服務, ,您必須在 HTTP 要求中設定特定的標頭欄位和值。 如需詳細資訊,請參閱 媒體服務 REST API 開發設定。

  • 順利連接到 https://media.windows.net 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

    如需詳細資訊,請參閱 連線到媒體服務 REST api 的媒體服務。

property

型別

描述

Id

必要的。 此值不由設定 媒體服務。

Edm.String

使用者定義的唯一識別碼。

Created

唯讀的。 設定 媒體服務 在建立時。

Edm.DateTime

這個值由設定 媒體服務 在建立時。

LastModified

唯讀的。 設定 媒體服務。

Edm.DateTime

這個值會由更新 媒體服務 任何屬性變更之後。

ContentKeyType

選擇性的。

Edm.Int32

指定內容金鑰類型的列舉值。 有效值為:

  • CommonEncryption = 0

  • StorageEncryption = 1

  • ConfigurationEncryption = 2

  • EnvelopeEncryption = 4

EncryptedContentKey

選擇性的。

Edm.String

使用 X.509 憑證的公開金鑰加密的內容金鑰。 最大長度為 4000。

Name

選擇性的。

Edm.String

ContentKey 的好記的名稱。 最大長度為 4000。

ProtectionKeyId

選擇性的。

Edm.String

用來加密儲存體、 一般加密或設定加密金鑰的 X.509 憑證的指紋。 呼叫 GetProtectionKeyId 函數時,這個值會傳回給您。 最大長度為 4000。

ProtectionKeyType

選擇性的。

Edm.Int32

列舉值,指定保護金鑰類型。 有效值為:

  • X509CertificateThumbprint = 0

Checksum

選擇性的。

Edm.String

ContentKey 的總和檢查碼。 最大長度為 4000。

AuthorizationPolicyId

Edm.String

授權原則識別碼與 ContentKey 相關聯。

可以使用 POST HTTP 要求建立 Contentkey。

方法

要求 URI

HTTP 版本

文章

https://media.windows.net/API/ContentKeys

HTTP/1.1

System_CAPS_important重要事項

順利連接到 https://media.windows.net 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

您可以嘗試下列範例中 Fiddlerhttp://www.telerik.com/download/fiddler的編輯器索引標籤。 請務必使用正確的重新導向的主機 URI 和授權承載 token 值。 如需詳細資訊,請參閱 連線到媒體服務 REST api 的媒體服務。

若要取得最新 x-ms-version:, ,請參閱 Azure Media Services REST API 參考

POST https://media.windows.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.11
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334276569&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=Cax61TKgo%2fLo5k6AWA%2brOLdAbMMd4poqvpVqiRPdTXk%3d
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=" }

取得指定的傳遞方法的內容金鑰的金鑰傳遞 URL。 用戶端會使用傳回的 URL 要求 AES 金鑰或 PlayReady 授權,以便播放受保護的內容。

指定要取得的 HTTP 要求主體中的 URL 類型。 如果您要保護使用 PlayReady,要求媒體服務 PlayReady 授權取得 URL,使用 1keyDeliveryType: {"keyDeliveryType":1} 如果您要保護您的內容使用信封加密,來要求金鑰取得 URL 指定 2keyDeliveryType: {"keyDeliveryType":2}

方法

要求 URI

HTTP 版本

文章

https://media.windows.net/api/ContentKeys('ContentkeyId')/GetKeyDeliveryUrl

HTTP/1.1

System_CAPS_important重要事項

順利連接到 https://media.windows.net 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

您可以嘗試下列範例中 Fiddlerhttp://www.telerik.com/download/fiddler的編輯器索引標籤。 此範例會取得 PlayReady 授權取得 URL。

請務必使用正確的重新導向的主機 URI 和授權承載 token 值。 如需詳細資訊,請參閱 連線到媒體服務 REST api 的媒體服務。

要求標頭:

POST https://media.windows.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 http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334276569&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=Cax61TKgo%2fLo5k6AWA%2brOLdAbMMd4poqvpVqiRPdTXk%3d
x-ms-version: 2.9
Content-Type: application/json
Host: media.windows.net
Content-Length: 21

要求本文:

{"keyDeliveryType":1}

如果成功,此作業會傳回 200 確定 狀態碼和指定的 URL。 例如 ︰ https://account001.keydelivery.mediaservices.windows.net/PlayReady/

Contentkey 是使用 GET HTTP 要求來擷取。

方法

要求 URI

HTTP 版本

取得

https://media.windows.net/API/ContentKeys

HTTP/1.1

方法

要求 URI

HTTP 版本

取得

https://media.windows.net/API/ContentKeys('contentkeyid')

HTTP/1.1

方法

要求 URI

HTTP 版本

取得

https://media.windows.net/API/Assets('assetid')/Contentkey

HTTP/1.1

System_CAPS_important重要事項

順利連接到 https://media.windows.net 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

您可以嘗試下列範例中 Fiddlerhttp://www.telerik.com/download/fiddler的編輯器索引標籤。 請務必使用正確的重新導向的主機 URI 和授權承載 token 值。 如需詳細資訊,請參閱 連線到媒體服務 REST api 的媒體服務。

若要取得最新 x-ms-version:, ,請參閱 Azure Media Services REST API 參考

GET https://media.windows.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.11
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334276569&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=Cax61TKgo%2fLo5k6AWA%2brOLdAbMMd4poqvpVqiRPdTXk%3d
Host: media.windows.net

Contentkey 會透過 DELETE HTTP 要求刪除。

方法

要求 URI

HTTP 版本

刪除

https://media.windows.net/API/ContentKeys('contentkeyid')

HTTP/1.1

System_CAPS_important重要事項

順利連接到 https://media.windows.net 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

您可以嘗試下列範例中 Fiddlerhttp://www.telerik.com/download/fiddler的編輯器索引標籤。

請務必使用正確的重新導向的主機 URI 和授權承載 token 值。 如需詳細資訊,請參閱 連線到媒體服務 REST api 的媒體服務。

若要取得最新 x-ms-version:, ,請參閱 Azure Media Services REST API 參考

DELETE https://media.windows.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.11
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337159050&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=Pq9NUjGajGnOXSZQphVl2UsHeCdrxRiWbxTSv5n6cPY%3d
Host: media.windows.net
Content-Length: 0


顯示:
© 2016 Microsoft