FairPlay Streaming License 발급

Prev Next

One Click Multi DRM 상품을 통해 발행하는 라이선스 발급을 위한 API입니다.
본 가이드에서는 FairPlay Streaming 타입의 DRM 라이선스 발급 API 를 설명하며, Widevine 또는 PlayReady 타입 DRM 라이선스는 라이선스 발급 API 로 제공합니다.

참고

FairPlay Streaming 라이선스 발급 유의 사항은 다음과 같습니다.

  • FairPlay Streaming 라이선스 발급 전 사이트 수정 등을 통해 FPS 라이선스가 사전에 등록되어있어야 합니다.
  • One Click Multi DRM은 FPS 라이선스 발행 시 Binary 타입과 JSON 타입 라이선스 응답을 지원합니다.
  • 모든 라이선스 요청은 DRM 콘텐츠를 재생할 단말 기기 정보와 플레이어 구현을 통해 요청하셔야 합니다.
경고
  • Fairplay Streaming 라이선스 경우 1) 라이선스 요청 (POST /api/v1/license) 과 2) 라이선스 요청 처리를 위한 FPS 인증서 요청 (GET /api/v1/license/fairPlay) 모두 요청하셔야 합니다.
  • One Click Multi DRM 상품에서는 X-DRM-TOKEN 헤더의 유효성을 확인하며, 선택한 사이트 설정에 맞는 라이선스를 발급합니다. 만약 헤더 값이 유효하지 않으면 라이선스 발행이 되지 않습니다.
  • 라이선스 응답 유형은 플레이어의 라이선스 파싱 유형에 맞춰 선택 해주셔야 합니다.
    HTML5 플레이어와 같이 일반적인 멀티 DRM 연동만 지원하는 클라이언트에 대해서는 보통 ORIGINAL 로 라이선스 응답을 지원합니다.
  • One Click Multi DRM 상품에서는 FairPlay Streaming 인증서 등록을 지원하되, 신규 인증서 발급 기능을 지원하지 않습니다. FPS 인증서 발급은 Apple 사로부터 직접 획득해 주셔야 하며, 보다 자세한 사항은 FairPlay Streaming 인증서 발급 를 참고해 주십시오.
  • One Click Multi DRM 상품에 업로드한 FairPlay Streaming 인증서에 대해서는 유효성 체크를 지원하지 않습니다.
  • One Click Multi DRM 라이선스 요청을 위한 X-DRM-TOKEN 헤더에는 콘텐츠를 재생할 사용자의 고유 ID (서비스 사이트에서 관리하는 유저 ID 혹은 DRM 컨텐츠를 이용할 사용자 계정)인 userId 를 필수로 포함해야 합니다.
  • Video Player Enhancement를 활용하여 One Click Multi DRM 라이선스를 요청할 경우 1.1.1 이후 버전에서만 지원합니다.

요청

Method Endpoint 설명
POST POST https://multi-drm.apigw.gov-ntruss.com/api/v1/license FairPlay Streaming 라이선스 발급 요청
GET GET https://multi-drm.apigw.gov-ntruss.com/api/v1/license/fairPlay FairPlay Streaming 라이선스 발급을 위한 JSON 타입 인증서 요청
GET GET https://multi-drm.apigw.gov-ntruss.com/api/v1/license/fairPlay FairPlay Streaming 라이선스 발급을 위한 ORIGINAL 타입 (바이너리) 인증서 요청

요청 헤더

헤더명 필수 여부 설명
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)
x-drm-token YES One Click Multi DRM 라이선스 발급에 필수 데이터가 포함된 암호화된 토큰값
x-drm-token:{X-DRM-TOKEN}

X-DRM-TOKEN 헤더

One Click Multi DRM API를 통해 라이선스를 발급하기 위해 X-DRM-TOKEN 헤더 인증이 필수로 필요합니다.
X-DRM-TOKEN 헤더 값 경우, 아래 JSON 데이터를 Base64 문자열로 변환한값을 입력합니다.

  • One Click Multi DRM 상품에서는 X-DRM-TOKEN 헤더를 통해 해당 콘텐츠와 사이트의 권한이 있는 사용자인지 확인하며, 요청한 사이트에 설정된 콘텐츠 보안 정책에 따라 DRM 라이선스 규칙을 설정합니다.
필드명 필수 여부 유효 값 설명
siteId YES 라이선스 발행을 위한 사이트 ID
contentId YES 재생하려는 콘텐츠의 고유 ID
DRM 패키징 시에 사용된 값으로 최소 3글자 이상 영문/숫자 또는 ‘-'(하이픈), ‘_'(언더바) 포함 최대100자 문자까지 입력 가능합니다.
drmType YES WIDEVINE
PLAYREADY
FAIRPLAY		 라이선스를 요청하는 DRM 타입
responseFormat YES ORIGINAL
JSON		 라이선스 요청에 대한 응답 데이터 유형. (기본값 : ORIGINAL)
* ORIGINAL: 요청한 바이너리 라이선스 데이터 응답
* JSON : 라이선스 데이터와 추가 정보(클라이언트 기기 ID 등)를 포함한 JSON 형식으로 응답. 토큰 프록시 또는 클라이언트 SDK를 사용하는 경우에만 적용 가능.
userId YES 콘텐츠를 재생할 사용자의 고유 ID (서비스 사이트에서 관리하는 유저 ID 혹은 DRM 컨텐츠를 이용할사용자 계정)인 userId

X-DRM-TOKEN 헤더 생성하기

X-DRM-TOKEN을 생성 하는 방법은 다음과 같습니다.

  1. 라이선스 요청을 위해 필수적인 siteId, contentId, drmType, responseFormat, userId 를 JSON으로 입력합니다.
# json
{"siteId":"drm-20231115142326-nHyNw","contentId":"my-drm-content-sample","drmType":"FAIRPLAY","responseFormat":"ORIGINAL","userId":"d41d8cd98f00b204e9800998ecf8427e"}
  1. 입력한 JSON 데이터를 Base64 URL 로 인코딩 합니다.
# Base64 Encrypted String 
eyJzaXRlSWQiOiJkcm0tMjAyMzExMTUxNDIzMjYtbkh5TnciLCJjb250ZW50SWQiOiJteS1kcm0tY29udGVudC1zYW1wbGUiLCJkcm1UeXBlIjoiRkFJUlBMQVkiLCJyZXNwb25zZUZvcm1hdCI6Ik9SSUdJTkFMIiwidXNlcklkIjoiZDQxZDhjZDk4ZjAwYjIwNGU5ODAwOTk4ZWNmODQyN2UifQ==
주의

Base64 로 인코딩 되는 과정에 JSON 의 공백값이나 엔터값을 포함하지 않도록 주의 부탁드립니다.

예시

x-drm-token 헤더 포함 라이선스 발급 요청 예시 

POST https://multi-drm.apigw.gov-ntruss.com/api/v1/license 

curl -i -X POST \
   -H "x-ncp-apigw-timestamp:1505290625682" \
   -H "x-ncp-iam-access-key:D78BB444D6D3C84CA38A" \
   -H "x-ncp-apigw-signature-v2:WTPItrmMIfLUk/UyUIyoQbA/z5hq9o3G8eQMolUzTEo=" \
   -H "x-ncp-region_code:KR" \
   -H "accept: application/json" \ 
   -H "X-DRM-TOKEN: eyJzaXRlSWQiOiJkcm0tMjAyMzExMTUxNDIzMjYtbkh5TnciLCJjb250ZW50SWQiOiJteS1kcm0tY29udGVudC1zYW1wbGUiLCJkcm1UeXBlIjoiRkFJUlBMQVkiLCJyZXNwb25zZUZvcm1hdCI6Ik9SSUdJTkFMIiwidXNlcklkIjoiZDQxZDhjZDk4ZjAwYjIwNGU5ODAwOTk4ZWNmODQyN2UifQ== \
'https://multi-drm.apigw.ntruss.com/api/v1/license'

x-drm-token 헤더 포함 FPS 인증서 발급 요청 예시 

GET https://multi-drm.apigw.gov-ntruss.com/api/v1/license/fairPlay

curl -i -X GET \
   -H "x-ncp-apigw-timestamp:1505290625682" \
   -H "x-ncp-iam-access-key:D78BB444D6D3C84CA38A" \
   -H "x-ncp-apigw-signature-v2:WTPItrmMIfLUk/UyUIyoQbA/z5hq9o3G8eQMolUzTEo=" \
   -H "x-ncp-region_code:KR" \
   -H "accept: application/json" \ 
   -H "X-DRM-TOKEN: eyJzaXRlSWQiOiJkcm0tMjAyMzExMTUxNDIzMjYtbkh5TnciLCJjb250ZW50SWQiOiJteS1kcm0tY29udGVudC1zYW1wbGUiLCJkcm1UeXBlIjoiRkFJUlBMQVkiLCJyZXNwb25zZUZvcm1hdCI6Ik9SSUdJTkFMIiwidXNlcklkIjoiZDQxZDhjZDk4ZjAwYjIwNGU5ODAwOTk4ZWNmODQyN2UifQ== \
'https://multi-drm.apigw.ntruss.com/api/v1/license/fairPlay'

응답

참고
  • ORIGINAL 타입 라이선스에 대해서는 binary 응답으로 제공됩니다.
  • binary 라이선스 요청 응답에 대해서는 응답 예시가 제공되지 않습니다.

JSON 타입 라이선스 요청 응답

필드명 필수 여부 타입 설명
license Yes String 라이선스 JSON 데이터
licenseCreatedTime Yes Timestamp 라이선스 발행 시간
tokenCreatedTime Yes Timestamp X-DRM-TOKEN 헤더 유효성 통과 후 유효 시간
tokenExpireTime Yes Timestamp 요청한 X-DRM-TOKEN 헤더 토큰 유효 시간

응답 예시

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

{
  "license": "080512BF050AB9020803121044E0A85CB19D0441AC6C66B3D6ABBCC218E39FC48D06228E023082010A0282010100B2FB0D937113004C0F805C6C57DE7B266E2B5E2FE12241FF1421ED55DE2C3F73F62891D7587A8ED153F4009D9522C3609A5DC3C4E43891F8F2D7B448B36E8B77AD96DC795795706D4289F8E61FBDF564AB57E5A5EDDB64FC4EA6891C793B3FC615998CB01214D769F5BC9F93DD96D5ACB7E7239F0C3749309C55C41DD889277B28D74ADA5CB9B3F760318B55EE7FB9336283E3792EA360CC3BD32F4FDB49C4D33A5836DE3428B62D027964A989F42AB37E123BE5EFC15285090B2601F09A93AAD66546D8F85820B882A1AA3D320A8759628BB177484A660D54711FDC338DB6119E34B49F927942A343F5AD069C06DBCAF3958F83F796EAC7BF5C860B893D6CB102030100013A08696E6B612E636F6D400248011280030078BF2DF3FF6F3A488B86023BD961B3FCA718DAA38976B74620A560A8524E53C16F064CB7528F174162F331C32AA0E72296DD15BB79CA986B7739A85C7A4AB4B06D8665CDD166C58C1E030D6232AEC7970801125CC59FB988265FFFD38BD04241AAFEBB91F8C933A9E70A3B52F0FBF29306F10A2AF91B30BD3EBE24D7890778898A4999F0F7D28BFFBBD6647B08D93EDEE309C2B4B9E3080F269A1C3DE899FDA800C277EC6D0882365B1C9805D0FF4DBEB2E8BA5C51F86F910F73C1776761B85F88943E44DDCD7ABF797C4A4BE2489D6BE4FAAE4569A435E5D5E3773636EF872706F155B271D6E49D4C750A51614DBBD5D2A0F9B8E352FA91B52EC19593F215BCEB2E8401CCC9757C48793C9AB4904B93C7D326BFFBB5E24CDBF297599FB22724C95C9D40D44455586B188A6D10658BEBE5F6CE812FABB8CA58282B5D28176D5DFF3B358692CC4FC6895A06C0B90A192D65F69AE07415DCEF6E54A677D5C769BA6E9CC24E2B968BC3E6E4D4E099E446D9F7E38740DBB708023E6D35D99F1B10",
  "licenseCreatedTime": 1700476438204,
  "tokenCreatedTime": 1700476438107,
  "tokenExpireTime": 1700477038107
}