ContentKey
Un'entità ContentKey corrisponde a una chiave simmetrica e garantisce l'accesso sicuro a un asset. Oltre a creare un'entità ContentKey, è necessario utilizzare una chiave di protezione per crittografare la chiave simmetrica generata. Per ulteriori informazioni sul recupero della chiave di protezione, vedere Encrypt the Asset (Optional) e Funzioni dell'API REST.
Importante |
|---|
| Quando si accede alle entità in Windows Azure Media Services, è necessario impostare campi e valori di intestazione specifici nelle richieste HTTP. Per ulteriori informazioni, vedere Configurazione per lo sviluppo con API REST di Media Services. |
Importante |
|---|
| Dopo avere stabilito la connessione a https://media.windows.net, si riceverà un reindirizzamento 301 che indica un altro URI di servizi multimediali. Le chiamate successive devono essere effettuate al nuovo URI. |
Proprietà dell'entità ContentKey
| Proprietà | Tipo | Descrizione |
|---|---|---|
|
Id |
Edm.String |
Obbligatoria. Identificatore univoco definito dall'utente. Questo valore non viene impostato da Media Services. |
|
Created |
Edm.DateTime |
Questo valore viene impostato da Media Services durante la creazione. |
|
LastModified |
Edm.DateTime |
Questo valore viene aggiornato da Media Services dopo che è stata apportata una qualsiasi modifica alla proprietà. |
|
ContentKeyType |
Edm.Int32 |
Obbligatoria. Valore di enumerazione che specifica il tipo di chiave simmetrica. I valori validi sono i seguenti:
|
|
EncryptedContentKey |
Edm.String |
Obbligatoria. Chiave simmetrica crittografata con la chiave pubblica del certificato X.509. |
|
Name |
Edm.String |
Facoltativa. Nome descrittivo dell'entità ContentKey. |
|
ProtectionKeyId |
Edm.String |
Identificazione personale del certificato X.509 utilizzato per crittografare le chiavi di crittografia di archiviazione, di crittografia comune o di crittografia di configurazione. Questo valore viene restituito quando viene chiamata la funzione GetProtectionKeyId. |
|
ProtectionKeyType |
Edm.Int32 |
Valore di enumerazione che specifica il tipo di chiave di protezione. I valori validi sono i seguenti:
|
|
Checksum |
Edm.String |
Checksum dell'entità ContentKey. |
Creare un'entità ContentKey
Le entità ContentKey possono essere create utilizzando una richiesta HTTP POST.
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
|
POST |
https://media.windows.net/API/ContentKeys |
HTTP/1.1 |
Richiesta di esempio
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.0
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=" }
Elencare le entità ContentKey
Le entità ContentKey vengono recuperate utilizzando una richiesta HTTP GET.
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
|
GET |
https://media.windows.net/API/ContentKeys |
HTTP/1.1 |
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
|
GET |
https://media.windows.net/API/ContentKeys('idchiavesimmetrica') |
HTTP/1.1 |
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
|
GET |
https://media.windows.net/API/Assets('idasset')/ContentKeys |
HTTP/1.1 |
Richiesta di esempio
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.0
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
Eliminare un'entità ContentKey
Le entità ContentKey vengono eliminate mediante una richiesta HTTP DELETE.
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
|
DELETE |
https://media.windows.net/API/ContentKeys('idchiavesimmetrica') |
HTTP/1.1 |
Richiesta di esempio
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.0
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
Vedere anche
Data di compilazione:
Importante