Partager via

ContentKey

  • Article

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 Chiffrer les fonctions de l’élément multimédia (facultatif) et 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.

Important

Lors de l’accès aux entités dans Media Services, vous devez définir les valeurs et les champs d’en-tête spécifiques dans vos requêtes HTTP.
Pour plus d’informations, consultez Configuration du développement de l’API REST Media Services et Connexion à Media Services avec l’API REST Media Services.

Propriétés de l'entité ContentKey

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éfini par Media Services au moment de la création.		 Edm.DateTime Cette valeur est définie par Media Services au moment de la création.
LastModified

Lecture seule. Défini par Media Services.		 Edm.DateTime Cette valeur est mise à jour par Media Services une fois que des modifications de propriété ont été apportées.
ContentKeyType

Optionnel.		 Edm.Int32 Valeur d'énumération spécifiant le type de la clé de contenu. Les valeurs autorisées sont :

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

Optionnel.		 Edm.String Clé de contenu chiffrée avec la clé publique du certificat X.509. La longueur maximale est de 4 000.
Name

Optionnel.		 Edm.String Nom convivial de votre ContentKey. La longueur maximale est de 4 000.
ProtectionKeyId

Optionnel.		 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 de 4 000.
ProtectionKeyType

Optionnel.		 Edm.Int32 Valeur d'énumération spécifiant le type de la clé de protection. Les valeurs autorisées sont :

- X509CertificateThumbprint = 0
Checksum

Optionnel.		 Edm.String Somme de contrôle de la ContentKey. La longueur maximale est de 4 000.
AuthorizationPolicyId Edm.String La stratégie d'autorisation est associée à la ContentKey.

Création d'une ContentKey

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

Méthode URI de demande Version HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys> HTTP/1.1

Exemple de demande

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

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

Obtenir l'URL de fourniture de clé

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

Spécifiez le type d’URL à obtenir dans le corps de la demande HTTP. Si vous protégez votre contenu avec PlayReady, demandez une URL d’acquisition de licence Media Services PlayReady, 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:// accountname.restv2>.<location.media.azure.net/api/ContentKeys>('ContentkeyId')/GetKeyDeliveryUrl HTTP/1.1

Exemple

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

En-têtes de requête :

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

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/.

Liste des ContentKeys

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

Méthode URI de demande Version HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys> HTTP/1.1
Méthode URI de demande Version HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys>('contentkeyid') HTTP/1.1
Méthode URI de demande Version HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/ContentKeys HTTP/1.1

Exemple de demande

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

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

Suppression d'une ContentKey

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

Méthode URI de demande Version HTTP
Suppression <https:// accountname.restv2>.<location.media.azure.net/api/ContentKeys>('contentkeyid') HTTP/1.1

Exemple de demande

Vous pouvez essayer l’exemple suivant sous l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

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

Voir aussi

AccessPolicy
Asset
AssetFile
Travail
JobTemplate
Locator
MediaProcessor
Tâche
TaskTemplate
Quotas et limitations