미디어 콘텐츠 키 확장

참고

미디어 키 콘텐츠 확장 기능은 비암호화 콘텐츠에만 적용됩니다. DRM이 적용된 콘텐츠는 지원하지 않습니다.

Kollus VOD는 기존의 미디어 콘텐츠 키에 고객사가 정의한 Custom ID를 결합하는 기능을 지원합니다. 이 기능을 활용하면 물리적인 원본 파일은 하나이지만, 시스템상에서는 이를 여러 개의 독립된 콘텐츠인 것처럼 제어할 수 있습니다.

핵심 원리

• 논리적 분리: 다운로드, 이어보기 등 특정 개인화 기능에서는 확장된 키를 서로 다른 콘텐츠로 인식합니다.
• 물리적 통합: 기본적인 콘텐츠 정보는 원본 미디어 콘텐츠 키를 기준으로 공통 관리됩니다.
• 예: Gmail의 별칭(Alias) 기능과 유사합니다. 확장 주소로 메일을 발송하면 기본 주소(support@kollus.com)가 수신합니다.
  • 기본 주소: support@kollus.com
  • 확장 주소: support-cid1@kollus.com, support-cid2@kollus.com

요청 규격

비암호화 콘텐츠 호출 시, 원본 미디어 콘텐츠 키와 Custom ID를 하이픈(-)으로 연결하여 사용합니다.

요청 URL 구조

미디어 콘텐츠 키 자체에는 하이픈이 포함되지 않으므로 첫 번째 하이픈을 기준으로 Custom ID를 구분합니다.

https://v.kr.kollus.com/{MEDIA_CONTENT_KEY}-{CUSTOM_ID}

JWT Payload 적용

JWT(JSON Web Token) 방식을 사용하여 인증할 경우, mc 배열 내의 mckey 값에 확장 키를 그대로 입력합니다.

{
  "cuid": "user01",
  "expt": 1703980800,
  "mc": [
    {
      "mckey": "{MEDIA_CONTENT_KEY}-{CUSTOM_ID}"
    }
  ]
}

제약 사항

• 길이 제한: 64 bytes 이내
• 허용 문자: 영문, 숫자, 하이픈(-)만 허용
• 인코딩 유의사항: 한글 등 멀티바이트 문자 사용 권장하지 않음 (UTF-8 인코딩 시 64 bytes 초과 주의)

확장 키 적용 대상 기능

확장 키를 통해 호출할 경우, Kollus 시스템은 아래 항목들에 대해 Custom ID별로 데이터를 별도 생성 및 관리합니다.

• DRM 다운로드 콜백
• LMS 콜백
• 이어보기
• 중복 재생 차단
• 북마크

콜백 데이터 수신

확장 키가 적용된 콘텐츠에서 콜백(LMS, DRM 다운로드 등)이 발생할 경우, 수신되는 데이터의 media_content_key 파라미터에도 확장된 형태의 키가 그대로 전달됩니다. 이를 통해 고객사 시스템에서는 어떤 Custom ID에서 발생한 이벤트인지 정확하게 구분하여 후속 처리를 진행할 수 있습니다.

media_content_key="{MEDIA_CONTENT_KEY}-{CUSTOM_ID}"