본문으로 건너뛰기

서비스 연동 키

Kollus VOD 서비스 연동 시 사용되는 각종 식별 키에 대해 설명합니다.
API 호출, 콘텐츠 식별 등 다양한 목적에 따라 고유한 키가 발급되며, Kollus VOD 콘솔에서 확인할 수 있습니다.

서비스 계정 키​

  • 설명: 서비스 계정 생성 시 자동 발급되는 고유 식별자입니다. 변경할 수 없으며, 업로드 및 FTP 주소 구성 시 사용됩니다.
  • 예시: 서비스 계정 이름이 catenoid이면, FTP 주소는 catenoid.ftp.kr.kollus.com입니다.
  • 위치: [서비스 계정] > [기본 정보]
    기본 정보 화면

API 접근 토큰​

  • 설명: Kollus VOD API 호출 시 사용되는 인증 토큰입니다. 모든 API 요청은 kollus_api_access_token을 쿼리 파라미터로 추가해 인증을 수행합니다.
  • 위치: [서비스 계정] > [API]
    ⚠️주의

    새 토근 발급 시, 기존 토큰은 더 이상 사용할 수 없습니다.

    API 화면

사용자 키​

보안 키​

  • 설명: 사용자 키와 함께 콘텐츠 접근 권한을 검증하는 데 사용됩니다.
    ℹ️참고

    기본적으로 서비스 계정 이름이 보안 키로 사용됩니다.
    보안상의 이유로 변경이 필요한 경우 Kollus 기술 지원팀(PE, tech_support@catenoid.net)으로 문의해 주세요.

  • 위치: [서비스 계정] > [사용자 키] 사용자 키 창
  • 참고: 개발 가이드 - 암호화 콘텐츠 재생 URL 생성 (JWT)

업로드 파일 키​

  • 설명: 콘텐츠 업로드가 완료되면 자동 생성되는 고유 식별자입니다. 업로드 콜백이나 콘텐츠 교체 시 사용됩니다.
  • 위치: [라이브러리] > 콘텐츠 클릭 > [기본] 탭
    기본 창

인코딩 프로파일 키​

  • 설명: '서비스 계정 키 + 디바이스 유형 + 화질' 조합으로 생성되는 프로파일의 고유 식별자입니다. FTP 패스스루 업로드 시 또는 특정 카테고리에 인코딩 프로파일을 추가할 때 사용됩니다.
  • 위치: [설정] > [인코딩 프로파일]
    인코딩 프로파일 화면
  • 참고: 인코딩 프로파일 설정

카테고리 키​

  • 설명: 콘텐츠 통계 집계 시 사용되는 내부 참조 값입니다. 카테고리 생성 시 자동 발급되며, JWT 링크 등 콘텐츠 인증에는 사용되지 않습니다.
  • 위치: [라이브러리] > 왼쪽 목록 [⋮(더보기)] 버튼 > [카테고리 키 복사]
    라이브러리 화면

채널 키​

  • 설명: 콘텐츠 통계 집계 시 사용되는 내부 참조 값입니다. 채널 생성 시 자동 발급되며, JWT 링크 등 콘텐츠 인증에는 사용되지 않습니다.
  • 위치: [채널] > 왼쪽 목록 또는 채널 카드 [⋮(더보기)] 버튼 > [채널 키 복사]
    채널 화면

미디어 콘텐츠 키​

  • 설명: 채널 내 콘텐츠의 고유 식별자입니다. Custom ID(CID)를 추가하여 새로운 콘텐츠로 인식시키는 등 광범위하게 활용 가능합니다.
  • 위치: [채널] > 콘텐츠 클릭 > [채널] 탭 > [미디어 콘텐츠 키 복사]
    채널 탭