인증 및 주요 키
Kollus VOD 시스템 연동 시 API 인증, 콘텐츠 식별, 재생 권한 확인을 위해 다양한 고유 식별 키가 사용됩니다. 각 키의 용도와 확인 방법을 숙지하여 연동을 진행해 주세요.
| 키 (Key/ID) | 주요 용도 | Kollus VOD 콘솔 확인 경로 |
|---|---|---|
| API 접근 토큰 | API 호출 시 인증 헤더에 사용 | [서비스 계정] > [API] |
| 보안 키 | JWT 재생 권한 인증 (서명 및 검증) | [서비스 계정] > [사용자 키] |
| 사용자 키 | 보안 키를 암호화한 값 (JWT 생성 시 필수) | [서비스 계정] > [사용자 키] |
| 서비스 계정 키 | 계정 식별 및 FTP 주소 구성 | [서비스 계정] > [기본 정보] |
| 업로드 파일 키 | 원본 콘텐츠 자산 식별 및 관리 | [라이브러리] > 콘텐츠 상세 > [기본] 탭 |
| 미디어 콘텐츠 키 | 배포 및 재생 핵심 식별자 (비교: 업로드 파일 키 vs 미디어 콘텐츠 키) | [채널] > 콘텐츠 상세 > [채널] 탭 |
| 인코딩 프로파일 키 | 인코딩 정책 및 전송 규격 식별 | [설정] > [인코딩 프로파일] |
| 카테고리 키 | 카테고리 관리 및 통계 산출용 | [라이브러리] > 카테고리 [더보기 (⋮)] |
| 채널 키 | 채널 관리 및 통계 산출용 | [채널] > 채널 [더보기 (⋮)] |
API 접근 토큰
- 설명: Kollus VOD API 호출을 위한 인증 토큰(
kollus_api_access_token)입니다. - 확인 경로: Kollus VOD 콘솔 > [서비스 계정] > [API]
주의
새 토큰을 발급하면 기존 토큰은 즉시 무효화됩니다. 따라서 기존 토큰을 사용 중인 모든 시스템의 인증 정보를 함께 업데이트해야 합니다.
보안 키
- 설명: 콘텐츠 재생 권한 인증(JWT) 시 서명 및 검증에 사용되는 비밀 키입니다.
- 확인 경로: Kollus VOD 콘솔 > [서비스 계정] > [사용자 키]
- 관련 문서: 재생 URL 생성 (JWT)
보안 키 변경
보안 키 변경은 기술 지원팀(PE, tech_support@catenoid.net)으로 문의해 주세요.
사용자 키
- 설명: 보안 키를 암호화한 값으로, 보안 키와 함께 인증(JWT)에 사용됩니다.
- 확인 경로: Kollus VOD 콘솔 > [서비스 계정] > [사용자 키]
- 새로고침 시 값이 업데이트될 수 있으며, 사용 시점의 최신 값을 복사하여 적용해야 합니다.
- 관련 문서: 재생 URL 생성 (JWT)
참고
사용자 키는 새로고침 시 값이 업데이트될 수 있습니다. 연동 시스템 적용 시 반드시 현재 시점의 최신 값을 복사하여 사용하세요.
서비스 계정 키
- 설명: 서비스 계정 생성 시 발급되는 계정 식별 키입니다. 변경할 수 없으며, 주로 업로드 경로 및 FTP 주소 구성 시 사용됩니다.
- 예시: 서비스 계정 이름이
catenoid인 경우, FTP 주소는catenoid.ftp.kr.kollus.com입니다. - 확인 경로: Kollus VOD 콘솔 > [서비스 계정] > [기본 정보]
업로드 파일 키
- 설명: 업로드가 완료된 콘텐츠에 부여되는 고유 식별 키입니다. 콘텐츠 정보 수정, 삭제, 교체 등 원본 자산 관리 작업 시 사용됩니다.
- 확인 경로: Kollus VOD 콘솔 > [라이브러리] > 콘텐츠 제목 클릭 > [기본] 탭
미디어 콘텐츠 키
- 설명: 콘텐츠가 특정 채널에 등록될 때 발급되는 배포용 식별 키입니다. 동일한 콘텐츠라도 등록된 채널이 다르면 서로 다른 미디어 콘텐츠 키가 발급됩니다. 콘텐츠 재생 권한 인증뿐만 아니라 Custom ID 결합 등 배포 서비스 전반에서 핵심 식별자로 사용됩니다.
- 확인 경로
인코딩 프로파일 키
- 설명: 서비스 계정, 디바이스 유형, 화질 정보가 조합된 프로파일 식별 키입니다. FTP 패스스루 업로드 또는 특정 카테고리의 인코딩 정책 설정 시 사용됩니다.
- 확 인 경로: Kollus VOD 콘솔 > [설정] > [인코딩 프로파일]
- 관련 문서: 인코딩 프로파일 설정
카테고리 키
- 설명: 카테고리 생성 시 발급되는 카테고리 식별 키입니다. 통계 산출 용도로 사용되며, 인증(JWT)에는 사용되지 않습니다.
- 확인 경로: Kollus VOD 콘솔 > [라이브러리] > 좌측 카테고리 목록 [더보기 (⋮)] > [카테고리 키 복사]
채널 키
- 설명: 채널 생성 시 발급되는 채널 식별 키입니다. 통계 산출 용도로 사용되며, 인증(JWT)에는 사용되지 않습니다.
- 확인 경로: Kollus VOD 콘솔 > [채널] > 좌측 채널 목록 또는 채널 카드 [더보기 (⋮)] > [채널 키 복사]
비교: 업로드 파일 키 vs 미디어 콘텐츠 키
Kollus VOD는 원본 자산을 다양한 채널에 다각도로 배포하기 위해 식별자를 이원화하여 관리합니다.
| 구분 | 업로드 파일 키 (Upload File Key) | 미디어 콘텐츠 키 (Media Content Key) |
|---|---|---|
| 핵심 역할 | 자산 관리: 콘텐츠 원본 식별 | 배포 관리: 재생 경로 및 채널별 설정 식별 |
| 발급 시점 | 콘텐츠 업로드 프로세스 완료 시 | 업로드된 콘텐츠를 특정 채널에 등록 시 |
| 관리 범위 | 정보 수정, 파일 삭제, 원본 교체 | 재생 URL 생성(JWT), 플레이어 설정, 통계 |
| 관계 | 콘텐츠당 유일한 1개 발급 | N개의 채널 등록 시 N개 발급 |