Udostępnij za pośrednictwem


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
accountName
path True

string

Nazwa konta usługi Media Services.

contentKeyPolicyName
path True

string

Nazwa zasad klucza zawartości.

resourceGroupName
path True

string

Nazwa grupy zasobów w ramach subskrypcji platformy Azure.

subscriptionId
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

ContentKeyPolicyProperties

OK

Other Status Codes

ErrorResponse

Szczegółowe informacje o błędzie.

Przykłady

Get an Content Key Policy with secrets

Przykładowe żądanie

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

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
ContentKeyPolicyClearKeyConfiguration

Reprezentuje konfigurację kluczy innych niż DRM.

ContentKeyPolicyFairPlayConfiguration

Określa konfigurację licencji FairPlay.

ContentKeyPolicyFairPlayOfflineRentalConfiguration
ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Typ klucza wynajmu i dzierżawy.

ContentKeyPolicyOpenRestriction

Reprezentuje otwarte ograniczenie. Licencja lub klucz zostaną dostarczone na każde żądanie.

ContentKeyPolicyOption

Reprezentuje opcję zasad.

ContentKeyPolicyPlayReadyConfiguration

Określa konfigurację licencji PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Określa, że identyfikator klucza zawartości znajduje się w nagłówku PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Określa, że identyfikator klucza zawartości jest określony w konfiguracji PlayReady.

ContentKeyPolicyPlayReadyContentType

Typ zawartości PlayReady.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Konfiguruje bity kontroli ograniczeń jawnej telewizji analogowych. Aby uzyskać więcej informacji, zobacz Reguły zgodności PlayReady.

ContentKeyPolicyPlayReadyLicense

Licencja PlayReady

ContentKeyPolicyPlayReadyLicenseType

Typ licencji.

ContentKeyPolicyPlayReadyPlayRight

Konfiguruje prawo odtwarzania w licencji PlayReady.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Konfiguruje ustawienia obsługi nieznanych danych wyjściowych licencji.

ContentKeyPolicyProperties

Właściwości zasad klucza zawartości.

ContentKeyPolicyRestrictionTokenType

Typ tokenu.

ContentKeyPolicyRsaTokenKey

Określa klucz RSA do weryfikacji tokenu

ContentKeyPolicySymmetricTokenKey

Określa klucz symetryczny na potrzeby walidacji tokenu.

ContentKeyPolicyTokenClaim

Reprezentuje oświadczenie tokenu.

ContentKeyPolicyTokenRestriction

Reprezentuje ograniczenie tokenu. Podany token musi być zgodny z tymi wymaganiami dotyczącymi pomyślnego dostarczania licencji lub klucza.

ContentKeyPolicyUnknownConfiguration

Reprezentuje element ContentKeyPolicyConfiguration, który jest niedostępny w bieżącej wersji interfejsu API.

ContentKeyPolicyUnknownRestriction

Reprezentuje właściwość ContentKeyPolicyRestriction, która jest niedostępna w bieżącej wersji interfejsu API.

ContentKeyPolicyWidevineConfiguration

Określa konfigurację licencji Widevine.

ContentKeyPolicyX509CertificateTokenKey

Określa certyfikat weryfikacji tokenu.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

SecurityLevel

Poziom zabezpieczeń.

ContentKeyPolicyClearKeyConfiguration

Reprezentuje konfigurację kluczy innych niż DRM.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration

Dyskryminator typów pochodnych.

ContentKeyPolicyFairPlayConfiguration

Określa konfigurację licencji FairPlay.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyFairPlayConfiguration

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

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Zasady wypożyczania w trybie offline

rentalAndLeaseKeyType

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

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.Media.ContentKeyPolicyOpenRestriction

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.Media.ContentKeyPolicyPlayReadyConfiguration

Dyskryminator typów pochodnych.

licenses

ContentKeyPolicyPlayReadyLicense[]

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.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

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.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

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

ContentKeyPolicyPlayReadyContentType

Typ zawartości PlayReady.

expirationDate

string

Data wygaśnięcia licencji.

gracePeriod

string

Okres prolongaty licencji.

licenseType

ContentKeyPolicyPlayReadyLicenseType

Typ licencji.

playRight

ContentKeyPolicyPlayReadyPlayRight

Licencja PlayRight

relativeBeginDate

string

Względna data rozpoczęcia licencji.

relativeExpirationDate

string

Względna data wygaśnięcia licencji.

securityLevel

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

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

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

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

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

ContentKeyPolicyOption[]

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.Media.ContentKeyPolicyRsaTokenKey

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.Media.ContentKeyPolicySymmetricTokenKey

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.Media.ContentKeyPolicyTokenRestriction

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

ContentKeyPolicyTokenClaim[]

Lista wymaganych oświadczeń tokenu.

restrictionTokenType

ContentKeyPolicyRestrictionTokenType

Typ tokenu.

ContentKeyPolicyUnknownConfiguration

Reprezentuje element ContentKeyPolicyConfiguration, który jest niedostępny w bieżącej wersji interfejsu API.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownConfiguration

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.Media.ContentKeyPolicyUnknownRestriction

Dyskryminator typów pochodnych.

ContentKeyPolicyWidevineConfiguration

Określa konfigurację licencji Widevine.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyWidevineConfiguration

Dyskryminator typów pochodnych.

widevineTemplate

string

Szablon Widevine.

ContentKeyPolicyX509CertificateTokenKey

Określa certyfikat weryfikacji tokenu.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyX509CertificateTokenKey

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

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

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

ErrorDetail

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.