콜러스 플랫폼에서 사용되는 각종 동영상 연동 키 (KEY)에 대해 설명합니다. 해당 고유값들은 각종 API 및 연동 시 자주 언급되며 플랫폼활용을 보다 용이하게 지원합니다.
[서비스 계정 키/Service key]
- [설정>기본 정보>서비스 계정] 매뉴에 위치 합니다. 해당 키 값은 초기 서비스 계정 생성 시 입력되며 변경이 불가능합니다. [서비스 계정 키]는 업로드 및 FTP업로드 경로에 적용됩니다.
- ex) 서비스 계정 명이 ‘kollusbusiness’ 일 경우: -> FTP 주소: Kollusbusiness.ftp.kr.kollus.com
[API Key / API 접근 토큰]
- [설정>기본 정보>서비스 계정]내 위치 합니다. REST API 사용 시 필요한 토큰이며 API를 활용한 다양한 기능을 구현할 경우 각 request 시 필요한 ‘access_token’을 말합니다. 해당 키는 [설정>기본 정보>서비스 계정] 메뉴에서 확인할 수 있고 기본 사용한 접근 토큰을 변경할 수 있습니다. 이 경우 기존 접근 토큰에 대한 설정 변경관리를 확인한 뒤 설정 완료하시기 바랍니다.
[사용자키]
- [설정>기본 정보>서비스 계정] 하단에 위치하며 미디어 인증(JSON Webtoken, Media Auth, One time URL, media token 등으로 표현됩니다.) 을 연동하기 위한 보안 키와 사용자 키 값을 말합니다.
[보안 키]
- [서비스 계정]과 동일하며 해당 설정은 인증 서비스 구현을 위한 API문서를 참조해야 합니다.
[업로드 파일 키/Upload_File_Key]
- [라이브러리에서 컨텐츠 선택>컨텐츠 상세정보>일반 정보]내 위치합니다. 컨텐츠 업로드가 완료되면 생성되는 값이며, upload callback 적용 시 사용됩니다. 또한 개별 컨텐츠마다 가진 유니크 한 값입니다. 채널 내 특정 컨텐츠를 교체할 경우 [업로드 파일 키]로 검색할 수 있습니다.
[인코딩 프로파일 키(이름)/Encoding Profile Key]
- [설정>인코딩 프로파일]에 위치합니다. 추가 트랜스코딩 프로파일을 카테고리에 적용할 때 해당 프로파일 키를 사용합니다
[카테고리 키/Category Key]
- [카테고리>변경하기]에 위치합니다. 생성된 각 카테고리는 고유 키 값을 가집니다.
[채널 키/channel key]
[채널>변경하기_기본정보]에 위치합니다. 채널이 생성될 경우 각 채널이 가지는 고유 값 입니다.
[미디어 컨텐츠 키/media_content_key]
- [채널>컨텐츠 정보_고급]에 위치합니다. 채널 생성 후 라이브러리&카테고리에서 채널로 그룹화 했을 때 각 채널에 그룹화된 개별 컨텐츠는 고유의 [미디어 컨텐츠 키] 값을 가지며 원하는 custom ID(CID)를 추가하여 새로운 컨텐츠로 인식하도록 기능 구현을 할 수 있습니다. 해당 키 의 활용범위는 매우 넓고 필요 시 MCK확장 및 승계에 대한 설명이 필요합니다. 구체적인 내용은 다음 링크를 참조하시기 바랍니다. 참조:
[중복접속차단 키/ Duplicate block key]
- 중복 접속 차단 시 적용될 고유 키 값 입니다. 일반적으로 [서비스 계정 키]와 동일하며 보안 서비스의 사용 여부에 대해서 사용 전 보안 계약사항 및 적용 컨설팅이 필요합니다. 다른 키 값을 사용하고자 할 경우 담당 AM에게 문의해주시기 바랍니다.