Delen via


Content Key Policies - Get Policy Properties With Secrets

Een inhoudssleutelbeleid met geheimen ophalen
Een inhoudssleutelbeleid ophalen, inclusief geheime waarden

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

URI-parameters

Name In Vereist Type Description
accountName
path True

string

De naam van het Media Services-account.

contentKeyPolicyName
path True

string

De naam van het inhoudssleutelbeleid.

resourceGroupName
path True

string

De naam van de resourcegroep binnen het Azure-abonnement.

subscriptionId
path True

string

De unieke id voor een Microsoft Azure-abonnement.

api-version
query True

string

De versie van de API die moet worden gebruikt met de clientaanvraag.

Antwoorden

Name Type Description
200 OK

ContentKeyPolicyProperties

OK

Other Status Codes

ErrorResponse

Gedetailleerde foutinformatie.

Voorbeelden

Get an Content Key Policy with secrets

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
ContentKeyPolicyClearKeyConfiguration

Vertegenwoordigt een configuratie voor niet-DRM-sleutels.

ContentKeyPolicyFairPlayConfiguration

Hiermee geeft u een configuratie voor FairPlay-licenties.

ContentKeyPolicyFairPlayOfflineRentalConfiguration
ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Het type huur- en leasesleutel.

ContentKeyPolicyOpenRestriction

Vertegenwoordigt een open beperking. Licentie of sleutel wordt op elke aanvraag geleverd.

ContentKeyPolicyOption

Vertegenwoordigt een beleidsoptie.

ContentKeyPolicyPlayReadyConfiguration

Hiermee geeft u een configuratie voor PlayReady-licenties.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Hiermee geeft u op dat de inhoudssleutel-id zich in de PlayReady-header bevindt.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Hiermee geeft u op dat de inhoudssleutel-id wordt opgegeven in de PlayReady-configuratie.

ContentKeyPolicyPlayReadyContentType

Het PlayReady-inhoudstype.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configureert de besturingselementbits expliciete analoge televisieuitvoerbeperking. Zie de PlayReady-nalevingsregels voor meer informatie.

ContentKeyPolicyPlayReadyLicense

De PlayReady-licentie

ContentKeyPolicyPlayReadyLicenseType

Het licentietype.

ContentKeyPolicyPlayReadyPlayRight

Hiermee configureert u het play-recht in de PlayReady-licentie.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Hiermee configureert u instellingen voor onbekende uitvoerafhandeling van de licentie.

ContentKeyPolicyProperties

De eigenschappen van het beleid voor inhoudssleutels.

ContentKeyPolicyRestrictionTokenType

Het type token.

ContentKeyPolicyRsaTokenKey

Hiermee geeft u een RSA-sleutel voor tokenvalidatie op

ContentKeyPolicySymmetricTokenKey

Hiermee geeft u een symmetrische sleutel voor tokenvalidatie.

ContentKeyPolicyTokenClaim

Vertegenwoordigt een tokenclaim.

ContentKeyPolicyTokenRestriction

Vertegenwoordigt een tokenbeperking. Het opgegeven token moet voldoen aan deze vereisten voor een geslaagde levering van licenties of sleutels.

ContentKeyPolicyUnknownConfiguration

Vertegenwoordigt een ContentKeyPolicyConfiguration die niet beschikbaar is in de huidige API-versie.

ContentKeyPolicyUnknownRestriction

Vertegenwoordigt een ContentKeyPolicyRestriction die niet beschikbaar is in de huidige API-versie.

ContentKeyPolicyWidevineConfiguration

Hiermee geeft u een configuratie voor Widevine-licenties.

ContentKeyPolicyX509CertificateTokenKey

Hiermee geeft u een certificaat voor tokenvalidatie.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

SecurityLevel

Het beveiligingsniveau.

ContentKeyPolicyClearKeyConfiguration

Vertegenwoordigt een configuratie voor niet-DRM-sleutels.

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration

De discriminator voor afgeleide typen.

ContentKeyPolicyFairPlayConfiguration

Hiermee geeft u een configuratie voor FairPlay-licenties.

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyFairPlayConfiguration

De discriminator voor afgeleide typen.

ask

string

De sleutel die moet worden gebruikt als sleutel voor fairPlay-toepassingsgeheim. Dit moet base64 gecodeerd zijn.

fairPlayPfx

string

De Base64-weergave van het FairPlay-certificaat in PKCS 12-indeling (pfx) (inclusief persoonlijke sleutel).

fairPlayPfxPassword

string

Het wachtwoord dat fairPlay-certificaat versleutelt in PKCS 12-indeling (pfx).

offlineRentalConfiguration

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Offline verhuurbeleid

rentalAndLeaseKeyType

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Het type huur- en leasesleutel.

rentalDuration

integer

De huurduur. Moet groter dan of gelijk aan 0 zijn.

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Name Type Description
playbackDurationSeconds

integer

Afspeelduur

storageDurationSeconds

integer

Opslagduur

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Het type huur- en leasesleutel.

Name Type Description
DualExpiry

string

Dubbele vervaldatum voor offline verhuur.

PersistentLimited

string

De inhoudssleutel kan worden bewaard en de geldige duur wordt beperkt door de waarde van de huurduur

PersistentUnlimited

string

Inhoudssleutel kan worden behouden met een onbeperkte duur

Undefined

string

De sleutelduur is niet opgegeven.

Unknown

string

Vertegenwoordigt een ContentKeyPolicyFairPlayRentalAndLeaseKeyType dat niet beschikbaar is in de huidige API-versie.

ContentKeyPolicyOpenRestriction

Vertegenwoordigt een open beperking. Licentie of sleutel wordt op elke aanvraag geleverd.

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyOpenRestriction

De discriminator voor afgeleide typen.

ContentKeyPolicyOption

Vertegenwoordigt een beleidsoptie.

Name Type Description
configuration ContentKeyPolicyConfiguration:

De configuratie van de sleutellevering.

name

string

De beschrijving van de beleidsoptie.

policyOptionId

string

De verouderde beleidsoptie-id.

restriction ContentKeyPolicyRestriction:

De vereisten waaraan moet worden voldaan om sleutels te leveren met deze configuratie

ContentKeyPolicyPlayReadyConfiguration

Hiermee geeft u een configuratie voor PlayReady-licenties.

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyConfiguration

De discriminator voor afgeleide typen.

licenses

ContentKeyPolicyPlayReadyLicense[]

De PlayReady-licenties.

responseCustomData

string

De aangepaste antwoordgegevens.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Hiermee geeft u op dat de inhoudssleutel-id zich in de PlayReady-header bevindt.

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

De discriminator voor afgeleide typen.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Hiermee geeft u op dat de inhoudssleutel-id wordt opgegeven in de PlayReady-configuratie.

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

De discriminator voor afgeleide typen.

keyId

string

De inhoudssleutel-id.

ContentKeyPolicyPlayReadyContentType

Het PlayReady-inhoudstype.

Name Type Description
UltraVioletDownload

string

Ultraviolet downloaden inhoudstype.

UltraVioletStreaming

string

Ultraviolet streaming-inhoudstype.

Unknown

string

Vertegenwoordigt een ContentKeyPolicyPlayReadyContentType dat niet beschikbaar is in de huidige API-versie.

Unspecified

string

Niet-opgegeven inhoudstype.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configureert de besturingselementbits expliciete analoge televisieuitvoerbeperking. Zie de PlayReady-nalevingsregels voor meer informatie.

Name Type Description
bestEffort

boolean

Geeft aan of deze beperking wordt afgedwongen op basis van best effort.

configurationData

integer

Hiermee configureert u de bits voor beperkingsbeheer. Moet tussen 0 en 3 zijn.

ContentKeyPolicyPlayReadyLicense

De PlayReady-licentie

Name Type Description
allowTestDevices

boolean

Een vlag die aangeeft of testapparaten de licentie kunnen gebruiken.

beginDate

string

De begindatum van de licentie

contentKeyLocation ContentKeyPolicyPlayReadyContentKeyLocation:

De locatie van de inhoudssleutel.

contentType

ContentKeyPolicyPlayReadyContentType

Het PlayReady-inhoudstype.

expirationDate

string

De vervaldatum van de licentie.

gracePeriod

string

De respijtperiode van de licentie.

licenseType

ContentKeyPolicyPlayReadyLicenseType

Het licentietype.

playRight

ContentKeyPolicyPlayReadyPlayRight

De licentie PlayRight

relativeBeginDate

string

De relatieve begindatum van de licentie.

relativeExpirationDate

string

De relatieve vervaldatum van de licentie.

securityLevel

SecurityLevel

Het beveiligingsniveau.

ContentKeyPolicyPlayReadyLicenseType

Het licentietype.

Name Type Description
NonPersistent

string

Niet-permanente licentie.

Persistent

string

Permanente licentie. Hiermee staat u offline afspelen toe.

Unknown

string

Vertegenwoordigt een ContentKeyPolicyPlayReadyLicenseType dat niet beschikbaar is in de huidige API-versie.

ContentKeyPolicyPlayReadyPlayRight

Hiermee configureert u het play-recht in de PlayReady-licentie.

Name Type Description
agcAndColorStripeRestriction

integer

Configureert Automatic Gain Control (AGC) en Color Stripe in de licentie. Moet tussen 0 en 3 zijn.

allowPassingVideoContentToUnknownOutput

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Hiermee configureert u instellingen voor onbekende uitvoerafhandeling van de licentie.

analogVideoOpl

integer

Hiermee geeft u het uitvoerbeveiligingsniveau voor gecomprimeerde digitale audio.

compressedDigitalAudioOpl

integer

Hiermee geeft u het uitvoerbeveiligingsniveau voor gecomprimeerde digitale audio.

compressedDigitalVideoOpl

integer

Hiermee geeft u het uitvoerbeveiligingsniveau voor gecomprimeerde digitale video op.

digitalVideoOnlyContentRestriction

boolean

Hiermee schakelt u de afbeeldingsbeperking voor videobeperking voor analoge onderdelen in de licentie in.

explicitAnalogTelevisionOutputRestriction

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configureert de expliciete analoge televisieuitvoerbeperking in de licentie. Configuratiegegevens moeten tussen 0 en 3 zijn.

firstPlayExpiration

string

De hoeveelheid tijd die de licentie geldig is nadat de licentie voor het eerst is gebruikt om inhoud af te spelen.

imageConstraintForAnalogComponentVideoRestriction

boolean

Hiermee schakelt u de afbeeldingsbeperking voor videobeperking voor analoge onderdelen in de licentie in.

imageConstraintForAnalogComputerMonitorRestriction

boolean

Hiermee schakelt u de afbeeldingsbeperking voor videobeperking voor analoge onderdelen in de licentie in.

scmsRestriction

integer

Hiermee configureert u het SCMS (Serial Copy Management System) in de licentie. Moet tussen 0 en 3 zijn.

uncompressedDigitalAudioOpl

integer

Hiermee geeft u het uitvoerbeveiligingsniveau voor niet-gecomprimeerde digitale audio op.

uncompressedDigitalVideoOpl

integer

Hiermee geeft u het uitvoerbeveiligingsniveau voor niet-gecomprimeerde digitale video op.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Hiermee configureert u instellingen voor onbekende uitvoerafhandeling van de licentie.

Name Type Description
Allowed

string

Het videogedeelte van beveiligde inhoud doorgeven aan een onbekende uitvoer is toegestaan.

AllowedWithVideoConstriction

string

Het videogedeelte van beveiligde inhoud doorgeven aan een onbekende uitvoer is toegestaan, maar met een beperkte resolutie.

NotAllowed

string

Het videogedeelte van beveiligde inhoud doorgeven aan een onbekende uitvoer is niet toegestaan.

Unknown

string

Vertegenwoordigt een ContentKeyPolicyPlayReadyUnknownOutputPassingOption die niet beschikbaar is in de huidige API-versie.

ContentKeyPolicyProperties

De eigenschappen van het beleid voor inhoudssleutels.

Name Type Description
created

string

De aanmaakdatum van het beleid

description

string

Een beschrijving voor het beleid.

lastModified

string

De laatste wijzigingsdatum van het beleid

options

ContentKeyPolicyOption[]

De opties voor sleutelbeleid.

policyId

string

De verouderde beleids-id.

ContentKeyPolicyRestrictionTokenType

Het type token.

Name Type Description
Jwt

string

JSON-webtoken.

Swt

string

Eenvoudig webtoken.

Unknown

string

Vertegenwoordigt een ContentKeyPolicyRestrictionTokenType dat niet beschikbaar is in de huidige API-versie.

ContentKeyPolicyRsaTokenKey

Hiermee geeft u een RSA-sleutel voor tokenvalidatie op

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyRsaTokenKey

De discriminator voor afgeleide typen.

exponent

string

De exponent rsa-parameter

modulus

string

De RSA-parametermodulator

ContentKeyPolicySymmetricTokenKey

Hiermee geeft u een symmetrische sleutel voor tokenvalidatie.

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicySymmetricTokenKey

De discriminator voor afgeleide typen.

keyValue

string

De sleutelwaarde van de sleutel

ContentKeyPolicyTokenClaim

Vertegenwoordigt een tokenclaim.

Name Type Description
claimType

string

Tokenclaimtype.

claimValue

string

Tokenclaimwaarde.

ContentKeyPolicyTokenRestriction

Vertegenwoordigt een tokenbeperking. Het opgegeven token moet voldoen aan deze vereisten voor een geslaagde levering van licenties of sleutels.

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyTokenRestriction

De discriminator voor afgeleide typen.

alternateVerificationKeys ContentKeyPolicyRestrictionTokenKey[]:

Een lijst met alternatieve verificatiesleutels.

audience

string

De doelgroep voor het token.

issuer

string

De tokenverlener.

openIdConnectDiscoveryDocument

string

Het openID connect-detectiedocument.

primaryVerificationKey ContentKeyPolicyRestrictionTokenKey:

De primaire verificatiesleutel.

requiredClaims

ContentKeyPolicyTokenClaim[]

Een lijst met vereiste tokenclaims.

restrictionTokenType

ContentKeyPolicyRestrictionTokenType

Het type token.

ContentKeyPolicyUnknownConfiguration

Vertegenwoordigt een ContentKeyPolicyConfiguration die niet beschikbaar is in de huidige API-versie.

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownConfiguration

De discriminator voor afgeleide typen.

ContentKeyPolicyUnknownRestriction

Vertegenwoordigt een ContentKeyPolicyRestriction die niet beschikbaar is in de huidige API-versie.

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownRestriction

De discriminator voor afgeleide typen.

ContentKeyPolicyWidevineConfiguration

Hiermee geeft u een configuratie voor Widevine-licenties.

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyWidevineConfiguration

De discriminator voor afgeleide typen.

widevineTemplate

string

De Widevine-sjabloon.

ContentKeyPolicyX509CertificateTokenKey

Hiermee geeft u een certificaat voor tokenvalidatie.

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyX509CertificateTokenKey

De discriminator voor afgeleide typen.

rawBody

string

Het veld onbewerkte gegevens van een certificaat in PKCS 12-indeling (X509Certificate2 in .NET)

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

SecurityLevel

Het beveiligingsniveau.

Name Type Description
SL150

string

Voor clients in ontwikkeling of test. Geen bescherming tegen onbevoegd gebruik.

SL2000

string

Voor beveiligde apparaten en toepassingen die commerciƫle inhoud gebruiken. Software- of hardwarebeveiliging.

SL3000

string

Alleen voor beveiligde apparaten. Hardwarebeveiliging.

Unknown

string

Vertegenwoordigt een SecurityLevel dat niet beschikbaar is in de huidige API-versie.