Exporter (0) Imprimer
Développer tout

ContentKey

Mis à jour: février 2015

Une ContentKey offre un accès sécurisé à un élément multimédia. Outre la création d'une entité ContentKey, vous devez également utiliser une clé de protection pour chiffrer la clé de contenu que vous générez. Pour plus d'informations sur la récupération de la clé de protection, consultez Encrypt the Asset (Optional) et Fonctions de l'API REST.

Cette rubrique offre une vue d'ensemble de l'entité ContentKey, et montre comment exécuter diverses opérations avec l'API REST Media Services.

ImportantImportant
Lors de l'utilisation de l'API REST Media Services, vous devez prendre en considération les aspects suivants :

 

Propriété Type Description

Id

Obligatoire. Cette valeur n'est pas définie par Media Services.

Edm.String

Identificateur unique défini par l'utilisateur.

Created

Lecture seule. Définie par Media Services lors de la création.

Edm.DateTime

Cette valeur est définie par Media Services lors de la création.

LastModified

Lecture seule. Définie par Media Services.

Edm.DateTime

Cette valeur est mise à jour par Media Services suite à la modification d'une propriété.

ContentKeyType

Facultatif.

Edm.Int32

Valeur d'énumération spécifiant le type de la clé de contenu. Les valeurs valides sont les suivantes :

  • CommonEncryption = 0

  • StorageEncryption = 1

  • ConfigurationEncryption = 2

  • EnvelopeEncryption = 4

EncryptedContentKey

Facultatif.

Edm.String

Clé de contenu chiffrée avec la clé publique du certificat X.509. La longueur maximale est 4000.

Name

Facultatif.

Edm.String

Nom convivial de votre ContentKey. La longueur maximale est 4000.

ProtectionKeyId

Facultatif.

Edm.String

Empreinte du certificat X.509 utilisée pour chiffrer les clés de stockage, de chiffrement commun ou de chiffrement de la configuration. Cette valeur est renvoyée lors de l'appel de la fonction GetProtectionKeyId. La longueur maximale est 4000.

ProtectionKeyType

Facultatif.

Edm.Int32

Valeur d'énumération spécifiant le type de la clé de protection. Les valeurs valides sont les suivantes :

  • X509CertificateThumbprint = 0

Checksum

Facultatif.

Edm.String

Somme de contrôle de la ContentKey. La longueur maximale est 4000.

AuthorizationPolicyId

Edm.String

La stratégie d'autorisation est associée à la ContentKey.

Les ContentKeys peuvent être créées à l'aide d'une requête HTTP POST.

 

Méthode URI de demande Version HTTP

POST

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

HTTP/1.1

ImportantImportant
Après vous être connecté à https://media.windows.net, vous recevrez une redirection 301 spécifiant un autre URI de Media Services. Vous devrez passer des appels suivants au nouvel URI.

Vous pouvez essayer l'exemple suivant sous l'onglet Composer de Fiddler.

Veillez à utiliser des valeurs valides de jeton d'URI de l'hôte redirigé et de support d'autorisation. Pour plus d'informations, consultez Connecting to Media Services with the 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.7
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=" }

Obtient l'URL de fourniture de clé pour le mode de livraison spécifié pour la clé de contenu. Un client utilise l'URL renvoyée pour demander une clé AES ou une licence PlayReady afin de lire le contenu protégé.

Spécifiez le type de l'URL à obtenir dans le corps de la demande HTTP. Si vous protégez votre contenu avec PlayReady, demandez une URL d'acquisition de licence PlayReady de Media Services, en utilisant 1 pour keyDeliveryType : {"keyDeliveryType":1}. Si vous protégez votre contenu avec le chiffrement d'enveloppe, demandez une URL d'acquisition de clé en spécifiant 2 pour keyDeliveryType : {"keyDeliveryType":2}.

 

Méthode URI de demande Version HTTP

POST

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

HTTP/1.1

ImportantImportant
Après vous être connecté à https://media.windows.net, vous recevrez une redirection 301 spécifiant un autre URI de Media Services. Vous devrez passer des appels suivants au nouvel URI.

Vous pouvez essayer l'exemple suivant sous l'onglet Composer de Fiddler. L'exemple obtient l'URL d'acquisition de licence PlayReady.

Veillez à utiliser des valeurs valides de jeton d'URI de l'hôte redirigé et de support d'autorisation. Pour plus d'informations, consultez Connecting to Media Services with the Media Services REST API.

En-têtes de la requête :

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.7
Content-Type: application/json
Host: media.windows.net
Content-Length: 21

Corps de la requête :

{"keyDeliveryType":1}

Si elle est réussie, cette opération renvoie un code d'état 200 OK et l'URL spécifiée. Par exemple : https://account001.keydelivery.mediaservices.windows.net/PlayReady/.

Les ContentKeys sont récupérées à l'aide d'une requête HTTP GET.

 

Méthode URI de demande Version HTTP

GET

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

HTTP/1.1

 

Méthode URI de demande Version HTTP

GET

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

HTTP/1.1

 

Méthode URI de demande Version HTTP

GET

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

HTTP/1.1

ImportantImportant
Après vous être connecté à https://media.windows.net, vous recevrez une redirection 301 spécifiant un autre URI de Media Services. Vous devrez passer des appels suivants au nouvel URI.

Vous pouvez essayer l'exemple suivant sous l'onglet Composer de Fiddler.

Veillez à utiliser des valeurs valides de jeton d'URI de l'hôte redirigé et de support d'autorisation. Pour plus d'informations, consultez Connecting to Media Services with the 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.7
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

Les ContentKeys sont supprimées à l'aide d'une requête HTTP DELETE.

 

Méthode URI de demande Version HTTP

SUPPRIMER

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

HTTP/1.1

ImportantImportant
Après vous être connecté à https://media.windows.net, vous recevrez une redirection 301 spécifiant un autre URI de Media Services. Vous devrez passer des appels suivants au nouvel URI.

Vous pouvez essayer l'exemple suivant sous l'onglet Composer de Fiddler.

Veillez à utiliser des valeurs valides de jeton d'URI de l'hôte redirigé et de support d'autorisation. Pour plus d'informations, consultez Connecting to Media Services with the 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.7
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


Voir aussi

Afficher:
© 2015 Microsoft