Content Key Policies - Get Policy Properties With Secrets

Ottenere criteri di chiave simmetrica con segreti
Ottenere un criterio di chiave simmetrica, inclusi i valori dei segreti

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/contentKeyPolicies/{contentKeyPolicyName}/getPolicyPropertiesWithSecrets?api-version=2022-08-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
accountName
path True

string

Nome dell'account di Servizi multimediali.

contentKeyPolicyName
path True

string

Nome del criterio della chiave simmetrica.

resourceGroupName
path True

string

Nome del gruppo di risorse all'interno della sottoscrizione di Azure.

subscriptionId
path True

string

Identificatore univoco per una sottoscrizione di Microsoft Azure.

api-version
query True

string

Versione dell'API da usare con la richiesta client.

Risposte

Nome Tipo Descrizione
200 OK

ContentKeyPolicyProperties

OK

Other Status Codes

ErrorResponse

Informazioni dettagliate sull'errore.

Esempio

Get an Content Key Policy with secrets

Sample Request

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/contentKeyPolicies/PolicyWithMultipleOptions/getPolicyPropertiesWithSecrets?api-version=2022-08-01

Sample Response

{
  "policyId": "ed7f3d1b-cfa7-4181-b966-e0b3027eec3a",
  "created": "2015-12-01T00:00:00Z",
  "lastModified": "2016-12-02T00:00:00Z",
  "description": "A policy with multiple options.",
  "options": [
    {
      "policyOptionId": "caf1e28c-8288-4301-8c46-c0f9312c512f",
      "configuration": {
        "@odata.type": "#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration"
      },
      "restriction": {
        "@odata.type": "#Microsoft.Media.ContentKeyPolicyTokenRestriction",
        "issuer": "http://testacs",
        "audience": "urn:test",
        "primaryVerificationKey": {
          "@odata.type": "#Microsoft.Media.ContentKeyPolicySymmetricTokenKey",
          "keyValue": "AAA="
        },
        "alternateVerificationKeys": [],
        "requiredClaims": [
          {
            "claimType": "urn:microsoft:azure:mediaservices:contentkeyidentifier"
          },
          {
            "claimType": "DRM",
            "claimValue": "Widevine"
          }
        ],
        "restrictionTokenType": "Jwt"
      }
    },
    {
      "policyOptionId": "da346259-0cd6-4609-89dc-15ac131bd92f",
      "configuration": {
        "@odata.type": "#Microsoft.Media.ContentKeyPolicyWidevineConfiguration",
        "widevineTemplate": "{\"allowed_track_types\":\"SD_HD\",\"content_key_specs\":[{\"track_type\":\"SD\",\"security_level\":1,\"required_output_protection\":{\"hdcp\":\"HDCP_V2\"}}],\"policy_overrides\":{\"can_play\":true,\"can_persist\":true,\"can_renew\":false}}"
      },
      "restriction": {
        "@odata.type": "#Microsoft.Media.ContentKeyPolicyOpenRestriction"
      }
    }
  ]
}

Definizioni

Nome Descrizione
ContentKeyPolicyClearKeyConfiguration

Rappresenta una configurazione per le chiavi non DRM.

ContentKeyPolicyFairPlayConfiguration

Specifica una configurazione per le licenze FairPlay.

ContentKeyPolicyFairPlayOfflineRentalConfiguration
ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Tipo di chiave di noleggio e lease.

ContentKeyPolicyOpenRestriction

Rappresenta una restrizione aperta. La licenza o la chiave verranno recapitate a ogni richiesta.

ContentKeyPolicyOption

Rappresenta un'opzione di criteri.

ContentKeyPolicyPlayReadyConfiguration

Specifica una configurazione per le licenze PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Specifica che l'ID chiave simmetrica si trova nell'intestazione PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Specifica che l'ID chiave simmetrica viene specificato nella configurazione PlayReady.

ContentKeyPolicyPlayReadyContentType

Tipo di contenuto PlayReady.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configura i bit del controllo Di restrizione esplicita dell'output di televisione analogica. Per altri dettagli, vedere Le regole di conformità PlayReady.

ContentKeyPolicyPlayReadyLicense

Licenza PlayReady

ContentKeyPolicyPlayReadyLicenseType

Tipo di licenza.

ContentKeyPolicyPlayReadyPlayRight

Configura Play Right nella licenza PlayReady.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Configura le impostazioni di gestione dell'output sconosciute della licenza.

ContentKeyPolicyProperties

Proprietà dei criteri della chiave simmetrica.

ContentKeyPolicyRestrictionTokenType

Tipo di token.

ContentKeyPolicyRsaTokenKey

Specifica una chiave RSA per la convalida del token

ContentKeyPolicySymmetricTokenKey

Specifica una chiave simmetrica per la convalida del token.

ContentKeyPolicyTokenClaim

Rappresenta un'attestazione di token.

ContentKeyPolicyTokenRestriction

Rappresenta una restrizione del token. Il token fornito deve corrispondere a questi requisiti per la corretta distribuzione di licenze o chiavi.

ContentKeyPolicyUnknownConfiguration

Rappresenta un oggetto ContentKeyPolicyConfiguration non disponibile nella versione dell'API corrente.

ContentKeyPolicyUnknownRestriction

Rappresenta un oggetto ContentKeyPolicyRestriction non disponibile nella versione dell'API corrente.

ContentKeyPolicyWidevineConfiguration

Specifica una configurazione per le licenze Widevine.

ContentKeyPolicyX509CertificateTokenKey

Specifica un certificato per la convalida del token.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

SecurityLevel

Livello di sicurezza.

ContentKeyPolicyClearKeyConfiguration

Rappresenta una configurazione per le chiavi non DRM.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration

Il discriminatorio per i tipi derivati.

ContentKeyPolicyFairPlayConfiguration

Specifica una configurazione per le licenze FairPlay.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Media.ContentKeyPolicyFairPlayConfiguration

Il discriminatorio per i tipi derivati.

ask

string

Chiave che deve essere usata come chiave privata dell'applicazione FairPlay. Deve essere codificato in base64.

fairPlayPfx

string

Rappresentazione base64 del certificato FairPlay in formato PKCS 12 (pfx) (inclusa la chiave privata).

fairPlayPfxPassword

string

Password che crittografa il certificato FairPlay in formato PKCS 12 (pfx).

offlineRentalConfiguration

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Criteri di noleggio offline

rentalAndLeaseKeyType

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Tipo di chiave di noleggio e lease.

rentalDuration

integer

Durata del noleggio. Deve essere maggiore o uguale a 0.

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Nome Tipo Descrizione
playbackDurationSeconds

integer

Durata riproduzione

storageDurationSeconds

integer

Durata dell'archiviazione

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Tipo di chiave di noleggio e lease.

Nome Tipo Descrizione
DualExpiry

string

Scadenza doppia per il noleggio offline.

PersistentLimited

string

La chiave simmetrica può essere persistente e la durata valida è limitata dal valore Durata noleggio

PersistentUnlimited

string

La chiave simmetrica può essere mantenuta con una durata illimitata

Undefined

string

La durata della chiave non è specificata.

Unknown

string

Rappresenta un oggetto ContentKeyPolicyFairPlayRentalAndLeaseKeyType non disponibile nella versione corrente dell'API.

ContentKeyPolicyOpenRestriction

Rappresenta una restrizione aperta. La licenza o la chiave verranno recapitate a ogni richiesta.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Media.ContentKeyPolicyOpenRestriction

Il discriminatorio per i tipi derivati.

ContentKeyPolicyOption

Rappresenta un'opzione di criteri.

Nome Tipo Descrizione
configuration ContentKeyPolicyConfiguration:

Configurazione del recapito delle chiavi.

name

string

Descrizione dell'opzione criteri.

policyOptionId

string

ID opzione criteri legacy.

restriction ContentKeyPolicyRestriction:

Requisiti che devono essere soddisfatti per recapitare le chiavi con questa configurazione

ContentKeyPolicyPlayReadyConfiguration

Specifica una configurazione per le licenze PlayReady.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyConfiguration

Il discriminatorio per i tipi derivati.

licenses

ContentKeyPolicyPlayReadyLicense[]

Licenze PlayReady.

responseCustomData

string

Dati di risposta personalizzati.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Specifica che l'ID chiave simmetrica si trova nell'intestazione PlayReady.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Il discriminatorio per i tipi derivati.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Specifica che l'ID chiave simmetrica viene specificato nella configurazione PlayReady.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Il discriminatorio per i tipi derivati.

keyId

string

ID chiave simmetrica.

ContentKeyPolicyPlayReadyContentType

Tipo di contenuto PlayReady.

Nome Tipo Descrizione
UltraVioletDownload

string

Tipo di contenuto di download ultravioletto.

UltraVioletStreaming

string

Tipo di contenuto streaming ultravioletto.

Unknown

string

Rappresenta un contentKeyPolicyPlayReadyContentType non disponibile nella versione dell'API corrente.

Unspecified

string

Tipo di contenuto non specificato.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configura i bit del controllo Di restrizione esplicita dell'output di televisione analogica. Per altri dettagli, vedere Le regole di conformità PlayReady.

Nome Tipo Descrizione
bestEffort

boolean

Indica se questa restrizione viene applicata in base al massimo sforzo.

configurationData

integer

Configura i bit del controllo delle restrizioni. Deve essere compreso tra 0 e 3 inclusi.

ContentKeyPolicyPlayReadyLicense

Licenza PlayReady

Nome Tipo Descrizione
allowTestDevices

boolean

Flag che indica se i dispositivi di test possono usare la licenza.

beginDate

string

Data di inizio della licenza

contentKeyLocation ContentKeyPolicyPlayReadyContentKeyLocation:

Percorso della chiave simmetrica.

contentType

ContentKeyPolicyPlayReadyContentType

Tipo di contenuto PlayReady.

expirationDate

string

Data di scadenza della licenza.

gracePeriod

string

Periodo di tolleranza della licenza.

licenseType

ContentKeyPolicyPlayReadyLicenseType

Tipo di licenza.

playRight

ContentKeyPolicyPlayReadyPlayRight

Licenza PlayRight

relativeBeginDate

string

Data di inizio relativa della licenza.

relativeExpirationDate

string

Data di scadenza relativa della licenza.

securityLevel

SecurityLevel

Livello di sicurezza.

ContentKeyPolicyPlayReadyLicenseType

Tipo di licenza.

Nome Tipo Descrizione
NonPersistent

string

Licenza non persistente.

Persistent

string

Licenza permanente. Consente la riproduzione offline.

Unknown

string

Rappresenta un contentKeyPolicyPlayReadyLicenseType non disponibile nella versione dell'API corrente.

ContentKeyPolicyPlayReadyPlayRight

Configura Play Right nella licenza PlayReady.

Nome Tipo Descrizione
agcAndColorStripeRestriction

integer

Configura Automatic Gain Control (AGC) e Color Stripe nella licenza. Deve essere compreso tra 0 e 3 inclusi.

allowPassingVideoContentToUnknownOutput

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Configura le impostazioni di gestione dell'output sconosciute della licenza.

analogVideoOpl

integer

Specifica il livello di protezione di output per l'audio digitale compresso.

compressedDigitalAudioOpl

integer

Specifica il livello di protezione di output per l'audio digitale compresso.

compressedDigitalVideoOpl

integer

Specifica il livello di protezione di output per il video digitale compresso.

digitalVideoOnlyContentRestriction

boolean

Abilita il vincolo di immagine per la restrizione video del componente analogico nella licenza.

explicitAnalogTelevisionOutputRestriction

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configura la restrizione esplicita dell'output televisivo analogico nella licenza. I dati di configurazione devono essere compresi tra 0 e 3 inclusi.

firstPlayExpiration

string

Periodo di tempo in cui la licenza è valida dopo la prima volta che la licenza viene usata per riprodurre il contenuto.

imageConstraintForAnalogComponentVideoRestriction

boolean

Abilita il vincolo di immagine per la restrizione video del componente analogico nella licenza.

imageConstraintForAnalogComputerMonitorRestriction

boolean

Abilita il vincolo di immagine per la restrizione video del componente analogico nella licenza.

scmsRestriction

integer

Configura il sistema di gestione della copia seriale (SCMS) nella licenza. Deve essere compreso tra 0 e 3 inclusi.

uncompressedDigitalAudioOpl

integer

Specifica il livello di protezione di output per l'audio digitale non compresso.

uncompressedDigitalVideoOpl

integer

Specifica il livello di protezione di output per il video digitale non compresso.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Configura le impostazioni di gestione dell'output sconosciute della licenza.

Nome Tipo Descrizione
Allowed

string

È consentito passare la parte video del contenuto protetto a un output sconosciuto.

AllowedWithVideoConstriction

string

Il passaggio della parte video del contenuto protetto a un output sconosciuto è consentito ma con risoluzione vincolata.

NotAllowed

string

Il passaggio della parte video del contenuto protetto a un output sconosciuto non è consentito.

Unknown

string

Rappresenta un oggetto ContentKeyPolicyPlayReadyUnknownOutputPassingOption non disponibile nella versione corrente dell'API.

ContentKeyPolicyProperties

Proprietà dei criteri della chiave simmetrica.

Nome Tipo Descrizione
created

string

Data di creazione dei criteri

description

string

Descrizione dei criteri.

lastModified

string

Data dell'ultima modifica dei criteri

options

ContentKeyPolicyOption[]

Le opzioni dei criteri di chiave.

policyId

string

L'ID dei criteri legacy.

ContentKeyPolicyRestrictionTokenType

Tipo di token.

Nome Tipo Descrizione
Jwt

string

Token Web JSON.

Swt

string

Token Web semplice.

Unknown

string

Rappresenta un oggetto ContentKeyPolicyRestrictionTokenType non disponibile nella versione corrente dell'API.

ContentKeyPolicyRsaTokenKey

Specifica una chiave RSA per la convalida del token

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Media.ContentKeyPolicyRsaTokenKey

Il discriminatorio per i tipi derivati.

exponent

string

Esponente del parametro RSA

modulus

string

Modulo del parametro RSA

ContentKeyPolicySymmetricTokenKey

Specifica una chiave simmetrica per la convalida del token.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Media.ContentKeyPolicySymmetricTokenKey

Il discriminatorio per i tipi derivati.

keyValue

string

Valore della chiave

ContentKeyPolicyTokenClaim

Rappresenta un'attestazione di token.

Nome Tipo Descrizione
claimType

string

Tipo di attestazione del token.

claimValue

string

Valore attestazione token.

ContentKeyPolicyTokenRestriction

Rappresenta una restrizione del token. Il token fornito deve corrispondere a questi requisiti per la corretta distribuzione di licenze o chiavi.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Media.ContentKeyPolicyTokenRestriction

Il discriminatorio per i tipi derivati.

alternateVerificationKeys ContentKeyPolicyRestrictionTokenKey[]:

Elenco di chiavi di verifica alternative.

audience

string

Destinatari del token.

issuer

string

Autorità emittente del token.

openIdConnectDiscoveryDocument

string

Documento di individuazione della connessione OpenID.

primaryVerificationKey ContentKeyPolicyRestrictionTokenKey:

Chiave di verifica primaria.

requiredClaims

ContentKeyPolicyTokenClaim[]

Elenco delle attestazioni di token necessarie.

restrictionTokenType

ContentKeyPolicyRestrictionTokenType

Tipo di token.

ContentKeyPolicyUnknownConfiguration

Rappresenta un oggetto ContentKeyPolicyConfiguration non disponibile nella versione dell'API corrente.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownConfiguration

Il discriminatorio per i tipi derivati.

ContentKeyPolicyUnknownRestriction

Rappresenta un oggetto ContentKeyPolicyRestriction non disponibile nella versione dell'API corrente.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownRestriction

Il discriminatorio per i tipi derivati.

ContentKeyPolicyWidevineConfiguration

Specifica una configurazione per le licenze Widevine.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Media.ContentKeyPolicyWidevineConfiguration

Il discriminatorio per i tipi derivati.

widevineTemplate

string

Modello Widevine.

ContentKeyPolicyX509CertificateTokenKey

Specifica un certificato per la convalida del token.

Nome Tipo Descrizione
@odata.type string:

#Microsoft.Media.ContentKeyPolicyX509CertificateTokenKey

Il discriminatorio per i tipi derivati.

rawBody

string

Campo dati non elaborato di un certificato in formato PKCS 12 (X509Certificate2 in .NET)

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

SecurityLevel

Livello di sicurezza.

Nome Tipo Descrizione
SL150

string

Per i client in fase di sviluppo o test. Nessuna protezione da usi non autorizzati.

SL2000

string

Per dispositivi e applicazioni con protezione avanzata che utilizzano contenuto commerciale. Protezione software o hardware.

SL3000

string

Solo per i dispositivi con protezione avanzata. Protezione hardware.

Unknown

string

Rappresenta un securityLevel non disponibile nella versione dell'API corrente.