서비스 계정
Kollus VOD 서비스 이용을 위해 고객사는 두 종류의 계정을 사용합니다.
- 로그인 계정: Kollus VOD 서비스 이용을 위한 기본 계정입니다.
- 서비스 계정: 콘텐츠 업로드, API 호출 등 실제 서비스 운영에 필요한 리소스를 제어하는 계정입니다.
이 문서에서는 서비스 계정의 특징, 각종 식별 키 정보 확인, 사용자 권한 관리 기능을 설명합니다.
서비스 계정이란?
서비스 계정은 Kollus VOD 리소스에 접근하고 이를 제어하기 위한 운영 단위입니다.
로그인 계정을 생성한 후, 실제 비즈니스 운영을 위한 서비스 계정을 등록해야 서비스 이용이 가능합니다.
주요 특징
- 역할 기반 접근 제어(RBAC): 서비스 계정별로 권한을 다르게 설정할 수 있습니다.
- 유연한 다중 사용자 구조
- 하나의 로그인 계정으로 여러 서비스 계정을 생성하여 관리할 수 있습니다.
- 다른 로그인 계정이 생 성한 서비스 계정에 초대받아 참여할 수 있습니다.
- 고유 식별 정보
- 서비스 계정 이름: 업로드 경로, 도메인 구성, 콜백 설정에 활용됩니다.
- 서비스 계정 키: API 인증에 사용됩니다.
서비스 계정 관리
로그인 계정으로 콘솔에 로그인한 후, 왼쪽 메뉴 바 하단의 서비스 계정 아이콘을 클릭합니다.
기본 정보
[서비스 계정] > [기본 정보]에서 기본 정보를 확인하고, 서비스 계정 이름을 수정할 수 있습니다.
서비스 계정 정보 항목
| 항목 | 설명 |
|---|---|
| 서비스 계정 | 서비스 계정의 이름입니다.(수정 가능) 이모지(Emoji)와 꺽쇠 기호( <, >)는 입력할 수 없습니다. |
| 서비스 계정 키 | 서비스 계정 생성 시 자동 발급된 고유 식별자입니다.(변경 불가) 업로드 및 FTP 주소 구성 시 사용됩니다. 예: 서비스 계정 이름이 catenoid이면 FTP 주소는 catenoid.ftp.kr.kollus.com입니다. |
| 서비스 등급 | 계약 시 선택한 서비스 등급입니다. |
| 메인 노드 지역 | 서비스가 제공되는 지역입니다. 예: 서비스 지역이 대한민국이면 'KR'이 표시됩니다. |
이메일 알림
콘텐츠 업로드 완료, 리소스 사용량 초과 등 주요 이벤트 발생 시 실시간 알림을 받을 수 있습니다.
[서비스 계정] > [이메일 알림] 메뉴에서 원하는 항목을 선택하세요.
이메일 알림 항목
| 항목 | 설명 |
|---|---|
| 콘텐츠 업로드 완료 시 알림 | 콘텐츠 업로드가 완료되면 이메일로 알림이 발송됩니 다. |
| 트랜스코딩 완료 시 알림 | 콘텐츠 트랜스코딩이 완료되면 이메일로 알림이 발송됩니다. |
| AI자막 생성 완료 시 알림 | AI자막 생성이 완료되면 이메일로 알림이 발송됩니다. |
| AI요약·챕터 생성 완료 시 알림 | AI요약·챕터 생성이 완료되면 이메일로 알림이 발송됩니다. |
| AI배속 생성 완료 시 알림 | AI배속 생성이 완료되면 이메일로 알림이 발송됩니다. |
| 트래픽 초과 알림 | 일 트래픽이 설정치의 80% 또는 100%를 초과하면 이메일로 알림이 발송됩니다. (최대 36시간까지 알림 발송이 지연될 수 있음) |
| 전송량 초과 알림 | 월 전송량이 설정치의 80% 또는 100%를 초과하면 이메일로 알림이 발송됩니다. (최대 36시간까지 알림 발송이 지연될 수 있음) |
| 스토리지 사용량 초과 알림 | 일 스토리지 사용량이 설정치를 초과하면 이메일로 알림이 발송됩니다. (최대 36시간까지 알림 발송이 지연될 수 있음) |
| AI자막 생성 사용량 초과 알림 | 월 AI자막 생성 사용량이 설정치를 초과하면 이메일로 알림이 발송됩니다. (설정치 변경 시 새 값을 기준으로 알림 재발송) |
| AI요약·챕터 생성 사용량 초과 알림 | 월 AI요약·챕터 생성 사용량이 설정치를 초과하면 이메일로 알림이 발송됩니다. (설정치 변경 시 새 값을 기준으로 알림 재발송) |
| AI배속 생성 사용량 초과 알림 | 월 AI배속 생성 사용량이 설정치를 초과하면 이메일로 알림이 발송됩니다. (설정치 변경 시 새 값을 기준으로 알림 재발송) |
FTP 정보
Kollus VOD는 FTP를 통한 콘텐츠 업로드를 지원합니다.
[서비스 계정] > [FTP] 메뉴에서 FTP 정보를 확인하고 설정하세요.
FTP 정보 항목
| 항목 | 설명 |
|---|---|
| FTP 주소 | {서비스 계정 키}.ftp.{노드}.kollus.com 형식으로 자동 생성됩니다. |
| FTP 비밀번호 | FTP 업로드용 비밀번호입니다.(수정 가능) |
| FTP 업로드 시 기본 카테고리 | FTP 업로드 시 콘텐츠가 등록될 카테고리를 설정합니다. |
API 정보
Kollus VOD API를 활용해 외부 시스템과 연동하거나 기능을 자동화할 수 있습니다.
[서비스 계정] > [API] 메뉴에서 API 접근 토큰을 관리하세요.
API 정보 항목
| 항목 | 설명 |
|---|---|
| API 도메인 | API 서버 주소입니다. 기본 API 도메인은 api.kr.kollus.com입니다. |
| API 접근 토큰 | API 호출 시 필요한 인증 키입니다. |
| 새 API 접근 토큰 발급 | 새 토큰 발급 시 기존 토큰은 즉시 만료됩니다. 반드시 외부 연동 시스템의 토큰을 함께 교체해야 합니다. |
보안 키 / 사용자 키
콘텐츠 접근 권한 검증에 사용되는 핵심 키 정보입니다.
[서비스 계정] > [사용자 키] 메뉴에서 확인 가능합니다.
| 항목 | 설명 |
|---|---|
| 보안 키 | 고객사와 Kollus 간 공유되는 비밀 키입니다. 서비스 계정 이름이 보안 키로 사용되며, 변경이 필요한 경우 Kollus 기술 지원팀(PE, tech_support@catenoid.net)으로 문의해 주세요. |
| 사용자 키 | 콘텐츠 인증(JWT 등) 시 사용자를 식별하는 고유 값입니다. 페이지를 새로고침할 때마다 값이 변경되지만, 표시되는 값을 그대로 사용해도 문제 없습니다. |
콜백(Callback) 설정
콜백은 작업 완료 이벤트를 고객사 시스템에 HTTP POST 방식으로 실시간 알림을 전송하는 기능입니다.
이를 통해 작업 현황을 실시간으로 파악하고 사용자(End User)에게 신속하고 안정적인 서비스를 제공할 수 있습니다.
콜백 URL을 수신하는 서버는 반드시 보안 설정을 강화하고 안정적으로 운영되어야 합니다.
업로드 콜백 URL, 트랜스코딩 콜백 URL, 콘텐츠 업데이트 콜백 URL은 [서비스 계정] > [콜백] 메뉴에서 등록할 수 있습니다.
콜백 URL 항목
| 항목 | 설명 |
|---|---|
| 업로드 콜백 URL | 업로드 완료 시, 업로드 파일 키를 포함한 콜백 정보를 해당 URL로 전송합니다. |
| 트랜스코딩 콜백 URL | 트랜스코딩 완료 시, 프로파일 키를 포함한 콜백 정보를 해당 URL로 전송합니다. |
| 콘텐츠 업데이트 콜백 URL | 채널 내 콘텐츠가 추가, 삭제, 재생될 때 콜백 정보를 해당 URL로 전송합니다. |
콘텐츠 채널 추가 및 삭제 콜백 URL, 플레이어 콜백(플레이/다운로드, LMS, 다음 회차) URL은 콜백 설정 문서를 참고하세요.
사용자 관리
서비스 계정에 사용자를 초대하고, 사용자 등급을 부여하여 업무 권한을 분리할 수 있습니다.
사용자 등급
- 최고관리자: 모든 기능에 대한 접근 및 수정 가능
- 관리자: 라이브러리, 채널, 설정 등 주요 메뉴 수정 가능(일부 메뉴 조회 가능)
- 운영자: 콘텐츠 업로드, 조회, 수정 가능(삭제 불가)
운영자 권한 변경(2025년 1월 개정)
- 라이브러리: 카테고리 수정 불가 / 콘텐츠 삭제 불가 / 콘텐츠 목록 다운로드 불가 / 원본 파일 다운로드 불가
- 채널: 채널 수정 불가 / 콘텐츠 삭제 불가 / 콘텐츠 목록 다운로드 불가 / 원본 파일 다운로드 불가 / 콜백 설정 불가 / 레퍼러 설정 불가
- 서비스 계정: 전체 메뉴 접근 불가
사용자 등급별 메뉴 및 기능의 접근 권한은 아래 표를 참고하세요.
사용자 등급별 접근 권한
| 메뉴 | 기능 | 운영자 | 관리자 | 최고 관리자 |
|---|---|---|---|---|
| 라이브러리 | 콘텐츠 업로드 | ◯ | ◯ | ◯ |
| 콘텐츠 조회/수정 | ◯ | ◯ | ◯ | |
| 콘텐츠 삭제 | ✕ | ◯ | ◯ | |
| 원본 파일 삭제/트랜스코딩 파일 삭제 | ✕ | ◯ | ◯ | |
| 카테고리 추가/수정/삭제 | ◯ | ◯ | ◯ | |
| 카테고리 이동 | ◯ | ◯ | ◯ | |
| 카테고리 키 복사 | ◯ | ◯ | ◯ | |
| 콘텐츠 목록 다운로드 | ✕ | ◯ | ◯ | |
| 파일 다운로드 | ✕ | ✕ | ◯ | |
| 채널 | 콘텐츠 조회/수정 | ◯ | ◯ | ◯ |
| 콘텐츠 삭제 | ✕ | ◯ | ◯ | |
| 다른 콘텐츠로 교체 | ◯ | ◯ | ◯ | |
| 원본 파일 삭제/트랜스코딩 파일 삭제 | ✕ | ◯ | ◯ | |
| 카테고리 이동 | ◯ | ◯ | ◯ | |
| 채널 추가/수정/비활성화/삭제 | ✕ | ◯ | ◯ | |
| 채널 키 복사 | ◯ | ◯ | ◯ | |
| 콜백 설정 | ✕ | ◯ | ◯ | |
| 레퍼러 설정 | ✕ | ◯ | ◯ | |
| 국가별 접근 설정 | ✕ | ◯ | ◯ | |
| 외부 디스플레이 출력 차단 | ✕ | ◯ | ◯ | |
| 플레이어 설정 | ✕ | ◯ | ◯ | |
| 분석 | 분석/통계/인사이트 조회 | ✕ | ◯ | ◯ |
| Kollus Analytics 조회 | ✕ | ◯ | ◯ | |
| 서비스 가이드 | ◯ | ◯ | ◯ | |
| 고객의 소리 | ◯ | ◯ | ◯ | |
| 설정 | 인코딩 프로파일 | ◯ (조회만 가능) | ◯ | ◯ |
| 중복 재생 차단 | ◯ (조회만 가능) | ◯ (조회만 가능) | ◯ | |
| 캡처 차단 | ◯ (조회만 가능) | ◯ (조회만 가능) | ◯ | |
| 원본 백업 | ◯ (조회만 가능) | ◯ (조회만 가능) | ◯ | |
| 포스터 | ✕ | ✕ | ◯ | |
| 플레이어 | ◯ (조회만 가능) | ◯ | ◯ | |
| 서비스 계정 | 기본 정보 | ✕ | ◯ | ◯ |
| 이메일 알림 | ✕ | ◯ | ◯ | |
| FTP | ✕ | ◯ | ◯ | |
| Uploader 다운로드 | ✕ | ◯ | ◯ | |
| API | ✕ | ◯ | ◯ | |
| 사용자 키 | ✕ | ◯ | ◯ | |
| 콜백 | ✕ | ✕ | ◯ | |
| 사용자 관리 | ✕ | ◯ | ◯ | |
| 로그인 계정 | 내 프로파일 | ◯ | ◯ | ◯ |
| 2단계 인증 | ◯ | ◯ | ◯ | |
| 비밀번호 변경 | ◯ | ◯ | ◯ | |
| 탈퇴 | ◯ | ◯ | ◯ | |
사용자 초대
서비스 계정에 새로운 사용자를 초대하여 Kollus VOD 콘솔 접근 권한을 부여할 수 있습니다.
- [사용자 관리] 화면 오른쪽 상단의 [사용자 초대] 버튼을 클릭합니다.
- 초대 창에 이름, 이메일, 사용자 등급을 입력한 후 [초대 메일 전송]을 클릭합니다.
항목 설명 이름 초대 대상의 이름을 입력합니다. 이메일 초대 대상의 이메일을 입력합니다. - 기존 계정: 즉시 사용자로 등록되며 알림이 발송됩니다.
- 신규 계정: 초대 메일을 통해 로그인 계정이 생성되면 사용자로 등록됩니다.
사용자 등급 초대 대상의 권한 등급을 선택합니다. 
- 초대된 사용자는 설정된 등급에 따라 콘솔의 메뉴 및 기능을 이용할 수 있습니다.