One Click Multi DRM 개요

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

One Click Multi DRM은 동영상 콘텐츠의 불법 복제 및 유통을 방지하기 위해 동영상을 암호화하여 저장하고 전송하는 네이버 클라우드 플랫폼의 서비스입니다. 주요 디지털 저작권 관리(DRM) 시스템을 모두 지원하여 기기와 플랫폼에 상관없이 동영상 콘텐츠를 안전하게 재생할 수 있으며, 암호화/복호화 키를 발급하고 관리할 수 있습니다. One Click Multi DRM 서비스에서는 사이트 관리, 라이선스 발급, DRM 정책 관리 등 다양한 DRM 관련 기능을 RESTful API 형태로 제공합니다.

One Click Multi DRM 공통 설정

One Click Multi DRM API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

https://multi-drm.apigw.ntruss.com

요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
x-ncp-apigw-timestamp Required 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초)
  • API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주
  • Unix Timestamp 형식
x-ncp-iam-access-key Required 네이버 클라우드 플랫폼에서 발급받은 Access Key
x-ncp-apigw-signature-v2 Required 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명
Content-Type Required 요청 데이터의 형식
  • application/json
x-ncp-region_code Required 리전 코드
  • KR: 한국 (유효 값)
x-drm-token Conditional DRM 토큰
  • 라이선스 발급의 필수 데이터가 포함된 토큰 값
  • 라이선스 발급 및 클라이언트 연동 시 필수 입력

응답

공통 응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

error

error는 API 호출 실패 정보를 정의합니다. error에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
error Object - 오류 코드 및 메시지
error.code String Required 오류 코드
error.name String Required 오류 이름
error.message String Required 오류 메시지

응답 상태 코드

One Click Multi DRM API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 다음을 참조해 주십시오.

응답 예시

호출이 성공한 경우의 응답 예시는 각 API 명세에서 확인해 주십시오. 호출이 실패한 경우의 응답 예시는 다음과 같습니다.

{
    "success": false,
    "error": {
        "code": 280000,
        "name": "EXCEPTION",
        "message": "Exception occurred, please try again later."
    }
}

One Click Multi DRM API

One Click Multi DRM 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

Encryption

Encryption 관련 API에 대한 설명은 다음과 같습니다.

API 설명
DRM 콘텐츠 암호화 DRM 콘텐츠 암호화

Site

Site 관련 API에 대한 설명은 다음과 같습니다.

API 설명
사이트 생성 One Click Multi DRM 사이트 생성
사이트 로그 조회 One Click Multi DRM 사이트에서 발생한 이벤트 로그 조회
사이트 목록 조회 One Click Multi DRM 사이트 목록 조회
사이트 조회 One Click Multi DRM 사이트 상세 정보 조회
사이트 수정 One Click Multi DRM 사이트 정보 수정
사이트 비활성화 One Click Multi DRM 사이트 비활성화
사이트 활성화 One Click Multi DRM 사이트 활성화

License

License 관련 API에 대한 설명은 다음과 같습니다.

API 설명
라이선스 발급(FairPlay) FairPlay Streaming 타입 라이선스 발급
라이선스 발급(Widevine, PlayReady) Widevine, PlayReady 타입 라이선스 발급
라이선스 발급 이력 조회 사이트에서 발급한 라이선스 이력 조회
라이선스 클라이언트 연동 클라이언트(플레이어)에 라이선스 연동

DRM Policy

DRM Policy 관련 API에 대한 설명은 다음과 같습니다.

API 설명
정책 생성 DRM 정책 생성
정책 복제 기존 DRM 정책을 복제하여 새 정책 생성
정책 로그 조회 DRM 정책에서 발생한 이벤트 로그 조회
정책 목록 조회 DRM 정책 목록 조회
정책 조회 DRM 정책 상세 정보 조회
정책 수정 DRM 정책 정보 수정
정책 삭제 DRM 정책 삭제

One Click Multi DRM 연관 리소스

One Click Multi DRM API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.