Policy 목록 조회

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

One Click Multi DRM 라이선스 발급에 필요한 Policy 목록을 조회하는 API입니다.

요청

GET https://multi-drm.apigw.gov-ntruss.com/api/v1/policy?pageNo={pageNo}&pageSizeNo={pageSizeNo}

요청 파라미터

파라미터명	필수 여부	타입	제약 사항	설명
pageNo	No	Integer	제약 없음	조회 할 페이지 인덱스
pageSizeNo	No	Integer	1~100	목록 조회 시 포함될 Policy 수 예시) 생성된 Policy 가 60개일 때, pageSizeNo 30 이라면 페이지당 30개씩 Policy 목록 조회

요청 헤더

헤더명	필수 여부	설명
x-ncp-apigw-timestamp	YES	1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타냄 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 `x-ncp-apigw-timestamp:{Timestamp}`
x-ncp-iam-access-key	YES	네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값 `x-ncp-iam-access-key:{Sub Account Access Key}`
x-ncp-apigw-signature-v2	YES	Access Key ID 값과 Secret Key로 암호화한 서명 `x-ncp-apigw-signature-v2:{API Gateway Signature}`
Content-Type	YES	Request body content type을 application/json으로 지정 `Content-Type: application/json`
x-ncp-region_code	YES	리전 코드 (KR)

응답

필드명	타입	필수 여부	제약	설명
policyName	String	Y
policyStatus	String	Y	CREATING READY DELETED UPDATING	Policy 상태
policyId	Integer	Y	default Policy : 0	생성된 PolicyId
policyCreatedTime	Timestamp	N		Policy 생성 시각
policyUpdateTime	Timestamp	N		Policy 설정 변경 시각
persistent	Boolean	Y	기본값 : false	오프라인용 라이선스 저장 여부 true : 라이선스 유지, false : 재생 후 라이선스 제거(스트리밍)
rentalDuration	Integer	Y	기본값 : 0 0-2,147,483,647	오프라인 렌탈 시나리오 사용 시 설정 (해당 옵션 사용시 persistent : true 설정 필요) 다운로드 후 최초 재생 시작 시점까지 라이선스 유효 기간 (단위: 초)
playbackDuration	Integer	Y	기본값: 0 0-2,147,483,647	최초 재생 시작 시점 이후부터의 라이선스 유효 기간 (단위: 초)
drmPolicyConfig	Object[Array]	Y		drm type 별 policy 상세 설정
drmPolicyConfig{}.wideVine	Object	N		Widevine 의 policy
drmPolicyConfig{}.wideVine{}.useYn	Boolean	N		Widevine 의 policy 설정 적용 유무
drmPolicyConfig{}.wideVine{}.securityLevel	Integer	N	1:SW_SECURE_CRYPTO 2:SW_SECURE_DECODE 3:HW_SECURE_CRYPTO 4:HW_SECURE_DECODE 5:HW_SECURE_ALL	해당 트랙에 대한 Widevine security level 설정 1:SW_SECURE_CRYPTO 2:SW_SECURE_DECODE 3:HW_SECURE_CRYPTO 4:HW_SECURE_DECODE 5:HW_SECURE_ALL - 5로 설정하면 Widevine L1 기기에서만 재생 가능
drmPolicyConfig{}.wideVine{}.hdcp	String	N	HDCP_NONE HDCP_V1 HDCP_V2 HDCP_V2_1 HDCP_V2_2 HDCP_NO_DIGITAL_OUTPUT	디지털 출력에 대한 보안(HDCP) 레벨 설정 입력값: “HDCP_NONE”, “HDCP_V1”, “HDCP_V2”, “HDCP_V2_1”, “HDCP_V2_2”, “HDCP_NO_DIGITAL_OUTPUT” 중 하나
drmPolicyConfig{}.wideVine{}.cgms	String	N	CGMS_NONE COPY_FREE COPY_ONCE COPY_NEVER	아날로그 출력에 대한 보안(CGMS-A) 레벨 설정- 입력값: “CGMS_NONE”, “COPY_FREE”, “COPY_ONCE”, “COPY_NEVER” 중 하나
drmPolicyConfig{}.wideVine{}.disableAnalogOutputYn	Boolean	N		아날로그 출력 허용 여부 (false: 아날로그 출력 허용)
drmPolicyConfig{}.wideVine{}.hdcpSrmRule	String	N	HDCP_SRM_RULE_NONE CURRENT_SRM	HDCP 기기가 SRM(System Renewability Message)을 처리하지 못하는 경우에 해당 트랙의 재생 여부 설정. CURRENT_SRM: 최신 SRM 적용 안되는 기기에서는 해당 트랙 재생 안됨입력값: “HDCP_SRM_RULE_NONE”, “CURRENT_SRM” 중 하나
drmPolicyConfig{}.wideVine{}.deviceRevocation	Boolean	N		Revoke(Widevine 지원 대상에서 철회)된 안드로이드 기기에 대한 라이선스 발급 허용 여부 (기본값: 발급 허용하지 않음)
drmConfig{}.playReady	Object	N		PlayReady 의 policy
drmConfig{}.playReady{}.useYn	Boolean	N		PlayReady 의 policy 설정 적용 유무
drmConfig{}.playReady{}.securityLevel	Integer	N	150 2000 3000	해당 트랙에 대한 PlayReady security level 150, 2000, 3000 하드웨어 DRM 적용 시 3000으로 설정.
drmConfig{}.playReady{}.digitalVideoProtectionLevel	Integer	N	100 250 270 300 301	디지털 비디오 출력에 대한 보안 레벨 설정 (100, 250, 270, 300, 301)
drmConfig{}.playReady{}.analogVideoProtectionLevel	Integer	N	100 150 200 201	아날로그 비디오 출력에 대한 보안 레벨 설정 (100, 150, 200, 201)
drmConfig{}.playReady{}.digitalAudioProtectionLevel	Integer	N	100 250 300 301	디지털 오디오 출력에 대한 보안 레벨 설정 (100, 250, 300, 301)
drmConfig{}.playReady{}.hdcpUseYn	Boolean	N		OPL 설정에 따라 HDCP가 적용될 때, Type 1(HDCP V2.2 이상)이 요구되는지 여부를 설정 (true 설정 시 HDCP 2.2 이상 필요)
drmConfig{}.fairPlay	Object	N		FairPlay Streaming 의 policy
drmConfig{}.fairPlay{}.useYn	Boolean	Y		FairPlay Streaming 의 policy 설정 적용 유무
drmConfig{}.fairPlay{}.hdcpEnforcement	String	N	-1 (HDCP 미적용) 0 (HDCP Type 0(버전 무관)) 1 (HDCP Type 1(2.2 이상 필요))	해당 트랙에 대한 HDCP 적용 여부 및 HDCP 버전 -1: HDCP 미적용 0: HDCP Type 0(버전 무관) 1: HDCP Type 1(2.2 이상 필요)
drmConfig{}.fairPlay{}.allowAirPlay	Boolean	N		AirPlay 허용 여부
drmConfig{}.fairPlay{}.allowAvAdaptor	Boolean	N		디지털 AV 어댑터를 통한 출력 허용 여부

예시

응답 예시

HTTP/1.1 200 OK
Server: nginx
Date: Fri, 20 Nov 2023 19:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
  "success": true,
  "content": {
    "policyId": 123,
    "policyName": "mySamplePolicy",
    "policyStatus": "READY",
    "policyCreatedTime": 1700480181622,
    "policyUpdateTime": 1700480181634,
    "persistent": true,
    "rentalDuration": 0,
    "playbackDuration": 0,
    "drmPolicyConfig": {
      "wideVine": {
        "useYn": true,
        "securityLevel": 1,
        "hdcp": "HDCP_NONE",
        "cgms": "CGMS_NONE",
        "disableAnalogOutputYn": true,
        "hdcpSrmRule": "HDCP_SRM_RULE_NONE",
        "deviceRevocation": true
      },
      "playReady": {
        "useYn": true,
        "securityLevel": 150,
        "digitalVideoProtectionLevel": 100,
        "analogVideoProtectionLevel": 100,
        "digitalAudioProtectionLevel": 100,
        "hdcpUseYn": true
      },
      "fairPlay": {
        "useYn": false
      }
    }
  },
    {
      "policyId": 30,
      "policyName": "policy_1",
      "policyStatus": "CREATED",
      "policyCreatedTime": 1698908460802,
      "policyUpdateTime": 1700481601001,
      "persistent": false,
      "rentalDuration": 0,
      "playbackDuration": 0,
      "drmPolicyConfig": {
        "wideVine": {
          "useYn": true,
          "securityLevel": 2,
          "hdcp": "HDCP_V1",
          "cgms": "COPY_FREE",
          "disableAnalogOutputYn": false,
          "hdcpSrmRule": "CURRENT_SRM",
          "deviceRevocation": false
        },
        "playReady": {
          "useYn": true,
          "securityLevel": 2000,
          "digitalVideoProtectionLevel": 250,
          "analogVideoProtectionLevel": 150,
          "digitalAudioProtectionLevel": 250,
          "hdcpUseYn": false
        },
        "fairPlay": {
          "useYn": true,
          "hdcpEnforcement": 0,
          "allowAirPlay": false,
          "allowAvAdaptor": false
        }
      }
    }
    .....
}

이 문서가 도움이 되었습니까?

What's Next

Policy 로그 조회

요청
응답
예시