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 |
---|---|---|---|---|
account
|
path | True |
string |
Der Name des Media Services-Kontos. |
content
|
path | True |
string |
Der Name der Inhaltsschlüsselrichtlinie. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe innerhalb des Azure-Abonnements. |
subscription
|
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 |
OK |
|
Other Status Codes |
Ausführliche Fehlerinformationen. |
Beispiele
Get an Content Key Policy with secrets
Beispielanforderung
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 |
---|---|
Content |
Stellt eine Konfiguration für Nicht-DRM-Schlüssel dar. |
Content |
Gibt eine Konfiguration für FairPlay-Lizenzen an. |
Content |
|
Content |
Der Miet- und Leaseschlüsseltyp. |
Content |
Stellt eine offene Einschränkung dar. Die Lizenz oder der Schlüssel wird bei jeder Anforderung übermittelt. |
Content |
Stellt eine Richtlinienoption dar. |
Content |
Gibt eine Konfiguration für PlayReady-Lizenzen an. |
Content |
Gibt an, dass sich die Inhaltsschlüssel-ID im PlayReady-Header befindet. |
Content |
Gibt an, dass die Inhaltsschlüssel-ID in der PlayReady-Konfiguration angegeben wird. |
Content |
Der PlayReady-Inhaltstyp. |
Content |
Konfiguriert die Steuerungsbits für explizite Analogfernsehenausgänge. Weitere Informationen finden Sie in den PlayReady-Complianceregeln. |
Content |
Die PlayReady-Lizenz |
Content |
Der Lizenztyp. |
Content |
Konfiguriert das Play Right in der PlayReady-Lizenz. |
Content |
Konfiguriert unbekannte Ausgabebehandlungseinstellungen der Lizenz. |
Content |
Die Eigenschaften der Inhaltsschlüsselrichtlinie. |
Content |
Der Tokentyp. |
Content |
Gibt einen RSA-Schlüssel für die Tokenüberprüfung an. |
Content |
Gibt einen symmetrischen Schlüssel für die Tokenüberprüfung an. |
Content |
Stellt einen Tokenanspruch dar. |
Content |
Stellt eine Tokeneinschränkung dar. Das bereitgestellte Token muss diesen Anforderungen für eine erfolgreiche Lizenz- oder Schlüsselübermittlung entsprechen. |
Content |
Stellt eine ContentKeyPolicyConfiguration dar, die in der aktuellen API-Version nicht verfügbar ist. |
Content |
Stellt eine ContentKeyPolicyRestriction dar, die in der aktuellen API-Version nicht verfügbar ist. |
Content |
Gibt eine Konfiguration für Widevine-Lizenzen an. |
Content |
Gibt ein Zertifikat für die Tokenüberprüfung an. |
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
Security |
Die Sicherheitsstufe. |
ContentKeyPolicyClearKeyConfiguration
Stellt eine Konfiguration für Nicht-DRM-Schlüssel dar.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Der Diskriminator für abgeleitete Typen. |
ContentKeyPolicyFairPlayConfiguration
Gibt eine Konfiguration für FairPlay-Lizenzen an.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
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 |
Offline-Vermietungsrichtlinie |
|
rentalAndLeaseKeyType |
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. |
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. |
Der Diskriminator für abgeleitete Typen. |
licenses |
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. |
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. |
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 |
Der PlayReady-Inhaltstyp. |
|
expirationDate |
string |
Das Ablaufdatum der Lizenz. |
gracePeriod |
string |
Die Karenzzeit der Lizenz. |
licenseType |
Der Lizenztyp. |
|
playRight |
Die Lizenz PlayRight |
|
relativeBeginDate |
string |
Das relative Anfangsdatum der Lizenz. |
relativeExpirationDate |
string |
Das relative Ablaufdatum der Lizenz. |
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 |
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 |
Content |
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 |
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. |
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. |
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. |
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 |
Eine Liste der erforderlichen Tokenansprüche. |
|
restrictionTokenType |
Der Tokentyp. |
ContentKeyPolicyUnknownConfiguration
Stellt eine ContentKeyPolicyConfiguration dar, die in der aktuellen API-Version nicht verfügbar ist.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
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. |
Der Diskriminator für abgeleitete Typen. |
ContentKeyPolicyWidevineConfiguration
Gibt eine Konfiguration für Widevine-Lizenzen an.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
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. |
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 |
Die zusätzlichen Fehlerinformationen. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
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. |