Content Key Policies - Get Policy Properties With Secrets
Pobieranie zasad klucza zawartości z wpisami tajnymi
Pobieranie zasad klucza zawartości, w tym wartości wpisów tajnych
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/contentKeyPolicies/{contentKeyPolicyName}/getPolicyPropertiesWithSecrets?api-version=2022-08-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
account
|
path | True |
string |
Nazwa konta usługi Media Services. |
content
|
path | True |
string |
Nazwa zasad klucza zawartości. |
resource
|
path | True |
string |
Nazwa grupy zasobów w ramach subskrypcji platformy Azure. |
subscription
|
path | True |
string |
Unikatowy identyfikator subskrypcji platformy Microsoft Azure. |
api-version
|
query | True |
string |
Wersja interfejsu API do użycia z żądaniem klienta. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Szczegółowe informacje o błędzie. |
Przykłady
Get an Content Key Policy with secrets
Przykładowe żądanie
Przykładowa odpowiedź
{
"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"
}
}
]
}
Definicje
Nazwa | Opis |
---|---|
Content |
Reprezentuje konfigurację kluczy innych niż DRM. |
Content |
Określa konfigurację licencji FairPlay. |
Content |
|
Content |
Typ klucza wynajmu i dzierżawy. |
Content |
Reprezentuje otwarte ograniczenie. Licencja lub klucz zostaną dostarczone na każde żądanie. |
Content |
Reprezentuje opcję zasad. |
Content |
Określa konfigurację licencji PlayReady. |
Content |
Określa, że identyfikator klucza zawartości znajduje się w nagłówku PlayReady. |
Content |
Określa, że identyfikator klucza zawartości jest określony w konfiguracji PlayReady. |
Content |
Typ zawartości PlayReady. |
Content |
Konfiguruje bity kontroli ograniczeń jawnej telewizji analogowych. Aby uzyskać więcej informacji, zobacz Reguły zgodności PlayReady. |
Content |
Licencja PlayReady |
Content |
Typ licencji. |
Content |
Konfiguruje prawo odtwarzania w licencji PlayReady. |
Content |
Konfiguruje ustawienia obsługi nieznanych danych wyjściowych licencji. |
Content |
Właściwości zasad klucza zawartości. |
Content |
Typ tokenu. |
Content |
Określa klucz RSA do weryfikacji tokenu |
Content |
Określa klucz symetryczny na potrzeby walidacji tokenu. |
Content |
Reprezentuje oświadczenie tokenu. |
Content |
Reprezentuje ograniczenie tokenu. Podany token musi być zgodny z tymi wymaganiami dotyczącymi pomyślnego dostarczania licencji lub klucza. |
Content |
Reprezentuje element ContentKeyPolicyConfiguration, który jest niedostępny w bieżącej wersji interfejsu API. |
Content |
Reprezentuje właściwość ContentKeyPolicyRestriction, która jest niedostępna w bieżącej wersji interfejsu API. |
Content |
Określa konfigurację licencji Widevine. |
Content |
Określa certyfikat weryfikacji tokenu. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd |
Security |
Poziom zabezpieczeń. |
ContentKeyPolicyClearKeyConfiguration
Reprezentuje konfigurację kluczy innych niż DRM.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
Dyskryminator typów pochodnych. |
ContentKeyPolicyFairPlayConfiguration
Określa konfigurację licencji FairPlay.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
Dyskryminator typów pochodnych. |
ask |
string |
Klucz, który musi być używany jako klucz tajny aplikacji FairPlay. Musi to być zakodowane w formacie Base64. |
fairPlayPfx |
string |
Reprezentacja certyfikatu FairPlay w formacie Base64 w formacie PKCS 12 (pfx) (w tym klucz prywatny). |
fairPlayPfxPassword |
string |
Hasło szyfrujące certyfikat FairPlay w formacie PKCS 12 (pfx). |
offlineRentalConfiguration |
Zasady wypożyczania w trybie offline |
|
rentalAndLeaseKeyType |
Typ klucza wynajmu i dzierżawy. |
|
rentalDuration |
integer |
Czas trwania wynajmu. Musi być równa 0 lub większa. |
ContentKeyPolicyFairPlayOfflineRentalConfiguration
Nazwa | Typ | Opis |
---|---|---|
playbackDurationSeconds |
integer |
Czas trwania odtwarzania |
storageDurationSeconds |
integer |
Okres przechowywania |
ContentKeyPolicyFairPlayRentalAndLeaseKeyType
Typ klucza wynajmu i dzierżawy.
Nazwa | Typ | Opis |
---|---|---|
DualExpiry |
string |
Podwójny czas wygaśnięcia do wynajęcia w trybie offline. |
PersistentLimited |
string |
Klucz zawartości można utrwalić, a prawidłowy czas trwania jest ograniczony przez wartość Czas trwania wynajmu |
PersistentUnlimited |
string |
Klucz zawartości można utrwał z nieograniczonym czasem trwania |
Undefined |
string |
Nie określono czasu trwania klucza. |
Unknown |
string |
Reprezentuje właściwość ContentKeyPolicyFairPlayRentalAndLeaseKeyType, która jest niedostępna w bieżącej wersji interfejsu API. |
ContentKeyPolicyOpenRestriction
Reprezentuje otwarte ograniczenie. Licencja lub klucz zostaną dostarczone na każde żądanie.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
Dyskryminator typów pochodnych. |
ContentKeyPolicyOption
Reprezentuje opcję zasad.
Nazwa | Typ | Opis |
---|---|---|
configuration | ContentKeyPolicyConfiguration: |
Konfiguracja dostarczania kluczy. |
name |
string |
Opis opcji zasad. |
policyOptionId |
string |
Starszy identyfikator opcji zasad. |
restriction | ContentKeyPolicyRestriction: |
Wymagania, które muszą zostać spełnione w celu dostarczenia kluczy z tą konfiguracją |
ContentKeyPolicyPlayReadyConfiguration
Określa konfigurację licencji PlayReady.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
Dyskryminator typów pochodnych. |
licenses |
Licencje PlayReady. |
|
responseCustomData |
string |
Niestandardowe dane odpowiedzi. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader
Określa, że identyfikator klucza zawartości znajduje się w nagłówku PlayReady.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
Dyskryminujący dla typów pochodnych. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier
Określa, że identyfikator klucza zawartości jest określony w konfiguracji PlayReady.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
Dyskryminujący dla typów pochodnych. |
keyId |
string |
Identyfikator klucza zawartości. |
ContentKeyPolicyPlayReadyContentType
Typ zawartości PlayReady.
Nazwa | Typ | Opis |
---|---|---|
UltraVioletDownload |
string |
Typ zawartości pobierania ultrafioletu. |
UltraVioletStreaming |
string |
Typ zawartości przesyłania strumieniowego ultrafioletu. |
Unknown |
string |
Reprezentuje właściwość ContentKeyPolicyPlayReadyContentType, która jest niedostępna w bieżącej wersji interfejsu API. |
Unspecified |
string |
Nieokreślony typ zawartości. |
ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction
Konfiguruje bity kontroli ograniczeń jawnej telewizji analogowych. Aby uzyskać więcej informacji, zobacz Reguły zgodności PlayReady.
Nazwa | Typ | Opis |
---|---|---|
bestEffort |
boolean |
Wskazuje, czy to ograniczenie jest wymuszane na podstawie najlepszego nakładu pracy. |
configurationData |
integer |
Konfiguruje bity kontroli ograniczeń. Musi należeć do zakresu od 0 do 3 włącznie. |
ContentKeyPolicyPlayReadyLicense
Licencja PlayReady
Nazwa | Typ | Opis |
---|---|---|
allowTestDevices |
boolean |
Flaga wskazująca, czy urządzenia testowe mogą korzystać z licencji. |
beginDate |
string |
Data rozpoczęcia licencji |
contentKeyLocation | ContentKeyPolicyPlayReadyContentKeyLocation: |
Lokalizacja klucza zawartości. |
contentType |
Typ zawartości PlayReady. |
|
expirationDate |
string |
Data wygaśnięcia licencji. |
gracePeriod |
string |
Okres prolongaty licencji. |
licenseType |
Typ licencji. |
|
playRight |
Licencja PlayRight |
|
relativeBeginDate |
string |
Względna data rozpoczęcia licencji. |
relativeExpirationDate |
string |
Względna data wygaśnięcia licencji. |
securityLevel |
Poziom zabezpieczeń. |
ContentKeyPolicyPlayReadyLicenseType
Typ licencji.
Nazwa | Typ | Opis |
---|---|---|
NonPersistent |
string |
Licencja nietrwalna. |
Persistent |
string |
Licencja trwała. Umożliwia odtwarzanie w trybie offline. |
Unknown |
string |
Reprezentuje właściwość ContentKeyPolicyPlayReadyLicenseType, która jest niedostępna w bieżącej wersji interfejsu API. |
ContentKeyPolicyPlayReadyPlayRight
Konfiguruje prawo odtwarzania w licencji PlayReady.
Nazwa | Typ | Opis |
---|---|---|
agcAndColorStripeRestriction |
integer |
Konfiguruje automatyczną kontrolę przyrostk (AGC) i pasek kolorów w licencji. Musi należeć do przedziału od 0 do 3 włącznie. |
allowPassingVideoContentToUnknownOutput |
Konfiguruje ustawienia obsługi nieznanych danych wyjściowych licencji. |
|
analogVideoOpl |
integer |
Określa poziom ochrony danych wyjściowych dla skompresowanego dźwięku cyfrowego. |
compressedDigitalAudioOpl |
integer |
Określa poziom ochrony danych wyjściowych dla skompresowanego dźwięku cyfrowego. |
compressedDigitalVideoOpl |
integer |
Określa poziom ochrony danych wyjściowych skompresowanego cyfrowego wideo. |
digitalVideoOnlyContentRestriction |
boolean |
Włącza ograniczenie obrazu dla ograniczeń wideo składników analogowych w licencji. |
explicitAnalogTelevisionOutputRestriction |
Content |
Konfiguruje ograniczenie danych wyjściowych jawnej telewizji analogowych w licencji. Dane konfiguracji muszą należeć do zakresu od 0 do 3 włącznie. |
firstPlayExpiration |
string |
Czas ważności licencji po pierwszym użyciu licencji do odtwarzania zawartości. |
imageConstraintForAnalogComponentVideoRestriction |
boolean |
Włącza ograniczenie obrazu dla ograniczeń wideo składników analogowych w licencji. |
imageConstraintForAnalogComputerMonitorRestriction |
boolean |
Włącza ograniczenie obrazu dla ograniczeń wideo składników analogowych w licencji. |
scmsRestriction |
integer |
Konfiguruje system zarządzania kopiami seryjnymi (SCMS) w licencji. Musi należeć do przedziału od 0 do 3 włącznie. |
uncompressedDigitalAudioOpl |
integer |
Określa poziom ochrony danych wyjściowych dla nieskompresowanego dźwięku cyfrowego. |
uncompressedDigitalVideoOpl |
integer |
Określa poziom ochrony danych wyjściowych dla nieskompresowanego cyfrowego wideo. |
ContentKeyPolicyPlayReadyUnknownOutputPassingOption
Konfiguruje ustawienia obsługi nieznanych danych wyjściowych licencji.
Nazwa | Typ | Opis |
---|---|---|
Allowed |
string |
Przekazywanie części chronionej zawartości wideo do nieznanych danych wyjściowych jest dozwolone. |
AllowedWithVideoConstriction |
string |
Przekazywanie części chronionej zawartości wideo do nieznanych danych wyjściowych jest dozwolone, ale z ograniczonym rozwiązaniem. |
NotAllowed |
string |
Przekazywanie części chronionej zawartości wideo do nieznanych danych wyjściowych jest niedozwolone. |
Unknown |
string |
Reprezentuje element ContentKeyPolicyPlayReadyUnknownOutputPassingOption, który jest niedostępny w bieżącej wersji interfejsu API. |
ContentKeyPolicyProperties
Właściwości zasad klucza zawartości.
Nazwa | Typ | Opis |
---|---|---|
created |
string |
Data utworzenia zasad |
description |
string |
Opis zasad. |
lastModified |
string |
Data ostatniej modyfikacji zasad |
options |
Opcje kluczowe zasady. |
|
policyId |
string |
Starszy identyfikator zasad. |
ContentKeyPolicyRestrictionTokenType
Typ tokenu.
Nazwa | Typ | Opis |
---|---|---|
Jwt |
string |
Token internetowy JSON. |
Swt |
string |
Prosty token internetowy. |
Unknown |
string |
Reprezentuje właściwość ContentKeyPolicyRestrictionTokenType, która jest niedostępna w bieżącej wersji interfejsu API. |
ContentKeyPolicyRsaTokenKey
Określa klucz RSA do weryfikacji tokenu
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
Dyskryminujący dla typów pochodnych. |
exponent |
string |
Wykładnik parametru RSA |
modulus |
string |
Modulus parametru RSA |
ContentKeyPolicySymmetricTokenKey
Określa klucz symetryczny na potrzeby walidacji tokenu.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
Dyskryminujący dla typów pochodnych. |
keyValue |
string |
Wartość klucza klucza |
ContentKeyPolicyTokenClaim
Reprezentuje oświadczenie tokenu.
Nazwa | Typ | Opis |
---|---|---|
claimType |
string |
Typ oświadczenia tokenu. |
claimValue |
string |
Wartość oświadczenia tokenu. |
ContentKeyPolicyTokenRestriction
Reprezentuje ograniczenie tokenu. Podany token musi być zgodny z tymi wymaganiami dotyczącymi pomyślnego dostarczania licencji lub klucza.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
Dyskryminator typów pochodnych. |
alternateVerificationKeys | ContentKeyPolicyRestrictionTokenKey[]: |
Lista alternatywnych kluczy weryfikacji. |
audience |
string |
Odbiorcy tokenu. |
issuer |
string |
Wystawca tokenu. |
openIdConnectDiscoveryDocument |
string |
Dokument OpenID connect discovery (Identyfikator openID łączenia odnajdywania). |
primaryVerificationKey | ContentKeyPolicyRestrictionTokenKey: |
Podstawowy klucz weryfikacji. |
requiredClaims |
Lista wymaganych oświadczeń tokenu. |
|
restrictionTokenType |
Typ tokenu. |
ContentKeyPolicyUnknownConfiguration
Reprezentuje element ContentKeyPolicyConfiguration, który jest niedostępny w bieżącej wersji interfejsu API.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
Dyskryminator typów pochodnych. |
ContentKeyPolicyUnknownRestriction
Reprezentuje właściwość ContentKeyPolicyRestriction, która jest niedostępna w bieżącej wersji interfejsu API.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
Dyskryminator typów pochodnych. |
ContentKeyPolicyWidevineConfiguration
Określa konfigurację licencji Widevine.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
Dyskryminator typów pochodnych. |
widevineTemplate |
string |
Szablon Widevine. |
ContentKeyPolicyX509CertificateTokenKey
Określa certyfikat weryfikacji tokenu.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
Dyskryminujący dla typów pochodnych. |
rawBody |
string |
Pole nieprzetworzonych danych certyfikatu w formacie PKCS 12 (X509Certificate2 na platformie .NET) |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
Nazwa | Typ | Opis |
---|---|---|
info |
object |
Dodatkowe informacje. |
type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
Nazwa | Typ | Opis |
---|---|---|
additionalInfo |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
Szczegóły błędu. |
|
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy błędu. |
ErrorResponse
Odpowiedź na błąd
Nazwa | Typ | Opis |
---|---|---|
error |
Obiekt error. |
SecurityLevel
Poziom zabezpieczeń.
Nazwa | Typ | Opis |
---|---|---|
SL150 |
string |
W przypadku klientów w ramach programowania lub testowania. Brak ochrony przed nieautoryzowanym użyciem. |
SL2000 |
string |
W przypadku urządzeń ze wzmocnionym zabezpieczeniami i aplikacji korzystających z zawartości komercyjnej. Ochrona oprogramowania lub sprzętu. |
SL3000 |
string |
Tylko w przypadku urządzeń ze wzmocnionym zabezpieczeniami. Ochrona sprzętowa. |
Unknown |
string |
Reprezentuje poziom zabezpieczeń, który jest niedostępny w bieżącej wersji interfejsu API. |