Dev Console에서 라이선스 토큰 발급하기
로그인 없이 쓸 수 있는 DoveRunner Dev Console로 DRM 라이선스 토큰을 발급하고 확인하는 방법을 보여줍니다.
이 레슨의 위치
멀티DRM 퀵스타트의 두 번째 단계입니다. 콘텐츠는 이미 패키징했습니다. 플레이어가 DRM 라이선스를 받으려면 라이선스 토큰이 필요합니다. 이 레슨에서는 다음을 합니다.
- 토큰이 동작하는 흐름 이해하기
- Site ID, Site Key, Access Key 찾기
- Dev Console에서 테스트 토큰 만들기
라이선스 토큰이 동작하는 방식
멀티DRM은 토큰 방식 라이선싱을 사용합니다. 토큰은 서비스가 DoveRunner에 "이 시청자는 이 콘텐츠를 재생할 권한이 있다"고 알려 주는 수단입니다.
- 플레이어가 서비스에 재생을 요청합니다.
- 서비스 사이트가 라이선스 토큰을 생성합니다.
- 토큰이 클라이언트로 전달됩니다.
- 클라이언트가 토큰을 DoveRunner에 보내 DRM 라이선스를 요청합니다.
- DoveRunner가 라이선스를 발급합니다.
토큰에는 해당 요청에 적용할 사용 규칙이 담겨 있습니다. 시청자가 콘텐츠로 무엇을 할 수 있는지(예: 재생 방식)를 정하는 암호화·사용 조건이며, DoveRunner가 라이선스를 발급할 때 이를 적용합니다.
토큰을 만드는 두 가지 방법
실제 연동에서는 서비스 사이트가 자체 서버에서 토큰을 생성합니다. DoveRunner가 제공하는 Java, Python, PHP 라이선스 토큰 샘플 코드를 사용합니다. 사용자가 시청 권한이 있는지 확인한 뒤에만 토큰이 발급되도록 서버에서 생성해야 하며, Site Key와 Access Key는 서버에만 두고 브라우저에는 노출하지 않습니다.
이 퀵스타트에서는 서버 코드를 작성하는 대신 Dev Console에서 테스트 토큰을 만듭니다.
1. 사이트 인증 정보 찾기
DoveRunner Console에서 Site ID, Site Key, Access Key 세 값이 필요합니다. DoveRunner Console에 로그인해 Content Security > Multi DRM > Settings로 이동한 뒤 Retrieve Secret Information을 선택하면 표시됩니다. 패키징 레슨에서 KMS 토큰을 확인한 화면과 같습니다.
Dev Console은 이 값을 발급하지 않고 로그인도 필요 없으니, 먼저 Console에서 확인해 두세요.
2. License Token Generator 열기
devconsole.doverunner.com의 DRM Tools > License Token Generator(바로가기)를 엽니다. 폼은 다음과 같이 채웁니다.
| 항목 | 입력할 값 |
|---|---|
| Site ID, Site Key, Access Key | Console에서 확인한 세 값 |
| DRM Type | 테스트 브라우저가 지원하는 DRM. Chrome·Firefox는 Widevine, Edge는 PlayReady, Safari는 FairPlay. 대소문자를 구분합니다 |
| CID | 패키징할 때 --content_id로 지정한 콘텐츠 ID |
| USER ID | 시청자를 식별하는 임의의 값. 예: test-user (영문자·숫자 최대 200자) |
| Time stamp | 비워 두면 현재 시각이 사용됩니다 |
| Response Format | 이 코스에서는 original |
| Key Rotation | 이 코스에서는 false. 라이브 스트림에 적용하는 옵션입니다 |
| License Policy JSON | 기본값 {"policy_version":2}는 간단한 테스트 정책입니다. 그대로 둡니다 |
폼 위에는 정책 JSON을 만들어 주는 License Policy Generator가, 아래에는 License Token Validator가 있습니다. 이 레슨에서는 쓰지 않습니다.
3. 토큰 생성
Generate Token을 선택합니다. 결과 상자에 토큰이 Base64 문자열로 표시됩니다. 복사해서 다음 레슨에서 쓸 수 있도록 보관하세요.
토큰 유효 시간
토큰은 기본적으로 time stamp부터 600초(10분) 동안 유효합니다. 라이선스 요청을 테스트하기에는 충분하지만, 자리를 오래 비웠다면 새로 발급하세요. 유효 시간은 DoveRunner Console의 Site Settings > Integration Settings에서 바꿀 수 있습니다.
토큰 유효 시간은 이 토큰으로 라이선스를 발급받을 수 있는 기간입니다. 라이선스를 발급받은 뒤 콘텐츠를 얼마나 재생할 수 있는지는 별도의 설정인 라이선스 유효 기간입니다.
다음 단계
다음 레슨에서 방금 만든 토큰으로 Dev Console 플레이어에서 콘텐츠를 재생해 봅니다. 실제 연동에서 토큰을 생성하는 방법과 토큰에 담을 수 있는 내용은 라이선스 토큰 가이드를 참고하세요.