Freigeben über


Content Key Policies - Get Policy Properties With Secrets

Abrufen einer Inhaltsschlüsselrichtlinie mit Geheimnissen
Abrufen einer Inhaltsschlüsselrichtlinie einschließlich Geheimniswerten

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
accountName
path True

string

Der Name des Media Services-Kontos.

contentKeyPolicyName
path True

string

Der Name der Inhaltsschlüsselrichtlinie.

resourceGroupName
path True

string

Der Name der Ressourcengruppe innerhalb des Azure-Abonnements.

subscriptionId
path True

string

Der eindeutige Bezeichner für ein Microsoft Azure-Abonnement.

api-version
query True

string

Die Version der API, die mit der Clientanforderung verwendet werden soll.

Antworten

Name Typ Beschreibung
200 OK

ContentKeyPolicyProperties

OK

Other Status Codes

ErrorResponse

Ausführliche Fehlerinformationen.

Beispiele

Get an Content Key Policy with secrets

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
ContentKeyPolicyClearKeyConfiguration

Stellt eine Konfiguration für Nicht-DRM-Schlüssel dar.

ContentKeyPolicyFairPlayConfiguration

Gibt eine Konfiguration für FairPlay-Lizenzen an.

ContentKeyPolicyFairPlayOfflineRentalConfiguration
ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Der Miet- und Leaseschlüsseltyp.

ContentKeyPolicyOpenRestriction

Stellt eine offene Einschränkung dar. Die Lizenz oder der Schlüssel wird bei jeder Anforderung übermittelt.

ContentKeyPolicyOption

Stellt eine Richtlinienoption dar.

ContentKeyPolicyPlayReadyConfiguration

Gibt eine Konfiguration für PlayReady-Lizenzen an.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Gibt an, dass sich die Inhaltsschlüssel-ID im PlayReady-Header befindet.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Gibt an, dass die Inhaltsschlüssel-ID in der PlayReady-Konfiguration angegeben wird.

ContentKeyPolicyPlayReadyContentType

Der PlayReady-Inhaltstyp.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Konfiguriert die Steuerungsbits für explizite Analogfernsehenausgänge. Weitere Informationen finden Sie in den PlayReady-Complianceregeln.

ContentKeyPolicyPlayReadyLicense

Die PlayReady-Lizenz

ContentKeyPolicyPlayReadyLicenseType

Der Lizenztyp.

ContentKeyPolicyPlayReadyPlayRight

Konfiguriert das Play Right in der PlayReady-Lizenz.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Konfiguriert unbekannte Ausgabebehandlungseinstellungen der Lizenz.

ContentKeyPolicyProperties

Die Eigenschaften der Inhaltsschlüsselrichtlinie.

ContentKeyPolicyRestrictionTokenType

Der Tokentyp.

ContentKeyPolicyRsaTokenKey

Gibt einen RSA-Schlüssel für die Tokenüberprüfung an.

ContentKeyPolicySymmetricTokenKey

Gibt einen symmetrischen Schlüssel für die Tokenüberprüfung an.

ContentKeyPolicyTokenClaim

Stellt einen Tokenanspruch dar.

ContentKeyPolicyTokenRestriction

Stellt eine Tokeneinschränkung dar. Das bereitgestellte Token muss diesen Anforderungen für eine erfolgreiche Lizenz- oder Schlüsselübermittlung entsprechen.

ContentKeyPolicyUnknownConfiguration

Stellt eine ContentKeyPolicyConfiguration dar, die in der aktuellen API-Version nicht verfügbar ist.

ContentKeyPolicyUnknownRestriction

Stellt eine ContentKeyPolicyRestriction dar, die in der aktuellen API-Version nicht verfügbar ist.

ContentKeyPolicyWidevineConfiguration

Gibt eine Konfiguration für Widevine-Lizenzen an.

ContentKeyPolicyX509CertificateTokenKey

Gibt ein Zertifikat für die Tokenüberprüfung an.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

SecurityLevel

Die Sicherheitsstufe.

ContentKeyPolicyClearKeyConfiguration

Stellt eine Konfiguration für Nicht-DRM-Schlüssel dar.

Name Typ Beschreibung
@odata.type string:

#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration

Der Diskriminator für abgeleitete Typen.

ContentKeyPolicyFairPlayConfiguration

Gibt eine Konfiguration für FairPlay-Lizenzen an.

Name Typ Beschreibung
@odata.type string:

#Microsoft.Media.ContentKeyPolicyFairPlayConfiguration

Der Diskriminator für abgeleitete Typen.

ask

string

Der Schlüssel, der als FairPlay-Anwendungsgeheimnisschlüssel verwendet werden muss. Dies muss base64-codiert sein.

fairPlayPfx

string

Die Base64-Darstellung des FairPlay-Zertifikats im PKCS 12-Format (pfx) (einschließlich privater Schlüssel).

fairPlayPfxPassword

string

Das Kennwort, das das FairPlay-Zertifikat im PFX-Format (PKCS 12) verschlüsselt.

offlineRentalConfiguration

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Offline-Vermietungsrichtlinie

rentalAndLeaseKeyType

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Der Miet- und Leaseschlüsseltyp.

rentalDuration

integer

Die Mietdauer. Muss größer als oder gleich 0 sein.

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Name Typ Beschreibung
playbackDurationSeconds

integer

Wiedergabedauer

storageDurationSeconds

integer

Speicherdauer

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Der Miet- und Leaseschlüsseltyp.

Name Typ Beschreibung
DualExpiry

string

Dualer Ablauf für die Offline-Vermietung.

PersistentLimited

string

Der Inhaltsschlüssel kann beibehalten werden, und die gültige Dauer wird durch den Wert der Mietdauer begrenzt.

PersistentUnlimited

string

Der Inhaltsschlüssel kann mit einer unbegrenzten Dauer beibehalten werden.

Undefined

string

Die Dauer des Schlüssels ist nicht angegeben.

Unknown

string

Stellt einen ContentKeyPolicyFairPlayRentalAndLeaseKeyType dar, der in der aktuellen API-Version nicht verfügbar ist.

ContentKeyPolicyOpenRestriction

Stellt eine offene Einschränkung dar. Die Lizenz oder der Schlüssel wird bei jeder Anforderung übermittelt.

Name Typ Beschreibung
@odata.type string:

#Microsoft.Media.ContentKeyPolicyOpenRestriction

Der Diskriminator für abgeleitete Typen.

ContentKeyPolicyOption

Stellt eine Richtlinienoption dar.

Name Typ Beschreibung
configuration ContentKeyPolicyConfiguration:

Die Konfiguration der Schlüsselübermittlung.

name

string

Beschreibung der Richtlinienoption.

policyOptionId

string

Die Legacy-Id der Richtlinienoption.

restriction ContentKeyPolicyRestriction:

Die Anforderungen, die erfüllt sein müssen, um Schlüssel mit dieser Konfiguration bereitzustellen

ContentKeyPolicyPlayReadyConfiguration

Gibt eine Konfiguration für PlayReady-Lizenzen an.

Name Typ Beschreibung
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyConfiguration

Der Diskriminator für abgeleitete Typen.

licenses

ContentKeyPolicyPlayReadyLicense[]

Die PlayReady-Lizenzen.

responseCustomData

string

Die benutzerdefinierten Antwortdaten.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Gibt an, dass sich die Inhaltsschlüssel-ID im PlayReady-Header befindet.

Name Typ Beschreibung
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Der Diskriminator für abgeleitete Typen.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Gibt an, dass die Inhaltsschlüssel-ID in der PlayReady-Konfiguration angegeben wird.

Name Typ Beschreibung
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Der Diskriminator für abgeleitete Typen.

keyId

string

Die Inhaltsschlüssel-ID.

ContentKeyPolicyPlayReadyContentType

Der PlayReady-Inhaltstyp.

Name Typ Beschreibung
UltraVioletDownload

string

Inhaltstyp für ultravioletten Download.

UltraVioletStreaming

string

Inhaltstyp "Ultraviolettes Streaming".

Unknown

string

Stellt einen ContentKeyPolicyPlayReadyContentType dar, der in der aktuellen API-Version nicht verfügbar ist.

Unspecified

string

Nicht angegebener Inhaltstyp.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Konfiguriert die Steuerungsbits für explizite Analogfernsehenausgänge. Weitere Informationen finden Sie in den PlayReady-Complianceregeln.

Name Typ Beschreibung
bestEffort

boolean

Gibt an, ob diese Einschränkung auf Best Effort-Basis erzwungen wird.

configurationData

integer

Konfiguriert die Einschränkungssteuerungsbits. Muss zwischen 0 und 3 einschließlich liegen.

ContentKeyPolicyPlayReadyLicense

Die PlayReady-Lizenz

Name Typ Beschreibung
allowTestDevices

boolean

Ein Flag, das angibt, ob Testgeräte die Lizenz verwenden können.

beginDate

string

Das Anfangsdatum der Lizenz

contentKeyLocation ContentKeyPolicyPlayReadyContentKeyLocation:

Der Speicherort des Inhaltsschlüssels.

contentType

ContentKeyPolicyPlayReadyContentType

Der PlayReady-Inhaltstyp.

expirationDate

string

Das Ablaufdatum der Lizenz.

gracePeriod

string

Die Karenzzeit der Lizenz.

licenseType

ContentKeyPolicyPlayReadyLicenseType

Der Lizenztyp.

playRight

ContentKeyPolicyPlayReadyPlayRight

Die Lizenz PlayRight

relativeBeginDate

string

Das relative Anfangsdatum der Lizenz.

relativeExpirationDate

string

Das relative Ablaufdatum der Lizenz.

securityLevel

SecurityLevel

Die Sicherheitsstufe.

ContentKeyPolicyPlayReadyLicenseType

Der Lizenztyp.

Name Typ Beschreibung
NonPersistent

string

Nicht persistente Lizenz.

Persistent

string

Persistente Lizenz. Ermöglicht die Offlinewiedergabe.

Unknown

string

Stellt einen ContentKeyPolicyPlayReadyLicenseType dar, der in der aktuellen API-Version nicht verfügbar ist.

ContentKeyPolicyPlayReadyPlayRight

Konfiguriert das Play Right in der PlayReady-Lizenz.

Name Typ Beschreibung
agcAndColorStripeRestriction

integer

Konfiguriert die automatische Verstärkungssteuerung (Automatic Gain Control, AGC) und den Farbstreifen in der Lizenz. Muss zwischen 0 und 3 einschließlich liegen.

allowPassingVideoContentToUnknownOutput

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Konfiguriert unbekannte Ausgabebehandlungseinstellungen der Lizenz.

analogVideoOpl

integer

Gibt die Ausgabeschutzebene für komprimierte digitale Audiodaten an.

compressedDigitalAudioOpl

integer

Gibt die Ausgabeschutzebene für komprimierte digitale Audiodaten an.

compressedDigitalVideoOpl

integer

Gibt die Ausgabeschutzebene für komprimiertes digitales Video an.

digitalVideoOnlyContentRestriction

boolean

Aktiviert die Bildeinschränkung für die Videoeinschränkung analoger Komponenten in der Lizenz.

explicitAnalogTelevisionOutputRestriction

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Konfiguriert die Explizite Ausgabeeinschränkung für analoges Fernsehen in der Lizenz. Konfigurationsdaten müssen zwischen 0 und 3 einschließlich liegen.

firstPlayExpiration

string

Der Zeitraum, für den die Lizenz gültig ist, nachdem die Lizenz zum ersten Mal zum Wiedergeben von Inhalten verwendet wurde.

imageConstraintForAnalogComponentVideoRestriction

boolean

Aktiviert die Bildeinschränkung für die Videoeinschränkung analoger Komponenten in der Lizenz.

imageConstraintForAnalogComputerMonitorRestriction

boolean

Aktiviert die Bildeinschränkung für die Videoeinschränkung analoger Komponenten in der Lizenz.

scmsRestriction

integer

Konfiguriert das Serial Copy Management System (SCMS) in der Lizenz. Muss zwischen 0 und 3 einschließlich liegen.

uncompressedDigitalAudioOpl

integer

Gibt die Ausgabeschutzebene für nicht komprimierte digitale Audiodaten an.

uncompressedDigitalVideoOpl

integer

Gibt die Ausgabeschutzebene für unkomprimiertes digitales Video an.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Konfiguriert unbekannte Ausgabebehandlungseinstellungen der Lizenz.

Name Typ Beschreibung
Allowed

string

Das Übergeben des Videoteils geschützter Inhalte an eine unbekannte Ausgabe ist zulässig.

AllowedWithVideoConstriction

string

Das Übergeben des Videoteils geschützter Inhalte an eine unbekannte Ausgabe ist zulässig, jedoch mit eingeschränkter Auflösung.

NotAllowed

string

Das Übergeben des Videoteils geschützter Inhalte an eine unbekannte Ausgabe ist nicht zulässig.

Unknown

string

Stellt eine ContentKeyPolicyPlayReadyUnknownOutputPassingOption dar, die in der aktuellen API-Version nicht verfügbar ist.

ContentKeyPolicyProperties

Die Eigenschaften der Inhaltsschlüsselrichtlinie.

Name Typ Beschreibung
created

string

Das Erstellungsdatum der Richtlinie.

description

string

Eine Beschreibung der Richtlinie.

lastModified

string

Das Datum der letzten Änderung der Richtlinie.

options

ContentKeyPolicyOption[]

Die Optionen für die Schlüsselrichtlinie.

policyId

string

Die ID der Legacyrichtlinie.

ContentKeyPolicyRestrictionTokenType

Der Tokentyp.

Name Typ Beschreibung
Jwt

string

JSON-Webtoken.

Swt

string

Einfaches Webtoken.

Unknown

string

Stellt einen ContentKeyPolicyRestrictionTokenType dar, der in der aktuellen API-Version nicht verfügbar ist.

ContentKeyPolicyRsaTokenKey

Gibt einen RSA-Schlüssel für die Tokenüberprüfung an.

Name Typ Beschreibung
@odata.type string:

#Microsoft.Media.ContentKeyPolicyRsaTokenKey

Der Diskriminator für abgeleitete Typen.

exponent

string

Der RSA-Parameter-Exponent

modulus

string

Der RSA-Parametermodulus

ContentKeyPolicySymmetricTokenKey

Gibt einen symmetrischen Schlüssel für die Tokenüberprüfung an.

Name Typ Beschreibung
@odata.type string:

#Microsoft.Media.ContentKeyPolicySymmetricTokenKey

Der Diskriminator für abgeleitete Typen.

keyValue

string

Der Schlüsselwert des Schlüssels

ContentKeyPolicyTokenClaim

Stellt einen Tokenanspruch dar.

Name Typ Beschreibung
claimType

string

Tokenanspruchstyp.

claimValue

string

Tokenanspruchswert.

ContentKeyPolicyTokenRestriction

Stellt eine Tokeneinschränkung dar. Das bereitgestellte Token muss diesen Anforderungen für eine erfolgreiche Lizenz- oder Schlüsselübermittlung entsprechen.

Name Typ Beschreibung
@odata.type string:

#Microsoft.Media.ContentKeyPolicyTokenRestriction

Der Diskriminator für abgeleitete Typen.

alternateVerificationKeys ContentKeyPolicyRestrictionTokenKey[]:

Eine Liste alternativer Überprüfungsschlüssel.

audience

string

Die Zielgruppe für das Token.

issuer

string

Der Tokenaussteller.

openIdConnectDiscoveryDocument

string

Das OpenID-Verbindungsermittlungsdokument.

primaryVerificationKey ContentKeyPolicyRestrictionTokenKey:

Der primäre Überprüfungsschlüssel.

requiredClaims

ContentKeyPolicyTokenClaim[]

Eine Liste der erforderlichen Tokenansprüche.

restrictionTokenType

ContentKeyPolicyRestrictionTokenType

Der Tokentyp.

ContentKeyPolicyUnknownConfiguration

Stellt eine ContentKeyPolicyConfiguration dar, die in der aktuellen API-Version nicht verfügbar ist.

Name Typ Beschreibung
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownConfiguration

Der Diskriminator für abgeleitete Typen.

ContentKeyPolicyUnknownRestriction

Stellt eine ContentKeyPolicyRestriction dar, die in der aktuellen API-Version nicht verfügbar ist.

Name Typ Beschreibung
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownRestriction

Der Diskriminator für abgeleitete Typen.

ContentKeyPolicyWidevineConfiguration

Gibt eine Konfiguration für Widevine-Lizenzen an.

Name Typ Beschreibung
@odata.type string:

#Microsoft.Media.ContentKeyPolicyWidevineConfiguration

Der Diskriminator für abgeleitete Typen.

widevineTemplate

string

Die Widevine-Vorlage.

ContentKeyPolicyX509CertificateTokenKey

Gibt ein Zertifikat für die Tokenüberprüfung an.

Name Typ Beschreibung
@odata.type string:

#Microsoft.Media.ContentKeyPolicyX509CertificateTokenKey

Der Diskriminator für abgeleitete Typen.

rawBody

string

Das Rohdatenfeld eines Zertifikats im PKCS 12-Format (X509Certificate2 in .NET)

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

SecurityLevel

Die Sicherheitsstufe.

Name Typ Beschreibung
SL150

string

Für Clients, die sich in der Entwicklung oder im Test befinden. Kein Schutz vor nicht autorisierter Verwendung.

SL2000

string

Für gehärtete Geräte und Anwendungen, die kommerzielle Inhalte nutzen. Software- oder Hardwareschutz.

SL3000

string

Nur für gehärtete Geräte. Hardwareschutz.

Unknown

string

Stellt einen SecurityLevel dar, der in der aktuellen API-Version nicht verfügbar ist.