> For the complete documentation index, see [llms.txt](https://catenoid-support.gitbook.io/developer-welcome-kit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://catenoid-support.gitbook.io/developer-welcome-kit/undefined-1/vod.md).
# 보안 VoD 서비스 플로우
## VOD 보안
사용자가 아래 소개 될 여러가지 방법을 통해 Kollus 업로드 서버에 콘텐츠를 업로드 합니다. 업로드가 완료되면 업로드 서버에서 플레이어 초기화 시 노출 시킬 포스터를 추출 합니다. 그 후 트랜스코딩 서버로 파일을 전달 합니다. 이 때 사용자는 콘솔의 라이브러리 메뉴에서 업로드 된 콘텐츠 및 트랜스코딩 진행율을 확인할 수 있습니다. 트랜스코딩 서버에서는 사용자가 설정한 인코딩 프로파일 별로 영상을 인코딩 합니다. 이 과정에서 seek bar에 노출 될 썸네일을 추출하고, 암호화 콘텐츠의 경우 영상 암호화를 함께 진행합니다. 모든 과정이 완료되면 콘텐츠를 서비스하기 위한 첫번째 준비가 완료 됩니다. 업로드 및 트랜스코딩이 완료 된 영상은 채널에 배포 후 생성 되는 미디어 콘텐츠 키로 서비스할 수 있습니다. 채널은 운영 정책이 반영 된 단위로, 하나의 영상을 여러개의 채널에 운영 정책 별로 배포 할 수 있습니다.
### 1. 업로드 방법
1\. 콘솔
o [콘솔](https://c-kr.kollus.com/)에 접속하여 \[콘텐츠 업로드] 클릭 합니다.암호화로 콘텐츠를 업로드 하기 위해 \[암호화 콘텐츠로 추가] 체크 후 파일 업로드 해주시면 바로 업로드가 시작 됩니다.
2\. API
o Kollus는 사용자가 업로드를 원하는 시점에 일회성으로 upload url을 생성하여 제공 합니다. 암호화로 업로드 하기 위해서는 upload\_url 생성 시 is\_encryption\_upload 파라미터를 1로 설정 후 api를 호출 합니다. 생성된 upload\_url에 HTTP multipart/form-data 형식으로 파일을 업로드 합니다. 자세한 내용은 아래 가이드 문서에서 확인하실 수있습니다.
3\. FTP
o 콘솔에서 [ftp 계정 정보](https://c-kr.kollus.com/service-account/ftp)를 확인합니다. 암호화의 경우 \_encrypt 디렉토리를 먼저 생성해준 후 그 하위에 업로드 하고자 하는 카테고리 명 앞에 마찬가지로 \_를 붙여 디렉토리를 생성해줍니다. 해당 디렉토리에 업로드 할 파일을 올리면 원하시는 카테고리에 암호화 파일로 업로드 됩니다.
예) /\_encrypt/\_내카테고리 로 생성할 경우 “내카테고리” 에 암호화로 파일이 업로드 됩니다.
4\. Kollus 업로더
o Kollus VOD 전용 업로더도 있습니다.사용자의 PC에 설치하여 동영상을 쉽고 빠르게 업로드 하실 수 있습니다.
o 다운로드:
o 자세한 사용 방법은 아래 사용 가이드를 참고 하세요.
### 2. 채널 등록 방법
업로드 된 콘텐츠는 채널에 등록하여 \[미디어 콘텐츠 키]를 얻어야 서비스 가능합니다.
1\. 콘솔에서 직접 등록
o 라이브러리에서 업로드 된 콘텐츠를 선택하여 우측 상세 페이지의 \[채널] 탭에서 원하시는 채널 추가 가능 합니다.
또는 \[채널] 메뉴에서 원하시는 채널 선택 후 \[채널에 콘텐츠 추가] 선택 후 콘텐츠를 선택하여 추가할 수 있습니다.
2\. 라이브러리에 특정 채널 연결
o 수동 연결이 불편하시다면 라이브러리에 채널을 연결 할 수 있습니다. 예를 들어 A라는 라이브러리에 B라는 채널을 연결하시면, A 라이브러리에 업로드한 콘텐츠의 트랜스코딩이 완료될 때 자동으로 B채널에 추가 해드리는 기능 입니다. 콘솔에서 연결 원하시는 카테고리의 \[카테고리 수정] 메뉴에서 \[콘텐츠 업로드 시, 채널에 자동 등록] 항목을 통해 연결하실 수 있습니다.
또는 카테고리 키와 채널 키를 확인하시어 api로 설정 가능 합니다. Api는 다음 가이드 문서를 참고 부탁 드립니다.
3\. API
o 채널 키와 업로드 파일 키를 확인하시어 api로 추가도 가능합니다. 다음 가이드 문서를 참고 부탁 드립니다.
### 3. JWT 호출 방법
암호화 콘텐츠의 경우 보다 안전한 재생을 위해 콘텐츠 호출 시 JSON Web Token 형식으로 암호화한 키 전달을 권장하고 있습니다. 특히 암호화 콘텐츠 전용 채널로 설정 시 JWT 키로 호출 하셔야만 재생 가능 합니다.
Payload에 비디오 워터마크, 자막 설정, 재생 설정 등 다양한 정보를 추가할 수 있습니다.
가장 기본적인 payload는 다음과 같습니다.
```
{
"cuid": "catenoid",
"expt": 1462931880,
"mc": [{
"mckey": "vnCVPVyV"
}]
}
```
암호화 알고리즘은 HMAC SHA256 (HS256) 로 설정 하고, Secret key는 보안 키, Payload에는 위 Payload Spec에 맞춘 JSON String을 추가하여 JWT를 생성합니다.
생성한 JWT와 사용자 키를 조합하여 아래와 같이 콘텐츠를 호출 합니다.
```
http://v.kr.kollus.com/s?jwt=생성한 JWT&custom_key=사용자 키
```
자세한 내용은 아래 가이드를 참고 부탁 드립니다.
