본문으로 건너뛰기

인증 및 API 키

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

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

API 접근 토큰​

  • 설명: Kollus VOD API 호출을 위한 인증 토큰(kollus_api_access_token)입니다.
  • 확인 경로: Kollus VOD 콘솔 > [설정] > [API]
주의

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

보안 키​

  • 설명: 콘텐츠 재생 권한 인증(JWT) 시 서명 및 검증에 사용되는 비밀 키입니다.
  • 확인 경로: Kollus VOD 콘솔 > [설정] > [사용자 키]
  • 보안 키 변경: 기술 지원팀(tech_support@kollus.com)으로 문의해 주세요.
  • 참고 문서: 재생 URL 생성 (JWT)

사용자 키​

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

서비스 계정 키​

  • 설명: 서비스 계정 생성 시 발급되는 계정 식별 키입니다. 변경할 수 없으며, 주로 업로드 경로 및 FTP 주소 구성 시 사용됩니다.
  • 예: 서비스 계정 이름이 catenoid인 경우, FTP 주소는 catenoid.ftp.kr.kollus.com입니다.
  • 확인 경로: Kollus VOD 콘솔 > [워크스페이스 설정] > [서비스 정보]

업로드 파일 키​

  • 설명: 업로드가 완료된 콘텐츠에 부여되는 고유 식별 키입니다. 콘텐츠 정보 수정, 삭제, 교체 등 원본 자산 관리 작업 시 사용됩니다.
  • 확인 경로: Kollus VOD 콘솔 > [라이브러리] > 콘텐츠 제목 클릭 > [기본] 탭

미디어 콘텐츠 키​

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

인코딩 프로파일 키​

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

카테고리 키​

  • 설명: 카테고리 생성 시 발급되는 카테고리 식별 키입니다. 통계 산출 용도로 사용되며, 인증(JWT)에는 사용되지 않습니다.
  • 확인 경로: Kollus VOD 콘솔 > [라이브러리] > 좌측 카테고리 목록 [더보기 (⋮)] > [카테고리 키 복사]

채널 키​

  • 설명: 채널 생성 시 발급되는 채널 식별 키입니다. 통계 산출 용도로 사용되며, 인증(JWT)에는 사용되지 않습니다.
  • 확인 경로: Kollus VOD 콘솔 > [채널] > 좌측 채널 목록 [더보기 (⋮)] > [채널 키 복사]

비교: 업로드 파일 키 vs 미디어 콘텐츠 키​

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

구분업로드 파일 키 (Upload File Key)미디어 콘텐츠 키 (Media Content Key)
핵심 역할자산 관리: 콘텐츠 원본 식별배포 관리: 재생 경로 및 채널별 설정 식별
발급 시점콘텐츠 업로드 프로세스 완료 시업로드된 콘텐츠를 특정 채널에 등록 시
관리 범위정보 수정, 파일 삭제, 원본 교체재생 URL 생성(JWT), 플레이어 설정, 통계
관계콘텐츠당 유일한 1개 발급N개의 채널 등록 시 N개 발급