Content Key Policies - Get Policy Properties With Secrets

Obtención de una directiva de clave de contenido con secretos
Obtener una directiva de clave de contenido, incluidos los valores secretos

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
accountName
path True

string

Nombre de la cuenta de Media Services.

contentKeyPolicyName
path True

string

Nombre de la directiva de clave de contenido.

resourceGroupName
path True

string

Nombre del grupo de recursos dentro de la suscripción de Azure.

subscriptionId
path True

string

Identificador único de una suscripción de Microsoft Azure.

api-version
query True

string

Versión de la API que se va a usar con la solicitud de cliente.

Respuestas

Nombre Tipo Description
200 OK

ContentKeyPolicyProperties

Aceptar

Other Status Codes

ErrorResponse

Información detallada del error.

Ejemplos

Get an Content Key Policy with secrets

Sample Request

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

Sample Response

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

Definiciones

Nombre Description
ContentKeyPolicyClearKeyConfiguration

Representa una configuración para claves que no son DRM.

ContentKeyPolicyFairPlayConfiguration

Especifica una configuración para las licencias de FairPlay.

ContentKeyPolicyFairPlayOfflineRentalConfiguration
ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Tipo de clave de alquiler y concesión.

ContentKeyPolicyOpenRestriction

Representa una restricción abierta. La licencia o la clave se entregarán en cada solicitud.

ContentKeyPolicyOption

Representa una opción de directiva.

ContentKeyPolicyPlayReadyConfiguration

Especifica una configuración para las licencias de PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Especifica que el identificador de clave de contenido está en el encabezado PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Especifica que el identificador de clave de contenido se especifica en la configuración de PlayReady.

ContentKeyPolicyPlayReadyContentType

Tipo de contenido PlayReady.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configura los bits de control Explicit Analog Television Output Restriction. Para obtener más información, consulte Reglas de cumplimiento de PlayReady.

ContentKeyPolicyPlayReadyLicense

La licencia de PlayReady

ContentKeyPolicyPlayReadyLicenseType

Tipo de licencia.

ContentKeyPolicyPlayReadyPlayRight

Configura play Right en la licencia de PlayReady.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Configura los valores de control de salida desconocidos de la licencia.

ContentKeyPolicyProperties

Propiedades de la directiva de clave de contenido.

ContentKeyPolicyRestrictionTokenType

Tipo de token.

ContentKeyPolicyRsaTokenKey

Especifica una clave RSA para la validación de tokens.

ContentKeyPolicySymmetricTokenKey

Especifica una clave simétrica para la validación de tokens.

ContentKeyPolicyTokenClaim

Representa una notificación de token.

ContentKeyPolicyTokenRestriction

Representa una restricción de token. El token proporcionado debe coincidir con estos requisitos para la entrega correcta de licencias o claves.

ContentKeyPolicyUnknownConfiguration

Representa una contentKeyPolicyConfiguration que no está disponible en la versión actual de la API.

ContentKeyPolicyUnknownRestriction

Representa una contentKeyPolicyRestriction que no está disponible en la versión actual de la API.

ContentKeyPolicyWidevineConfiguration

Especifica una configuración para las licencias de Widevine.

ContentKeyPolicyX509CertificateTokenKey

Especifica un certificado para la validación de tokens.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

SecurityLevel

Nivel de seguridad.

ContentKeyPolicyClearKeyConfiguration

Representa una configuración para claves que no son DRM.

Nombre Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration

Discriminador de tipos derivados.

ContentKeyPolicyFairPlayConfiguration

Especifica una configuración para las licencias de FairPlay.

Nombre Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyFairPlayConfiguration

Discriminador de tipos derivados.

ask

string

Clave que se debe usar como clave secreta de aplicación de FairPlay. Esto debe estar codificado en base64.

fairPlayPfx

string

Representación en Base64 del certificado FairPlay en formato PKCS 12 (pfx) (incluida la clave privada).

fairPlayPfxPassword

string

Contraseña que cifra el certificado FairPlay en formato PKCS 12 (pfx).

offlineRentalConfiguration

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Directiva de alquiler sin conexión

rentalAndLeaseKeyType

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Tipo de clave de alquiler y concesión.

rentalDuration

integer

Duración del alquiler. Debe ser mayor o igual que 0.

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Nombre Tipo Description
playbackDurationSeconds

integer

Duración de la reproducción

storageDurationSeconds

integer

Duración del almacenamiento

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Tipo de clave de alquiler y concesión.

Nombre Tipo Description
DualExpiry

string

Expiración dual para el alquiler sin conexión.

PersistentLimited

string

La clave de contenido se puede conservar y la duración válida está limitada por el valor de Duración del alquiler.

PersistentUnlimited

string

La clave de contenido se puede conservar con una duración ilimitada

Undefined

string

No se especifica la duración de la clave.

Unknown

string

Representa un ContentKeyPolicyFairPlayRentalAndLeaseKeyType que no está disponible en la versión actual de la API.

ContentKeyPolicyOpenRestriction

Representa una restricción abierta. La licencia o la clave se entregarán en cada solicitud.

Nombre Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyOpenRestriction

Discriminador de tipos derivados.

ContentKeyPolicyOption

Representa una opción de directiva.

Nombre Tipo Description
configuration ContentKeyPolicyConfiguration:

Configuración de entrega de claves.

name

string

Descripción de la opción de directiva.

policyOptionId

string

Identificador de opción de directiva heredado.

restriction ContentKeyPolicyRestriction:

Requisitos que se deben cumplir para entregar claves con esta configuración

ContentKeyPolicyPlayReadyConfiguration

Especifica una configuración para las licencias de PlayReady.

Nombre Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyConfiguration

Discriminador de tipos derivados.

licenses

ContentKeyPolicyPlayReadyLicense[]

Las licencias de PlayReady.

responseCustomData

string

Datos de respuesta personalizados.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Especifica que el identificador de clave de contenido está en el encabezado PlayReady.

Nombre Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Discriminador de tipos derivados.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Especifica que el identificador de clave de contenido se especifica en la configuración de PlayReady.

Nombre Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Discriminador de tipos derivados.

keyId

string

Identificador de clave de contenido.

ContentKeyPolicyPlayReadyContentType

Tipo de contenido PlayReady.

Nombre Tipo Description
UltraVioletDownload

string

Tipo de contenido de descarga ultravioleta.

UltraVioletStreaming

string

Tipo de contenido de streaming ultravioleta.

Unknown

string

Representa un ContentKeyPolicyPlayReadyContentType que no está disponible en la versión actual de la API.

Unspecified

string

Tipo de contenido no especificado.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configura los bits de control Explicit Analog Television Output Restriction. Para obtener más información, consulte Reglas de cumplimiento de PlayReady.

Nombre Tipo Description
bestEffort

boolean

Indica si esta restricción se aplica según el mejor esfuerzo.

configurationData

integer

Configura los bits de control de restricción. Debe estar comprendido entre 0 y 3 inclusive.

ContentKeyPolicyPlayReadyLicense

La licencia de PlayReady

Nombre Tipo Description
allowTestDevices

boolean

Marca que indica si los dispositivos de prueba pueden usar la licencia.

beginDate

string

La fecha de inicio de la licencia

contentKeyLocation ContentKeyPolicyPlayReadyContentKeyLocation:

Ubicación de la clave de contenido.

contentType

ContentKeyPolicyPlayReadyContentType

Tipo de contenido de PlayReady.

expirationDate

string

Fecha de expiración de la licencia.

gracePeriod

string

Período de gracia de licencia.

licenseType

ContentKeyPolicyPlayReadyLicenseType

Tipo de licencia.

playRight

ContentKeyPolicyPlayReadyPlayRight

La licencia PlayRight

relativeBeginDate

string

Fecha de inicio relativa de la licencia.

relativeExpirationDate

string

Fecha de expiración relativa de la licencia.

securityLevel

SecurityLevel

Nivel de seguridad.

ContentKeyPolicyPlayReadyLicenseType

Tipo de licencia.

Nombre Tipo Description
NonPersistent

string

Licencia no persistente.

Persistent

string

Licencia persistente. Permite la reproducción sin conexión.

Unknown

string

Representa un ContentKeyPolicyPlayReadyLicenseType que no está disponible en la versión actual de la API.

ContentKeyPolicyPlayReadyPlayRight

Configura play Right en la licencia de PlayReady.

Nombre Tipo Description
agcAndColorStripeRestriction

integer

Configura el control de ganancia automática (AGC) y la franja de color en la licencia. Debe estar comprendido entre 0 y 3 inclusive.

allowPassingVideoContentToUnknownOutput

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Configura los valores de control de salida desconocidos de la licencia.

analogVideoOpl

integer

Especifica el nivel de protección de salida para el audio digital comprimido.

compressedDigitalAudioOpl

integer

Especifica el nivel de protección de salida para el audio digital comprimido.

compressedDigitalVideoOpl

integer

Especifica el nivel de protección de salida para el vídeo digital comprimido.

digitalVideoOnlyContentRestriction

boolean

Habilita la restricción image para la restricción de vídeo de componente analógico en la licencia.

explicitAnalogTelevisionOutputRestriction

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configura la restricción explícita de salida de televisión analógica en la licencia. Los datos de configuración deben estar comprendidos entre 0 y 3 incluidos.

firstPlayExpiration

string

Cantidad de tiempo que la licencia es válida después de que la licencia se use por primera vez para reproducir contenido.

imageConstraintForAnalogComponentVideoRestriction

boolean

Habilita la restricción image para la restricción de vídeo de componente analógico en la licencia.

imageConstraintForAnalogComputerMonitorRestriction

boolean

Habilita la restricción image para la restricción de vídeo de componente analógico en la licencia.

scmsRestriction

integer

Configura el Sistema de administración de copias serie (SCMS) en la licencia. Debe estar comprendido entre 0 y 3 inclusive.

uncompressedDigitalAudioOpl

integer

Especifica el nivel de protección de salida para el audio digital sin comprimir.

uncompressedDigitalVideoOpl

integer

Especifica el nivel de protección de salida para el vídeo digital sin comprimir.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Configura los valores de control de salida desconocidos de la licencia.

Nombre Tipo Description
Allowed

string

Se permite pasar la parte de vídeo del contenido protegido a una salida desconocida.

AllowedWithVideoConstriction

string

Se permite pasar la parte de vídeo del contenido protegido a una salida desconocida, pero con una resolución restringida.

NotAllowed

string

No se permite pasar la parte de vídeo del contenido protegido a una salida desconocida.

Unknown

string

Representa un ContentKeyPolicyPlayReadyUnknownOutputPassingOption que no está disponible en la versión actual de la API.

ContentKeyPolicyProperties

Propiedades de la directiva de clave de contenido.

Nombre Tipo Description
created

string

Fecha de creación de la directiva

description

string

Descripción de la directiva.

lastModified

string

Fecha de la última modificación de la directiva

options

ContentKeyPolicyOption[]

Opciones de la directiva de clave.

policyId

string

Identificador de directiva heredado.

ContentKeyPolicyRestrictionTokenType

Tipo de token.

Nombre Tipo Description
Jwt

string

JSON Web Token.

Swt

string

Token web simple.

Unknown

string

Representa un ContentKeyPolicyRestrictionTokenType que no está disponible en la versión actual de la API.

ContentKeyPolicyRsaTokenKey

Especifica una clave RSA para la validación de tokens.

Nombre Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyRsaTokenKey

Discriminador de tipos derivados.

exponent

string

Exponente de parámetros RSA

modulus

string

Módulo de parámetros RSA

ContentKeyPolicySymmetricTokenKey

Especifica una clave simétrica para la validación de tokens.

Nombre Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicySymmetricTokenKey

Discriminador de tipos derivados.

keyValue

string

Valor de clave de la clave

ContentKeyPolicyTokenClaim

Representa una notificación de token.

Nombre Tipo Description
claimType

string

Tipo de notificación de token.

claimValue

string

Valor de notificación de token.

ContentKeyPolicyTokenRestriction

Representa una restricción de token. El token proporcionado debe coincidir con estos requisitos para la entrega correcta de licencias o claves.

Nombre Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyTokenRestriction

Discriminador de tipos derivados.

alternateVerificationKeys ContentKeyPolicyRestrictionTokenKey[]:

Lista de claves de verificación alternativas.

audience

string

Audiencia del token.

issuer

string

Emisor del token.

openIdConnectDiscoveryDocument

string

Documento de detección de Conexión de OpenID.

primaryVerificationKey ContentKeyPolicyRestrictionTokenKey:

Clave de comprobación principal.

requiredClaims

ContentKeyPolicyTokenClaim[]

Lista de notificaciones de token necesarias.

restrictionTokenType

ContentKeyPolicyRestrictionTokenType

Tipo de token.

ContentKeyPolicyUnknownConfiguration

Representa una contentKeyPolicyConfiguration que no está disponible en la versión actual de la API.

Nombre Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownConfiguration

Discriminador de tipos derivados.

ContentKeyPolicyUnknownRestriction

Representa una contentKeyPolicyRestriction que no está disponible en la versión actual de la API.

Nombre Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownRestriction

Discriminador de tipos derivados.

ContentKeyPolicyWidevineConfiguration

Especifica una configuración para las licencias de Widevine.

Nombre Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyWidevineConfiguration

Discriminador de tipos derivados.

widevineTemplate

string

Plantilla de Widevine.

ContentKeyPolicyX509CertificateTokenKey

Especifica un certificado para la validación de tokens.

Nombre Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyX509CertificateTokenKey

Discriminador de tipos derivados.

rawBody

string

El campo de datos sin procesar de un certificado en formato PKCS 12 (X509Certificate2 en .NET)

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Los detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

SecurityLevel

Nivel de seguridad.

Nombre Tipo Description
SL150

string

Para los clientes en desarrollo o pruebas. Sin protección contra el uso no autorizado.

SL2000

string

Para dispositivos y aplicaciones protegidos que consumen contenido comercial. Protección de software o hardware.

SL3000

string

Solo para dispositivos protegidos. Protección de hardware.

Unknown

string

Representa un securityLevel que no está disponible en la versión actual de la API.