PallyCon 멀티 DRM과 Bitmovin HTML5 플레이어 연동하기

• EME WTF? An introduction to Encrypted Media Extensions(한글번역): https://www.html5rocks.com/ko/tutorials/eme/basics/
• PallyCon 멀티 DRM을 이용한 오디오 콘텐츠 보안 part1: https://pallycon.com/blog/article/protecting-audio-content-with-pallycon-multi-drm-part-1/?lang=ko
• PallyCon 멀티 DRM을 이용한 오디오 콘텐츠 보안 part2: https://pallycon.com/blog/article/protecting-audio-content-with-pallycon-multi-drm-part-2/?lang=ko

• 1단계: PallyCon, Bitmovin 트라이얼 계정 가입
• 2단계: PallyCon CLI 패키져를 이용한 DRM 콘텐츠 패키징
• 3단계: Bitmovin 플레이어와 PallyCon 라이선스 토큰 연동을 통한 DRM 콘텐츠 재생

2-1. CLI 패키져 다운로드 및 설치

PallyCon 개발자 가이드 사이트의 패키져 / 샘플 다운로드 페이지에서 ‘PallyCon Packager 다운로드’ 버튼을 클릭해 CLI 패키저를 다운로드 합니다. 콘텐츠 패키징을 수행할 테스트 PC 또는 서버에 임의의 폴더를 생성하고, 다운받은 패키져 압축파일 내 ‘bin’ 폴더의 OS별 실행 파일을 복사합니다. (예: ~/pallycon-test/PallyConPackager )

PallyCon CLI 패키져는 64비트 기반의 윈도우즈와 리눅스(Ubuntu, CentOS) CLI(Command Line Interface) 환경을 지원합니다. 리눅스 환경의 경우, gcc와 g++ 라이브러리 6.0 버전 이상이 설치되어 있어야 합니다.

2-2. 원본 MP4 영상을 MPEG-DASH로 패키징

DRM 패키징과 재생 테스트에 사용할 MP4 (H264 AVC) 동영상 파일을 패키져 실행 파일이 저장된 폴더에 복사합니다. 아래 링크된 PallyCon 소개 영상을 다운로드 받아 사용하셔도 됩니다.

PallyCon 소개 영상 : https://pallycon.com/docs/files/pallycon-intro.mp4
PallyCon CLI 패키져는 멀티DRM용 DASH-CENC(Widevine, PlayReady), HLS-AES(FairPlay) 패키징과 NCG(Netsync Content Guard) DRM을 위한 NCG, NCG-HLS 패키징 기능을 지원합니다. 본 자습서에서는 간략한 테스트를 위해 DASH-CENC 패키징만 진행합니다.

아래와 같은 명령을 실행해 DASH 패키징을 수행합니다. 패키징 명령의 각종 입력값들에 대한 설명은 아래 표를 참고하시기 바랍니다.
./PallyConPackager --site_id --access_key --content_id --dash -i -o

다운로드 받은 ‘bitmovin-player-samplepage.html’ 샘플 파일을 텍스트 에디터로 열어 수정합니다. 우선 검색 기능으로 ‘.mpd’ 문자열을 검색하면 아래와 같은 부분으로 이동합니다.

var source = {
dash: 'https://bitmovin-a.akamaihd.net/content/MI201109210084_1/mpds/f08e80da-bf1d-4e3d-8899-f0f6155f6efa.mpd',
hls: 'https://bitmovin-a.akamaihd.net/content/MI201109210084_1/m3u8s/f08e80da-bf1d-4e3d-8899-f0f6155f6efa.m3u8',
progressive: 'https://bitmovin-a.akamaihd.net/content/MI201109210084_1/MI201109210084_mpeg-4_hd_high_1080p25_10mbits.mp4',
poster: 'https://bitmovin-a.akamaihd.net/content/MI201109210084_1/poster.jpg'
};


위 소스의 내용을 테스트 환경에 맞도록 아래와 같이 수정합니다.


var source = {
dash: 'https://test-web-server-url/pallycon-intro/dash/stream.mpd',
drm: {
widevine: {
LA_URL: "https://license.pallycon.com/ri/licenseManager.do",
headers: {
"pallycon-customdata-v2" : "CUSTOM_HEADER_VALUE"
}
},
playready: {
LA_URL: "https://license.pallycon.com/ri/licenseManager.do",
headers: {
"pallycon-customdata-v2" : "CUSTOM_HEADER_VALUE"
}
}
}
};


• 위 소스 코드의 mpd 파일 URL은 2단계에서 테스트용 웹 서버에 업로드한 DASH 콘텐츠에 해당되는 URL로 교체되어야 합니다.
• ‘CUSTOM_HEADER_VALUE’ 값은 나중에 아래 과정에서 생성되는 라이선스 토큰 값으로 교체되어야 합니다.

3-2. DRM 라이선스 발급을 위한 라이선스 토큰 생성 및 설정

패키징된 콘텐츠를 재생하기 위해서는 DRM 라이선스 연동을 통해 플레이어에 해당 콘텐츠의 라이선스가 발급되어야 합니다. PallyCon 멀티DRM은 콜백 방식과 토큰 방식의 라이선스 연동을 지원하며, 본 자습서에서는 토큰 방식의 라이선스 연동으로 진행합니다.

라이선스 발급 방식에 대한 상세 설명은 아래 링크된 온라인 가이드를 참고하시기 바랍니다.

• DRM 라이선스 발급 연동 가이드 : https://pallycon.com/docs/ko/multidrm/license/

라이선스 요청에 사용되는 토큰은 PallyCon멀티DRM이 적용될 동영상 서비스의 서버 사이드(백엔드)에서 정해진 규격에 따라 생성되어 클라이언트의 플레이어 코드에 적용되어야 합니다. 본 자습서에서는 빠른 테스트 진행을 위해 PallyCon 사이트의 ‘개발자 콘솔’ 페이지에서 제공되는 ‘토큰 생성’ 기능을 이용합니다. 아래 링크의 개발자 콘솔 페이지로 접속하여 각 항목들을 입력합니다.

• 토큰 생성 페이지 : https://sample.pallycon.com/dev/devconsole/customData.do?lang=ko#create-token

위와 같이 토큰 생성에 필요한 값들을 입력하고 ‘REQUEST TOKEN’ 버튼을 클릭하면 페이지 하단에 토큰 문자열이 생성됩니다. 해당 문자열을 복사해 3-2 단계에서 수정한 Bitmovin 플레이어 샘플 파일의 각 DRM별 ‘CUSTOM_HEADER_VALUE’ 부분에 붙여넣습니다. 최종적인 html 소스의 내용은 아래와 같습니다.


var source = {
dash: 'https://test-web-server-url/pallycon-intro/dash/stream.mpd',
drm: {
widevine: {
LA_URL: "https://license.pallycon.com/ri/licenseManager.do",
headers: {
"pallycon-customdata-v2" : "eyJ0aW1lc3RhbXAiOiIyMDE5LTA0LTAzVDA5OjA4OjAwWiIsImhhc2giOiJRTEUzOGxPQjVJUzZ3cUlYOSt6eWpUR1oxOXVrXC9BVVdFQkxkSjRQZVNiaz0iLCJ0b2tlbiI6IkhCOHVvRXBaTTZ2dEFIVXFLSTQyM0s0amNHTzltU1A5YjJWM2IzaTNEd21cL3dpS1wvSlV2WTVWVVQ4WVNZTUVLZm5PXC9PXC9yTU9hUlZrR0JuQXI0RStSM1FFUVJZandldlNRaGN2cWR6QWN6THFcL1VhaXhRK1J5Z21EMnRDWDFXdFwvdmQ5d1JpeWd4RFgyckt6VWwxeUZyUT09Iiwic2l0ZV9pZCI6IjE3WUwiLCJkcm1fdHlwZSI6IndpZGV2aW5lIiwidXNlcl9pZCI6InRlc3QtdXNlciIsImNpZCI6InBhbGx5Y29uLWludHJvIn0="
}
},
playready: {
LA_URL: "https://license.pallycon.com/ri/licenseManager.do",
headers: {
"pallycon-customdata-v2" : "eyJ0aW1lc3RhbXAiOiIyMDE5LTA0LTAzVDA5OjA4OjAwWiIsImhhc2giOiI2S0t6dVY2NWFwSnpDSmJxdDRhK1NRUjZJM0ZFRlB4amdJaHNCc3g4OXNJPSIsInRva2VuIjoiSEI4dW9FcFpNNnZ0QUhVcUtJNDIzSzRqY0dPOW1TUDliMlYzYjNpM0R3bVwvd2lLXC9KVXZZNVZVVDhZU1lNRUtmbk9cL09cL3JNT2FSVmtHQm5BcjRFK1IzUUVRUllqd2V2U1FoY3ZxZHpBY3pMcVwvVWFpeFErUnlnbUQydENYMVd0XC92ZDl3Uml5Z3hEWDJyS3pVbDF5RnJRPT0iLCJzaXRlX2lkIjoiMTdZTCIsImRybV90eXBlIjoicGxheXJlYWR5IiwidXNlcl9pZCI6InRlc3QtdXNlciIsImNpZCI6InBhbGx5Y29uLWludHJvIn0="
}
}
}
};


• 위 샘플 코드의 토큰 문자열은 자습서를 직접 생성한 값으로 대체해야 합니다.
• 크롬/파이어폭스(Widevine DRM)와 IE11/엣지(PlayReady DRM) 모두에서 재생 테스트를 하려면, 위와 같이 토큰 생성 페이지의 입력 값 중에 ‘DRM Type’ 부분을 각각 ‘widevine’과 ‘playready’로 생성한 두 개의 토큰 문자열을 해당 부분에 입력해야 합니다.

3-3. 수정된 플레이어 샘플 업로드 및 재생 확인

라이선스 토큰 문자열까지 설정이 완료된 플레이어 샘플 html 파일을 2단계에서 DASH 콘텐츠를 업로드한 테스트 용 웹 서버에 업로드합니다. 크롬, 파이어폭스, IE11, 엣지 등 PlayReady 또는 Widevine DRM을 지원하는 웹 브라우저를 실행해 해당 html 파일의 URL로 접속하면 아래와 같은 플레이어 화면이 표시됩니다.