본문으로 건너뛰기

서비스 연동 키

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

서비스 계정 키​

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

API 접근 토큰​

  • 설명: Kollus VOD API 호출을 위한 인증 토큰입니다. 모든 API 요청은 kollus_api_access_token을 포함해야 합니다.
  • 확인 경로: [서비스 계정] > [API]
    ⚠️주의

    새로운 토큰을 발급하는 즉시 기존 토큰은 무효화됩니다. 운영 중인 시스템의 경우 서비스 중단이 발생할 수 있으므로 주의해야 합니다.

    API 화면

보안 키​

  • 설명: 콘텐츠 재생 권한 인증(JWT)시 서명 및 검증에 사용되는 비밀 키입니다.
  • 확인 경로: [서비스 계정] > [사용자 키]
  • 참고: 암호화 콘텐츠 재생 URL 생성 (JWT)
    ℹ️참고

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

    사용자 키 화면

사용자 키​

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

업로드 파일 키​

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

인코딩 프로파일 키​

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

카테고리 키​

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

채널 키​

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

미디어 콘텐츠 키​

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

업로드 파일 키와 미디어 콘텐츠 키의 차이점​

Kollus VOD 서비스는 하나의 원본 자산을 여러 채널에 다양한 설정으로 배포하는 구조를 가집니다. 이를 효율적으로 관리하기 위해 두 종류의 식별 키를 구분하여 사용합니다.

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