인증 및 주요 키

Kollus VOD 시스템 연동 시 API 인증, 콘텐츠 식별, 재생 권한 확인을 위해 다양한 고유 식별 키가 사용됩니다. 각 키의 용도와 확인 방법을 숙지하여 연동을 진행해 주세요.

키 (Key/ID)	주요 용도	Kollus VOD 콘솔 확인 경로
API 접근 토큰	API 호출 시 인증 헤더에 사용	[서비스 계정] > [API]
보안 키	JWT 재생 권한 인증 (서명 및 검증)	[서비스 계정] > [사용자 키]
사용자 키	보안 키를 암호화한 값 (JWT 생성 시 필수)	[서비스 계정] > [사용자 키]
서비스 계정 키	계정 식별 및 FTP 주소 구성	[서비스 계정] > [기본 정보]
업로드 파일 키	원본 콘텐츠 자산 식별 및 관리	[라이브러리] > 콘텐츠 상세 > [기본] 탭
미디어 콘텐츠 키	배포 및 재생 핵심 식별자 (비교: 업로드 파일 키 vs 미디어 콘텐츠 키)	[채널] > 콘텐츠 상세 > [채널] 탭
인코딩 프로파일 키	인코딩 정책 및 전송 규격 식별	[설정] > [인코딩 프로파일]
카테고리 키	카테고리 관리 및 통계 산출용	[라이브러리] > 카테고리 [더보기 (⋮)]
채널 키	채널 관리 및 통계 산출용	[채널] > 채널 [더보기 (⋮)]

API 접근 토큰

주의

새 토큰을 발급하면 기존 토큰은 즉시 무효화됩니다. 따라서 기존 토큰을 사용 중인 모든 시스템의 인증 정보를 함께 업데이트해야 합니다.

보안 키 변경

보안 키 변경은 기술 지원팀(PE, tech_support@catenoid.net)으로 문의해 주세요.

설명: 보안 키를 암호화한 값으로, 보안 키와 함께 인증(JWT)에 사용됩니다.
확인 경로: Kollus VOD 콘솔 > [서비스 계정] > [사용자 키]
- 브라우저 새로고침 시 값이 업데이트될 수 있으며, 사용 시점의 최신 값을 복사하여 적용해야 합니다.
참고 문서: 재생 URL 생성 (JWT)

설명: 콘텐츠가 특정 채널에 등록될 때 발급되는 배포용 식별 키입니다. 동일한 콘텐츠라도 등록된 채널이 다르면 서로 다른 미디어 콘텐츠 키가 발급됩니다. 콘텐츠 재생 권한 인증뿐만 아니라 Custom ID 결합 등 배포 서비스 전반에서 핵심 식별자로 사용됩니다.
확인 경로
- 콘텐츠 목록: Kollus VOD 콘솔 > [채널] > 채널 선택 > 콘텐츠 목록의 [미디어 콘텐츠 키] 항목
- 상세 정보 패널: Kollus VOD 콘솔 > [채널] > 채널 선택 > 콘텐츠 제목 클릭 > [채널] 탭 > [미디어 콘텐츠 키 복사]

설명: 서비스 계정, 디바이스 유형, 화질 정보가 조합된 프로파일 식별 키입니다. FTP 패스스루 업로드 또는 특정 카테고리의 인코딩 정책 설정 시 사용됩니다.
확인 경로: Kollus VOD 콘솔 > [설정] > [인코딩 프로파일]
참고 문서: 인코딩 프로파일 설정

Kollus VOD는 원본 자산을 다양한 채널에 다각도로 배포하기 위해 식별자를 이원화하여 관리합니다.