Sdílet prostřednictvím


Content Key Policies - Get Policy Properties With Secrets

Získání zásad klíče obsahu s tajnými kódy
Získání zásad klíče obsahu včetně hodnot tajných kódů

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
accountName
path True

string

Název účtu služby Media Services.

contentKeyPolicyName
path True

string

Název zásady klíče obsahu.

resourceGroupName
path True

string

Název skupiny prostředků v rámci předplatného Azure.

subscriptionId
path True

string

Jedinečný identifikátor předplatného Microsoft Azure.

api-version
query True

string

Verze rozhraní API, která se má použít s žádostí klienta.

Odpovědi

Name Typ Description
200 OK

ContentKeyPolicyProperties

OK

Other Status Codes

ErrorResponse

Podrobné informace o chybě

Příklady

Get an Content Key Policy with secrets

Ukázkový požadavek

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

Ukázková odpověď

{
  "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"
      }
    }
  ]
}

Definice

Name Description
ContentKeyPolicyClearKeyConfiguration

Představuje konfiguraci pro klíče jiné než DRM.

ContentKeyPolicyFairPlayConfiguration

Určuje konfiguraci licencí FairPlay.

ContentKeyPolicyFairPlayOfflineRentalConfiguration
ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Typ klíče pro pronájem a zapůjčení.

ContentKeyPolicyOpenRestriction

Představuje otevřené omezení. Licence nebo klíč se doručí při každé žádosti.

ContentKeyPolicyOption

Představuje možnost zásad.

ContentKeyPolicyPlayReadyConfiguration

Určuje konfiguraci licencí PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Určuje, že ID klíče obsahu je v hlavičce PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Určuje, že ID klíče obsahu je zadáno v konfiguraci PlayReady.

ContentKeyPolicyPlayReadyContentType

Typ obsahu PlayReady.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Konfiguruje bity ovládacího prvku Explicit Analog Television Output Restriction. Další podrobnosti najdete v tématu Pravidla dodržování předpisů PlayReady.

ContentKeyPolicyPlayReadyLicense

Licence PlayReady

ContentKeyPolicyPlayReadyLicenseType

Typ licence.

ContentKeyPolicyPlayReadyPlayRight

Nakonfiguruje v licenci PlayReady možnost Přehrát vpravo.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Nakonfiguruje nastavení neznámého zpracování výstupu licence.

ContentKeyPolicyProperties

Vlastnosti zásad klíče obsahu.

ContentKeyPolicyRestrictionTokenType

Typ tokenu.

ContentKeyPolicyRsaTokenKey

Určuje klíč RSA pro ověření tokenu.

ContentKeyPolicySymmetricTokenKey

Určuje symetrický klíč pro ověření tokenu.

ContentKeyPolicyTokenClaim

Představuje deklaraci identity tokenu.

ContentKeyPolicyTokenRestriction

Představuje omezení tokenu. Zadaný token musí splňovat tyto požadavky pro úspěšné doručení licence nebo klíče.

ContentKeyPolicyUnknownConfiguration

Představuje ContentKeyPolicyConfiguration, která není k dispozici v aktuální verzi rozhraní API.

ContentKeyPolicyUnknownRestriction

Představuje ContentKeyPolicyRestriction, která není k dispozici v aktuální verzi rozhraní API.

ContentKeyPolicyWidevineConfiguration

Určuje konfiguraci licencí Widevine.

ContentKeyPolicyX509CertificateTokenKey

Určuje certifikát pro ověření tokenu.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě.

ErrorResponse

Odpověď na chybu

SecurityLevel

Úroveň zabezpečení.

ContentKeyPolicyClearKeyConfiguration

Představuje konfiguraci pro klíče jiné než DRM.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration

Diskriminátor pro odvozené typy.

ContentKeyPolicyFairPlayConfiguration

Určuje konfiguraci licencí FairPlay.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyFairPlayConfiguration

Diskriminátor pro odvozené typy.

ask

string

Klíč, který se musí použít jako tajný klíč aplikace FairPlay. To musí být zakódované base64.

fairPlayPfx

string

Reprezentace certifikátu FairPlay v Base64 ve formátu PKCS 12 (pfx) (včetně privátního klíče).

fairPlayPfxPassword

string

Heslo šifrující certifikát FairPlay ve formátu PKCS 12 (pfx).

offlineRentalConfiguration

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Zásady offline pronájmu

rentalAndLeaseKeyType

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Typ klíče pro pronájem a zapůjčení.

rentalDuration

integer

Doba trvání pronájmu. Musí být větší než nebo rovno 0.

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Name Typ Description
playbackDurationSeconds

integer

Doba trvání přehrávání

storageDurationSeconds

integer

Doba trvání úložiště

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Typ klíče pro pronájem a zapůjčení.

Name Typ Description
DualExpiry

string

Duální vypršení platnosti pro offline pronájem.

PersistentLimited

string

Klíč obsahu je možné zachovat a platná doba trvání je omezená hodnotou Doba pronájmu.

PersistentUnlimited

string

Klíč obsahu je možné zachovat s neomezenou dobou trvání.

Undefined

string

Doba trvání klíče není zadána.

Unknown

string

Představuje ContentKeyPolicyFairPlayRentalAndLeaseKeyType, který není k dispozici v aktuální verzi rozhraní API.

ContentKeyPolicyOpenRestriction

Představuje otevřené omezení. Licence nebo klíč se doručí při každé žádosti.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyOpenRestriction

Diskriminátor pro odvozené typy.

ContentKeyPolicyOption

Představuje možnost zásad.

Name Typ Description
configuration ContentKeyPolicyConfiguration:

Konfigurace doručování klíčů.

name

string

Popis možnosti zásad

policyOptionId

string

ID možnosti starší verze zásad.

restriction ContentKeyPolicyRestriction:

Požadavky, které musí být splněny pro doručování klíčů s touto konfigurací

ContentKeyPolicyPlayReadyConfiguration

Určuje konfiguraci licencí PlayReady.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyConfiguration

Diskriminátor pro odvozené typy.

licenses

ContentKeyPolicyPlayReadyLicense[]

Licence PlayReady.

responseCustomData

string

Vlastní data odpovědi.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Určuje, že ID klíče obsahu je v hlavičce PlayReady.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Diskriminátor pro odvozené typy.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Určuje, že ID klíče obsahu je zadáno v konfiguraci PlayReady.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Diskriminátor pro odvozené typy.

keyId

string

ID klíče obsahu.

ContentKeyPolicyPlayReadyContentType

Typ obsahu PlayReady.

Name Typ Description
UltraVioletDownload

string

Ultrafialový typ obsahu ke stažení.

UltraVioletStreaming

string

Typ ultrafialového streamovaného obsahu.

Unknown

string

Představuje ContentKeyPolicyPlayReadyContentType, který není k dispozici v aktuální verzi rozhraní API.

Unspecified

string

Nespecifikovaný typ obsahu.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Konfiguruje bity ovládacího prvku Explicit Analog Television Output Restriction. Další podrobnosti najdete v tématu Pravidla dodržování předpisů PlayReady.

Name Typ Description
bestEffort

boolean

Určuje, zda je toto omezení vynuceno na základě maximálního úsilí.

configurationData

integer

Konfiguruje bity řízení omezení. Musí být mezi 0 a 3 včetně.

ContentKeyPolicyPlayReadyLicense

Licence PlayReady

Name Typ Description
allowTestDevices

boolean

Příznak označující, jestli testovací zařízení můžou licenci používat.

beginDate

string

Počáteční datum licence

contentKeyLocation ContentKeyPolicyPlayReadyContentKeyLocation:

Umístění klíče obsahu.

contentType

ContentKeyPolicyPlayReadyContentType

Typ obsahu PlayReady.

expirationDate

string

Datum vypršení platnosti licence.

gracePeriod

string

Období odkladu licence.

licenseType

ContentKeyPolicyPlayReadyLicenseType

Typ licence.

playRight

ContentKeyPolicyPlayReadyPlayRight

Licence PlayRight

relativeBeginDate

string

Relativní počáteční datum licence.

relativeExpirationDate

string

Relativní datum vypršení platnosti licence.

securityLevel

SecurityLevel

Úroveň zabezpečení.

ContentKeyPolicyPlayReadyLicenseType

Typ licence.

Name Typ Description
NonPersistent

string

Netrvání licence.

Persistent

string

Trvalá licence. Umožňuje offline přehrávání.

Unknown

string

Představuje ContentKeyPolicyPlayReadyLicenseType, který není k dispozici v aktuální verzi rozhraní API.

ContentKeyPolicyPlayReadyPlayRight

Nakonfiguruje v licenci PlayReady možnost Přehrát vpravo.

Name Typ Description
agcAndColorStripeRestriction

integer

Nakonfiguruje automatické řízení získání (AGC) a barevný pruh v licenci. Musí být mezi 0 a 3 včetně.

allowPassingVideoContentToUnknownOutput

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Nakonfiguruje nastavení neznámého zpracování výstupu licence.

analogVideoOpl

integer

Určuje úroveň ochrany výstupu pro komprimovaný digitální zvuk.

compressedDigitalAudioOpl

integer

Určuje úroveň ochrany výstupu pro komprimovaný digitální zvuk.

compressedDigitalVideoOpl

integer

Určuje úroveň ochrany výstupu pro komprimované digitální video.

digitalVideoOnlyContentRestriction

boolean

Povolí omezení obrázku pro analogovou komponentu Video Omezení v licenci.

explicitAnalogTelevisionOutputRestriction

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Nakonfiguruje omezení explicitního výstupu analogové televize v licenci. Konfigurační data musí být mezi 0 a 3 včetně.

firstPlayExpiration

string

Doba, po kterou je licence platná po prvním použití licence k přehrávání obsahu.

imageConstraintForAnalogComponentVideoRestriction

boolean

Povolí omezení obrázku pro analogovou komponentu Video Omezení v licenci.

imageConstraintForAnalogComputerMonitorRestriction

boolean

Povolí omezení obrázku pro analogovou komponentu Video Omezení v licenci.

scmsRestriction

integer

Nakonfiguruje systém správy sériového kopírování (SCMS) v licenci. Musí být mezi 0 a 3 včetně.

uncompressedDigitalAudioOpl

integer

Určuje úroveň ochrany výstupu pro nekomprimovaný digitální zvuk.

uncompressedDigitalVideoOpl

integer

Určuje úroveň ochrany výstupu pro nekomprimované digitální video.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Nakonfiguruje nastavení neznámého zpracování výstupu licence.

Name Typ Description
Allowed

string

Předání části chráněného obsahu videa neznámému výstupu je povoleno.

AllowedWithVideoConstriction

string

Předání části chráněného obsahu videa neznámému výstupu je povoleno, ale s omezeným rozlišením.

NotAllowed

string

Předání části chráněného obsahu videa neznámému výstupu není povoleno.

Unknown

string

Představuje ContentKeyPolicyPlayReadyUnknownOutputPassingOption, který není k dispozici v aktuální verzi rozhraní API.

ContentKeyPolicyProperties

Vlastnosti zásad klíče obsahu.

Name Typ Description
created

string

Datum vytvoření zásady

description

string

Popis zásad.

lastModified

string

Datum poslední změny zásad

options

ContentKeyPolicyOption[]

Možnosti klíčových zásad.

policyId

string

ID starších zásad.

ContentKeyPolicyRestrictionTokenType

Typ tokenu.

Name Typ Description
Jwt

string

Webový token JSON.

Swt

string

Jednoduchý webový token.

Unknown

string

Představuje ContentKeyPolicyRestrictionTokenType, který není k dispozici v aktuální verzi rozhraní API.

ContentKeyPolicyRsaTokenKey

Určuje klíč RSA pro ověření tokenu.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyRsaTokenKey

Diskriminátor pro odvozené typy.

exponent

string

Exponent parametru RSA

modulus

string

Modul parametrů RSA

ContentKeyPolicySymmetricTokenKey

Určuje symetrický klíč pro ověření tokenu.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicySymmetricTokenKey

Diskriminátor pro odvozené typy.

keyValue

string

Hodnota klíče

ContentKeyPolicyTokenClaim

Představuje deklaraci identity tokenu.

Name Typ Description
claimType

string

Typ deklarace identity tokenu

claimValue

string

Hodnota deklarace identity tokenu.

ContentKeyPolicyTokenRestriction

Představuje omezení tokenu. Zadaný token musí splňovat tyto požadavky pro úspěšné doručení licence nebo klíče.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyTokenRestriction

Diskriminátor pro odvozené typy.

alternateVerificationKeys ContentKeyPolicyRestrictionTokenKey[]:

Seznam alternativních ověřovacích klíčů.

audience

string

Cílová skupina tokenu.

issuer

string

Vystavitel tokenu.

openIdConnectDiscoveryDocument

string

Dokument zjišťování OpenID connect

primaryVerificationKey ContentKeyPolicyRestrictionTokenKey:

Primární ověřovací klíč.

requiredClaims

ContentKeyPolicyTokenClaim[]

Seznam požadovaných deklarací identity tokenů

restrictionTokenType

ContentKeyPolicyRestrictionTokenType

Typ tokenu.

ContentKeyPolicyUnknownConfiguration

Představuje ContentKeyPolicyConfiguration, která není k dispozici v aktuální verzi rozhraní API.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownConfiguration

Diskriminátor pro odvozené typy.

ContentKeyPolicyUnknownRestriction

Představuje ContentKeyPolicyRestriction, která není k dispozici v aktuální verzi rozhraní API.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownRestriction

Diskriminátor pro odvozené typy.

ContentKeyPolicyWidevineConfiguration

Určuje konfiguraci licencí Widevine.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyWidevineConfiguration

Diskriminátor pro odvozené typy.

widevineTemplate

string

Šablona Widevine.

ContentKeyPolicyX509CertificateTokenKey

Určuje certifikát pro ověření tokenu.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyX509CertificateTokenKey

Diskriminátor pro odvozené typy.

rawBody

string

Nezpracované datové pole certifikátu ve formátu PKCS 12 (X509Certificate2 v .NET)

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě

code

string

Kód chyby

details

ErrorDetail[]

Podrobnosti o chybě

message

string

Chybová zpráva

target

string

Cíl chyby.

ErrorResponse

Odpověď na chybu

Name Typ Description
error

ErrorDetail

Objekt chyby.

SecurityLevel

Úroveň zabezpečení.

Name Typ Description
SL150

string

Pro klienty ve vývoji nebo testování. Žádná ochrana proti neoprávněnému použití.

SL2000

string

Pro posílená zařízení a aplikace využívající komerční obsah. Ochrana softwaru nebo hardwaru.

SL3000

string

Pouze pro posílená zařízení. Ochrana hardwaru.

Unknown

string

Představuje úroveň zabezpečení, která není k dispozici v aktuální verzi rozhraní API.