Content Key Policies - Get Policy Properties With Secrets

비밀로 콘텐츠 키 정책 가져오기
비밀 값을 포함한 콘텐츠 키 정책 가져오기

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
accountName
path True

string

Media Services 계정 이름입니다.

contentKeyPolicyName
path True

string

콘텐츠 키 정책 이름입니다.

resourceGroupName
path True

string

Azure 구독 내 리소스 그룹의 이름입니다.

subscriptionId
path True

string

Microsoft Azure 구독의 고유 식별자입니다.

api-version
query True

string

클라이언트 요청과 함께 사용할 API의 버전입니다.

응답

Name 형식 Description
200 OK

ContentKeyPolicyProperties

정상

Other Status Codes

ErrorResponse

자세한 오류 정보입니다.

예제

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

정의

Name Description
ContentKeyPolicyClearKeyConfiguration

DRM이 아닌 키에 대한 구성을 나타냅니다.

ContentKeyPolicyFairPlayConfiguration

FairPlay 라이선스에 대한 구성을 지정합니다.

ContentKeyPolicyFairPlayOfflineRentalConfiguration
ContentKeyPolicyFairPlayRentalAndLeaseKeyType

임대 및 임대 키 유형입니다.

ContentKeyPolicyOpenRestriction

열린 제한을 나타냅니다. 라이선스 또는 키는 모든 요청에 따라 전달됩니다.

ContentKeyPolicyOption

정책 옵션을 나타냅니다.

ContentKeyPolicyPlayReadyConfiguration

PlayReady 라이선스에 대한 구성을 지정합니다.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

콘텐츠 키 ID가 PlayReady 헤더에 있는지 지정합니다.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

콘텐츠 키 ID가 PlayReady 구성에 지정되도록 지정합니다.

ContentKeyPolicyPlayReadyContentType

PlayReady 콘텐츠 형식입니다.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

명시적 아날로그 텔레비전 출력 제한 제어 비트를 구성합니다. 자세한 내용은 PlayReady 준수 규칙을 참조하세요.

ContentKeyPolicyPlayReadyLicense

PlayReady 라이선스

ContentKeyPolicyPlayReadyLicenseType

라이선스 유형입니다.

ContentKeyPolicyPlayReadyPlayRight

PlayReady 라이선스에서 Play Right를 구성합니다.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

라이선스의 알 수 없는 출력 처리 설정을 구성합니다.

ContentKeyPolicyProperties

콘텐츠 키 정책의 속성입니다.

ContentKeyPolicyRestrictionTokenType

토큰의 형식입니다.

ContentKeyPolicyRsaTokenKey

토큰 유효성 검사에 대한 RSA 키를 지정합니다.

ContentKeyPolicySymmetricTokenKey

토큰 유효성 검사를 위한 대칭 키를 지정합니다.

ContentKeyPolicyTokenClaim

토큰 클레임을 나타냅니다.

ContentKeyPolicyTokenRestriction

토큰 제한을 나타냅니다. 제공된 토큰은 성공적인 라이선스 또는 키 배달을 위해 이러한 요구 사항과 일치해야 합니다.

ContentKeyPolicyUnknownConfiguration

현재 API 버전에서 사용할 수 없는 ContentKeyPolicyConfiguration을 나타냅니다.

ContentKeyPolicyUnknownRestriction

현재 API 버전에서 사용할 수 없는 ContentKeyPolicyRestriction을 나타냅니다.

ContentKeyPolicyWidevineConfiguration

Widevine 라이선스에 대한 구성을 지정합니다.

ContentKeyPolicyX509CertificateTokenKey

토큰 유효성 검사에 대한 인증서를 지정합니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

SecurityLevel

보안 수준입니다.

ContentKeyPolicyClearKeyConfiguration

DRM이 아닌 키에 대한 구성을 나타냅니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration

파생 형식에 대한 판별자입니다.

ContentKeyPolicyFairPlayConfiguration

FairPlay 라이선스에 대한 구성을 지정합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyFairPlayConfiguration

파생 형식에 대한 판별자입니다.

ask

string

FairPlay 애플리케이션 비밀 키로 사용해야 하는 키입니다. 이는 base64로 인코딩되어야 합니다.

fairPlayPfx

string

PKCS 12(pfx) 형식(프라이빗 키 포함)으로 FairPlay 인증서의 Base64 표현입니다.

fairPlayPfxPassword

string

PKCS 12(pfx) 형식의 FairPlay 인증서를 암호화하는 암호입니다.

offlineRentalConfiguration

ContentKeyPolicyFairPlayOfflineRentalConfiguration

오프라인 임대 정책

rentalAndLeaseKeyType

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

임대 및 임대 키 유형입니다.

rentalDuration

integer

대여 기간입니다. 0보다 크거나 같아야 합니다.

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Name 형식 Description
playbackDurationSeconds

integer

재생 기간

storageDurationSeconds

integer

스토리지 기간

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

임대 및 임대 키 유형입니다.

Name 형식 Description
DualExpiry

string

오프라인 임대에 대한 이중 만료.

PersistentLimited

string

콘텐츠 키를 유지할 수 있으며 유효한 기간은 임대 기간 값으로 제한됩니다.

PersistentUnlimited

string

콘텐츠 키는 무제한으로 유지할 수 있습니다.

Undefined

string

키 기간이 지정되지 않았습니다.

Unknown

string

현재 API 버전에서 사용할 수 없는 ContentKeyPolicyFairPlayRentalAndLeaseKeyType을 나타냅니다.

ContentKeyPolicyOpenRestriction

열린 제한을 나타냅니다. 라이선스 또는 키는 모든 요청에 따라 전달됩니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyOpenRestriction

파생 형식에 대한 판별자입니다.

ContentKeyPolicyOption

정책 옵션을 나타냅니다.

Name 형식 Description
configuration ContentKeyPolicyConfiguration:

키 배달 구성입니다.

name

string

정책 옵션 설명입니다.

policyOptionId

string

레거시 정책 옵션 ID입니다.

restriction ContentKeyPolicyRestriction:

이 구성을 사용하여 키를 제공하기 위해 충족해야 하는 요구 사항

ContentKeyPolicyPlayReadyConfiguration

PlayReady 라이선스에 대한 구성을 지정합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyConfiguration

파생 형식에 대한 판별자입니다.

licenses

ContentKeyPolicyPlayReadyLicense[]

PlayReady 라이선스.

responseCustomData

string

사용자 지정 응답 데이터입니다.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

콘텐츠 키 ID가 PlayReady 헤더에 있는지 지정합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

파생 형식에 대한 판별자입니다.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

콘텐츠 키 ID가 PlayReady 구성에 지정되도록 지정합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

파생 형식에 대한 판별자입니다.

keyId

string

콘텐츠 키 ID입니다.

ContentKeyPolicyPlayReadyContentType

PlayReady 콘텐츠 형식입니다.

Name 형식 Description
UltraVioletDownload

string

자외선 다운로드 콘텐츠 형식입니다.

UltraVioletStreaming

string

자외선 스트리밍 콘텐츠 형식입니다.

Unknown

string

현재 API 버전에서 사용할 수 없는 ContentKeyPolicyPlayReadyContentType을 나타냅니다.

Unspecified

string

지정되지 않은 콘텐츠 형식입니다.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

명시적 아날로그 텔레비전 출력 제한 제어 비트를 구성합니다. 자세한 내용은 PlayReady 준수 규칙을 참조하세요.

Name 형식 Description
bestEffort

boolean

이 제한이 최선의 노력을 기준으로 적용되는지 여부를 나타냅니다.

configurationData

integer

제한 컨트롤 비트를 구성합니다. 0에서 3 사이여야 합니다.

ContentKeyPolicyPlayReadyLicense

PlayReady 라이선스

Name 형식 Description
allowTestDevices

boolean

테스트 디바이스에서 라이선스를 사용할 수 있는지 여부를 나타내는 플래그입니다.

beginDate

string

라이선스 시작 날짜

contentKeyLocation ContentKeyPolicyPlayReadyContentKeyLocation:

콘텐츠 키 위치입니다.

contentType

ContentKeyPolicyPlayReadyContentType

PlayReady 콘텐츠 형식입니다.

expirationDate

string

라이선스의 만료 날짜입니다.

gracePeriod

string

라이선스의 유예 기간입니다.

licenseType

ContentKeyPolicyPlayReadyLicenseType

라이선스 유형입니다.

playRight

ContentKeyPolicyPlayReadyPlayRight

라이선스 PlayRight

relativeBeginDate

string

라이선스의 상대 시작 날짜입니다.

relativeExpirationDate

string

라이선스의 상대 만료 날짜입니다.

securityLevel

SecurityLevel

보안 수준입니다.

ContentKeyPolicyPlayReadyLicenseType

라이선스 유형입니다.

Name 형식 Description
NonPersistent

string

비영구 라이선스.

Persistent

string

영구 라이선스. 오프라인 재생을 허용합니다.

Unknown

string

현재 API 버전에서 사용할 수 없는 ContentKeyPolicyPlayReadyLicenseType을 나타냅니다.

ContentKeyPolicyPlayReadyPlayRight

PlayReady 라이선스에서 Play Right를 구성합니다.

Name 형식 Description
agcAndColorStripeRestriction

integer

라이선스에서 AGC(자동 게인 제어) 및 Color Stripe를 구성합니다. 0에서 3 사이여야 합니다.

allowPassingVideoContentToUnknownOutput

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

라이선스의 알 수 없는 출력 처리 설정을 구성합니다.

analogVideoOpl

integer

압축된 디지털 오디오의 출력 보호 수준을 지정합니다.

compressedDigitalAudioOpl

integer

압축된 디지털 오디오의 출력 보호 수준을 지정합니다.

compressedDigitalVideoOpl

integer

압축된 디지털 비디오의 출력 보호 수준을 지정합니다.

digitalVideoOnlyContentRestriction

boolean

라이선스에서 아날로그 구성 요소 비디오 제한에 대한 이미지 제약 조건을 사용하도록 설정합니다.

explicitAnalogTelevisionOutputRestriction

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

라이선스에 명시적 아날로그 텔레비전 출력 제한을 구성합니다. 구성 데이터는 0에서 3 사이여야 합니다.

firstPlayExpiration

string

라이선스가 콘텐츠를 재생하는 데 처음 사용된 후 라이선스가 유효한 시간입니다.

imageConstraintForAnalogComponentVideoRestriction

boolean

라이선스에서 아날로그 구성 요소 비디오 제한에 대한 이미지 제약 조건을 사용하도록 설정합니다.

imageConstraintForAnalogComputerMonitorRestriction

boolean

라이선스에서 아날로그 구성 요소 비디오 제한에 대한 이미지 제약 조건을 사용하도록 설정합니다.

scmsRestriction

integer

라이선스에서 SCMS(직렬 복사 관리 시스템)를 구성합니다. 0에서 3 사이여야 합니다.

uncompressedDigitalAudioOpl

integer

압축되지 않은 디지털 오디오의 출력 보호 수준을 지정합니다.

uncompressedDigitalVideoOpl

integer

압축되지 않은 디지털 비디오의 출력 보호 수준을 지정합니다.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

라이선스의 알 수 없는 출력 처리 설정을 구성합니다.

Name 형식 Description
Allowed

string

보호된 콘텐츠의 비디오 부분을 알 수 없는 출력에 전달할 수 있습니다.

AllowedWithVideoConstriction

string

보호된 콘텐츠의 비디오 부분을 알 수 없는 출력에 전달할 수 있지만 해상도가 제한됩니다.

NotAllowed

string

보호된 콘텐츠의 비디오 부분을 알 수 없는 출력에 전달할 수 없습니다.

Unknown

string

현재 API 버전에서 사용할 수 없는 ContentKeyPolicyPlayReadyUnknownOutputPassingOption을 나타냅니다.

ContentKeyPolicyProperties

콘텐츠 키 정책의 속성입니다.

Name 형식 Description
created

string

정책을 만든 날짜입니다.

description

string

정책에 대한 설명입니다.

lastModified

string

정책을 마지막으로 수정한 날짜입니다.

options

ContentKeyPolicyOption[]

키 정책 옵션입니다.

policyId

string

레거시 정책 ID입니다.

ContentKeyPolicyRestrictionTokenType

토큰의 형식입니다.

Name 형식 Description
Jwt

string

JSON 웹 토큰.

Swt

string

단순 웹 토큰입니다.

Unknown

string

현재 API 버전에서 사용할 수 없는 ContentKeyPolicyRestrictionTokenType을 나타냅니다.

ContentKeyPolicyRsaTokenKey

토큰 유효성 검사에 대한 RSA 키를 지정합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyRsaTokenKey

파생 형식에 대한 판별자입니다.

exponent

string

RSA 매개 변수 지수

modulus

string

RSA 매개 변수 모듈러스

ContentKeyPolicySymmetricTokenKey

토큰 유효성 검사를 위한 대칭 키를 지정합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicySymmetricTokenKey

파생 형식에 대한 판별자입니다.

keyValue

string

키의 키 값

ContentKeyPolicyTokenClaim

토큰 클레임을 나타냅니다.

Name 형식 Description
claimType

string

토큰 클레임 유형입니다.

claimValue

string

토큰 클레임 값입니다.

ContentKeyPolicyTokenRestriction

토큰 제한을 나타냅니다. 제공된 토큰은 성공적인 라이선스 또는 키 배달을 위해 이러한 요구 사항과 일치해야 합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyTokenRestriction

파생 형식에 대한 판별자입니다.

alternateVerificationKeys ContentKeyPolicyRestrictionTokenKey[]:

대체 확인 키 목록입니다.

audience

string

토큰의 대상 그룹입니다.

issuer

string

토큰 발급자입니다.

openIdConnectDiscoveryDocument

string

OpenID 연결 검색 문서입니다.

primaryVerificationKey ContentKeyPolicyRestrictionTokenKey:

기본 확인 키입니다.

requiredClaims

ContentKeyPolicyTokenClaim[]

필요한 토큰 클레임 목록입니다.

restrictionTokenType

ContentKeyPolicyRestrictionTokenType

토큰의 형식입니다.

ContentKeyPolicyUnknownConfiguration

현재 API 버전에서 사용할 수 없는 ContentKeyPolicyConfiguration을 나타냅니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownConfiguration

파생 형식에 대한 판별자입니다.

ContentKeyPolicyUnknownRestriction

현재 API 버전에서 사용할 수 없는 ContentKeyPolicyRestriction을 나타냅니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownRestriction

파생 형식에 대한 판별자입니다.

ContentKeyPolicyWidevineConfiguration

Widevine 라이선스에 대한 구성을 지정합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyWidevineConfiguration

파생 형식에 대한 판별자입니다.

widevineTemplate

string

Widevine 템플릿입니다.

ContentKeyPolicyX509CertificateTokenKey

토큰 유효성 검사에 대한 인증서를 지정합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyX509CertificateTokenKey

파생 형식에 대한 판별자입니다.

rawBody

string

PKCS 12 형식의 인증서 원시 데이터 필드(.NET의 X509Certificate2)

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

Error 개체.

SecurityLevel

보안 수준입니다.

Name 형식 Description
SL150

string

개발 또는 테스트 중인 클라이언트의 경우. 무단 사용에 대한 보호가 없습니다.

SL2000

string

상업용 콘텐츠를 사용하는 강화된 디바이스 및 애플리케이션의 경우. 소프트웨어 또는 하드웨어 보호.

SL3000

string

강화된 디바이스에만 해당합니다. 하드웨어 보호.

Unknown

string

현재 API 버전에서 사용할 수 없는 SecurityLevel을 나타냅니다.