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