Partilhar via


Content Key Policies - Get Policy Properties With Secrets

Obter uma Política de Chave de Conteúdo com segredos
Obter uma Política de Chave de Conteúdo, incluindo 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 do URI

Name Em Necessário Tipo Description
accountName
path True

string

O nome da conta dos Serviços de Multimédia.

contentKeyPolicyName
path True

string

O nome da Política de Chave de Conteúdo.

resourceGroupName
path True

string

O nome do grupo de recursos na subscrição do Azure.

subscriptionId
path True

string

O identificador exclusivo de uma subscrição do Microsoft Azure.

api-version
query True

string

A versão da API a ser utilizada com o pedido de cliente.

Respostas

Name Tipo Description
200 OK

ContentKeyPolicyProperties

OK

Other Status Codes

ErrorResponse

Informações detalhadas sobre o erro.

Exemplos

Get an Content Key Policy with secrets

Pedido de amostra

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

Resposta da amostra

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

Definições

Name Description
ContentKeyPolicyClearKeyConfiguration

Representa uma configuração para chaves não DRM.

ContentKeyPolicyFairPlayConfiguration

Especifica uma configuração para licenças do FairPlay.

ContentKeyPolicyFairPlayOfflineRentalConfiguration
ContentKeyPolicyFairPlayRentalAndLeaseKeyType

O tipo de chave de aluguer e concessão.

ContentKeyPolicyOpenRestriction

Representa uma restrição aberta. A licença ou chave será entregue em todos os pedidos.

ContentKeyPolicyOption

Representa uma opção de política.

ContentKeyPolicyPlayReadyConfiguration

Especifica uma configuração para licenças PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Especifica que o ID da chave de conteúdo está no cabeçalho PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Especifica que o ID da chave de conteúdo é especificado na configuração PlayReady.

ContentKeyPolicyPlayReadyContentType

O tipo de conteúdo PlayReady.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configura os bits de controlo Restrição de Saída de Televisão Analógica Explícita. Para obter mais detalhes, veja As Regras de Conformidade do PlayReady.

ContentKeyPolicyPlayReadyLicense

A licença PlayReady

ContentKeyPolicyPlayReadyLicenseType

O tipo de licença.

ContentKeyPolicyPlayReadyPlayRight

Configura o Play Right na licença PlayReady.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Configura as definições de processamento de saída desconhecidas da licença.

ContentKeyPolicyProperties

As propriedades da Política de Chave de Conteúdo.

ContentKeyPolicyRestrictionTokenType

O tipo de token.

ContentKeyPolicyRsaTokenKey

Especifica uma chave RSA para validação de tokens

ContentKeyPolicySymmetricTokenKey

Especifica uma chave simétrica para validação de tokens.

ContentKeyPolicyTokenClaim

Representa uma afirmação de token.

ContentKeyPolicyTokenRestriction

Representa uma restrição de tokens. O token fornecido tem de corresponder a estes requisitos para a entrega com êxito da licença ou da chave.

ContentKeyPolicyUnknownConfiguration

Representa uma ContentKeyPolicyConfiguration que não está disponível na versão atual da API.

ContentKeyPolicyUnknownRestriction

Representa uma ContentKeyPolicyRestriction que não está disponível na versão atual da API.

ContentKeyPolicyWidevineConfiguration

Especifica uma configuração para licenças widevine.

ContentKeyPolicyX509CertificateTokenKey

Especifica um certificado para validação de tokens.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta a erros

SecurityLevel

O nível de segurança.

ContentKeyPolicyClearKeyConfiguration

Representa uma configuração para chaves não DRM.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration

O discriminador para tipos derivados.

ContentKeyPolicyFairPlayConfiguration

Especifica uma configuração para licenças do FairPlay.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyFairPlayConfiguration

O discriminador para tipos derivados.

ask

string

A chave que tem de ser utilizada como chave do Segredo da Aplicação FairPlay. Isto tem de ser codificado com base64.

fairPlayPfx

string

A representação Base64 do certificado FairPlay no formato PKCS 12 (pfx) (incluindo chave privada).

fairPlayPfxPassword

string

A palavra-passe que encripta o certificado FairPlay no formato PKCS 12 (pfx).

offlineRentalConfiguration

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Política de aluguer offline

rentalAndLeaseKeyType

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

O tipo de chave de aluguer e concessão.

rentalDuration

integer

A duração do aluguer. Tem de ser maior ou igual a 0.

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Name Tipo Description
playbackDurationSeconds

integer

Duração da reprodução

storageDurationSeconds

integer

Duração do armazenamento

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

O tipo de chave de aluguer e concessão.

Name Tipo Description
DualExpiry

string

Expiração dupla para aluguer offline.

PersistentLimited

string

A chave de conteúdo pode ser mantida e a duração válida é limitada pelo valor Duração do Aluguer

PersistentUnlimited

string

A chave de conteúdo pode ser mantida com uma duração ilimitada

Undefined

string

A duração da chave não é especificada.

Unknown

string

Representa um ContentKeyPolicyFairPlayRentalAndLeaseKeyType que não está disponível na versão atual da API.

ContentKeyPolicyOpenRestriction

Representa uma restrição aberta. A licença ou chave será entregue em todos os pedidos.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyOpenRestriction

O discriminador para tipos derivados.

ContentKeyPolicyOption

Representa uma opção de política.

Name Tipo Description
configuration ContentKeyPolicyConfiguration:

A configuração da entrega da chave.

name

string

A descrição da Opção de Política.

policyOptionId

string

O ID da Opção de Política legado.

restriction ContentKeyPolicyRestriction:

Os requisitos que têm de ser cumpridos para entregar chaves com esta configuração

ContentKeyPolicyPlayReadyConfiguration

Especifica uma configuração para licenças PlayReady.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyConfiguration

O discriminador para tipos derivados.

licenses

ContentKeyPolicyPlayReadyLicense[]

As licenças do PlayReady.

responseCustomData

string

Os dados de resposta personalizados.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Especifica que o ID da chave de conteúdo está no cabeçalho PlayReady.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

O discriminador para tipos derivados.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Especifica que o ID da chave de conteúdo é especificado na configuração PlayReady.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

O discriminador para tipos derivados.

keyId

string

O ID da chave de conteúdo.

ContentKeyPolicyPlayReadyContentType

O tipo de conteúdo PlayReady.

Name Tipo Description
UltraVioletDownload

string

Tipo de conteúdo de transferência ultravioleta.

UltraVioletStreaming

string

Tipo de conteúdo de transmissão em fluxo ultravioleta.

Unknown

string

Representa um ContentKeyPolicyPlayReadyContentType indisponível na versão atual da API.

Unspecified

string

Tipo de conteúdo não especificado.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configura os bits de controlo Restrição de Saída de Televisão Analógica Explícita. Para obter mais detalhes, veja As Regras de Conformidade do PlayReady.

Name Tipo Description
bestEffort

boolean

Indica se esta restrição é imposta numa base de Melhor Esforço.

configurationData

integer

Configura os bits de controlo de restrição. Tem de estar entre 0 e 3 inclusive.

ContentKeyPolicyPlayReadyLicense

A licença PlayReady

Name Tipo Description
allowTestDevices

boolean

Um sinalizador que indica se os dispositivos de teste podem utilizar a licença.

beginDate

string

A data de início da licença

contentKeyLocation ContentKeyPolicyPlayReadyContentKeyLocation:

A localização da chave de conteúdo.

contentType

ContentKeyPolicyPlayReadyContentType

O tipo de conteúdo PlayReady.

expirationDate

string

A data de expiração da licença.

gracePeriod

string

O período de tolerância da licença.

licenseType

ContentKeyPolicyPlayReadyLicenseType

O tipo de licença.

playRight

ContentKeyPolicyPlayReadyPlayRight

A licença PlayRight

relativeBeginDate

string

A data de início relativa da licença.

relativeExpirationDate

string

A data de expiração relativa da licença.

securityLevel

SecurityLevel

O nível de segurança.

ContentKeyPolicyPlayReadyLicenseType

O tipo de licença.

Name Tipo Description
NonPersistent

string

Licença não persistente.

Persistent

string

Licença persistente. Permite a reprodução offline.

Unknown

string

Representa um ContentKeyPolicyPlayReadyLicenseType indisponível na versão atual da API.

ContentKeyPolicyPlayReadyPlayRight

Configura o Play Right na licença PlayReady.

Name Tipo Description
agcAndColorStripeRestriction

integer

Configura o Controlo de Ganho Automático (AGC) e o Color Stripe na licença. Tem de estar entre 0 e 3 inclusive.

allowPassingVideoContentToUnknownOutput

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Configura as definições de processamento de saída desconhecidas da licença.

analogVideoOpl

integer

Especifica o nível de proteção de saída para áudio digital comprimido.

compressedDigitalAudioOpl

integer

Especifica o nível de proteção de saída para áudio digital comprimido.

compressedDigitalVideoOpl

integer

Especifica o nível de proteção de saída para vídeo digital comprimido.

digitalVideoOnlyContentRestriction

boolean

Ativa a Restrição de Imagem para a Restrição de Vídeo de Componente Analógico na licença.

explicitAnalogTelevisionOutputRestriction

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configura a Restrição de Saída de Televisão Analógica Explícita na licença. Os dados de configuração têm de estar entre 0 e 3 inclusive.

firstPlayExpiration

string

A quantidade de tempo em que a licença é válida após a licença ser utilizada pela primeira vez para reproduzir conteúdo.

imageConstraintForAnalogComponentVideoRestriction

boolean

Ativa a Restrição de Imagem para a Restrição de Vídeo de Componente Analógico na licença.

imageConstraintForAnalogComputerMonitorRestriction

boolean

Ativa a Restrição de Imagem para a Restrição de Vídeo de Componente Analógico na licença.

scmsRestriction

integer

Configura o Sistema de Gestão de Cópias de Série (SCMS) na licença. Tem de estar entre 0 e 3 inclusive.

uncompressedDigitalAudioOpl

integer

Especifica o nível de proteção de saída para áudio digital descomprimido.

uncompressedDigitalVideoOpl

integer

Especifica o nível de proteção de saída para vídeo digital descomprimido.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Configura as definições de processamento de saída desconhecidas da licença.

Name Tipo Description
Allowed

string

É permitida a transmissão da parte do vídeo de conteúdo protegido para uma Saída Desconhecida.

AllowedWithVideoConstriction

string

A transmissão da parte do vídeo de conteúdo protegido para uma Saída Desconhecida é permitida, mas com resolução restrita.

NotAllowed

string

Não é permitida a transmissão da parte do vídeo de conteúdo protegido para uma Saída Desconhecida.

Unknown

string

Representa um ContentKeyPolicyPlayReadyUnknownOutputPassingOption indisponível na versão atual da API.

ContentKeyPolicyProperties

As propriedades da Política de Chave de Conteúdo.

Name Tipo Description
created

string

A data de criação da Política

description

string

Uma descrição da Política.

lastModified

string

A data da última modificação da Política

options

ContentKeyPolicyOption[]

As opções da Política de Chaves.

policyId

string

O ID de Política legado.

ContentKeyPolicyRestrictionTokenType

O tipo de token.

Name Tipo Description
Jwt

string

Token Web JSON.

Swt

string

Token Web Simples.

Unknown

string

Representa um ContentKeyPolicyRestrictionTokenType indisponível na versão atual da API.

ContentKeyPolicyRsaTokenKey

Especifica uma chave RSA para validação de tokens

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyRsaTokenKey

O discriminador para tipos derivados.

exponent

string

O expoente do Parâmetro RSA

modulus

string

O módulo do Parâmetro RSA

ContentKeyPolicySymmetricTokenKey

Especifica uma chave simétrica para validação de tokens.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicySymmetricTokenKey

O discriminador para tipos derivados.

keyValue

string

O valor chave da chave

ContentKeyPolicyTokenClaim

Representa uma afirmação de token.

Name Tipo Description
claimType

string

Tipo de afirmação de token.

claimValue

string

Valor da afirmação de token.

ContentKeyPolicyTokenRestriction

Representa uma restrição de tokens. O token fornecido tem de corresponder a estes requisitos para a entrega com êxito da licença ou da chave.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyTokenRestriction

O discriminador para tipos derivados.

alternateVerificationKeys ContentKeyPolicyRestrictionTokenKey[]:

Uma lista de chaves de verificação alternativas.

audience

string

O público do token.

issuer

string

O emissor de tokens.

openIdConnectDiscoveryDocument

string

O documento de deteção de ligação OpenID.

primaryVerificationKey ContentKeyPolicyRestrictionTokenKey:

A chave de verificação primária.

requiredClaims

ContentKeyPolicyTokenClaim[]

Uma lista das afirmações de token necessárias.

restrictionTokenType

ContentKeyPolicyRestrictionTokenType

O tipo de token.

ContentKeyPolicyUnknownConfiguration

Representa uma ContentKeyPolicyConfiguration que não está disponível na versão atual da API.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownConfiguration

O discriminador para tipos derivados.

ContentKeyPolicyUnknownRestriction

Representa uma ContentKeyPolicyRestriction que não está disponível na versão atual da API.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownRestriction

O discriminador para tipos derivados.

ContentKeyPolicyWidevineConfiguration

Especifica uma configuração para licenças widevine.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyWidevineConfiguration

O discriminador para tipos derivados.

widevineTemplate

string

O modelo Widevine.

ContentKeyPolicyX509CertificateTokenKey

Especifica um certificado para validação de tokens.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyX509CertificateTokenKey

O discriminador para tipos derivados.

rawBody

string

O campo de dados não processados de um certificado no formato PKCS 12 (X509Certificate2 em .NET)

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta a erros

Name Tipo Description
error

ErrorDetail

O objeto de erro.

SecurityLevel

O nível de segurança.

Name Tipo Description
SL150

string

Para clientes em desenvolvimento ou teste. Nenhuma proteção contra utilização não autorizada.

SL2000

string

Para dispositivos e aplicações protegidos que consomem conteúdo comercial. Proteção contra software ou hardware.

SL3000

string

Apenas para dispositivos protegidos. Proteção contra hardware.

Unknown

string

Representa um SecurityLevel que não está disponível na versão atual da API.