비공개(보안) 채널 서비스 플로우
이 가이드는 보안 정책이 적용된 비공개 채널을 통해 라이브 방송을 운영하는 전체 프로세스를 설명합니다.
인증된 사용자(End User)만 시청할 수 있는 보안 라이브 방송을 구성하려는 경우 아래의 서비스 플로우를 참조하세요.
핵심 프로세스 요약
비공개 채널의 기술적 전송 인프라는 공개 채널과 동일하지만, 시청 권한 검증을 위한 보안 계층이 추가됩니다.
- 방송 송출 (RTMP): Kollus 전용 모바일 인코더 또는 OBS, vMIX와 같은 방송 송출 프로그램을 이용해 원본 영상을 RTMP(Real-Time Messaging Protocol) 방식으로 서버에 전송합니다.
- 트랜스코딩 (Transcoding): 전송된 영상은 Kollus Live 콘솔에 미리 설정된 인코딩 프로파일에 따라 시청 환경에 적합한 화질과 포맷으로 실시간 변환됩니다.
- Origin 서버 저장: 트랜스코딩이 완료된 콘텐츠는 Origin 서버에 일시적으로 저장되어 배포 준비를 마칩니다.
- Edge 서버 캐싱 및 배포: 대규모 동시 접속에 대응하기 위해 콘텐츠는 Edge 서버에 캐시되며, HLS(HTTP Live Streaming) 방식으로 플레이어에 전송됩니다.
- 방송 시청: 인증된 사용자만 Kollus 보안 플레이어를 통해 방송을 시청할 수 있습니다.
튜토리얼
1단계: 콘솔 로그인
Kollus Live 콘솔에 접속하여 로그인합니다.
- 통합 계정: 서비스 계약 시 안내받은 계정 정보를 입력하세요. Kollus VOD를 이미 이용 중이라면 동일한 로그인 정보를 사용할 수 있습니다.
- Creator 로그인: 실제 방송 송출을 담당하는 '진행자' 전용 페이지입니다. 채널 생성 및 Creator 계정 등록이 완료된 후 사용할 수 있으므로, 현재 단계에서는 접근할 수 없습니다.
2단계: 라이브 채널 생성
라이브 방송의 기본 단위인 채널(Channel)을 생성합니다.
채널은 송출된 원본 영상을 실시간으로 변환(Transcoding)하여 시청자에게 최적화된 스트림을 배포하는 역할을 합니다.
[채널 관리] > [채널 리스트]메뉴로 이동하여 우측 상단의[채널 등록]버튼을 클릭합니다.
- 각 항목을 설정한 후
[저장]을 클릭합니다.
이 가이드는 비공개 채널의 일반 라이브 진행 절차를 설명하므로,[공개 여부]는[비공개]로,[채널 타입]은[라이브]로 설정하세요.항목 설명 키 채널 고유 식별자입니다. 방송 시청 URL 등을 생성하는 필수 값입니다. (수정 불가) 채널명 서비스에 표시되는 채널 명칭입니다. 채널 리스트나 통계 페이지에서 채널 식별 용도로 사용됩니다. 고객 코드 고객사가 내부 관리를 위해 직접 입력하는 식별 코드입니다. 동시 시청자 수 제한 해당 채널에 접속 가능한 최대 동시 시청자 수를 설정합니다. 채널 타입 라이브 유형을 선택합니다. - 라이브: 표준 실시간 방송
- 저지연 라이브: 지연 시간을 최소화한 LL-HLS 방식 (참고: 저지연 라이브 (LL-HLS))
- 편성 라이브: 준비된 VOD 파일을 정해진 시간에 방송하는 파일 라이브 (참고: 편성 라이브)
인코딩 프로파일 송출 화면의 방향(가로/세로)을 설정합니다. - Default - landscape: 가로 방향
- Default - portrait: 세로 방향
공개 여부 채널의 공개 여부를 설정합니다. - 공개: 외부 배포를 위한 방송 시청 URL(비디오 게이트웨이 링크)이 제공됩니다.
- 비공개: 허가된 사용자만 시청할 수 있도록 JWT(JSON Web Token) 기반의 URL을 생성해야 합니다.
ℹ️참고위 표에 안내된 기본 항목 외에 보안 등 세부 기능에 대한 설명은 채널 설정 문서를 참고하세요.
3단계: JWT 생성
비공개 채널은 공개용 게이트웨이 링크를 지원하지 않습니다.
보안을 위해 서버 측에서 JWT(JSON Web Token)를 생성하여 시청 권한을 부여해야 합니다.
JWT 페이로드(Payload)에는 비디오 워터마크, 접근 만료 일시 등 다양한 보안을 정의할 수 있습니다.
비공개 채널의 방송 시청을 위한 필수 페이로드 구성은 다음과 같습니다.
기본 JWT 페이로드(Payload) 예시
{
"client_user_id": "{END_USER_ID}",
"expire_time": 1607169600,
"live_media_channel_key": "abcd1234"
}
| 옵션 | 타입 | 설명 |
|---|---|---|
client_user_id | string | 시청자를 식별하는 고유 ID입니다. |
expire_time | integer | 토큰(JWT)의 유효 기간입니다. 만료 시 접속이 차단됩니다. (최댓값: 2147483647) |
live_media_channel_key | string | 채널의 고유 식별자입니다. 확인 경로: Kollus Live 콘솔 > [채널 관리] > [채널 리스트] > 대상 채널 우측 [수정 아이콘] > [키] |
JWT 구성에 대한 상세 설명은 보안 라이브 시청 URL 생성 (JWT) 문서를 참고하세요.
4단계: 보안 시청 URL 구성
인증된 사용자(End User)만 방송을 시청할 수 있도록 보안 URL(S링크) 방식으로 플레이어를 호출합니다. 아래 규격에 맞춰 시청 URL을 작성하세요.
시청 URL 규격
http://live-kr.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_KEY}
파라미터 상세 설명
| 파라미터 | 설명 |
|---|---|
{JWT} | 인증 및 보안 설정 토큰 3단계에서 생성한 JWT입니다. |
{CUSTOM_KEY} | 사용자 키(계정 식별 키)
|
플레이어 호출 방식에 대한 상세 설명은 플레이어 호출 문서를 참고하세요.
5단계: 라이브 방송 송출
인코더 솔루션을 사용하여 실제 영상을 Kollus 서버로 전송합니다. 사용 환경에 맞는 가이드를 선택하세요.
6단계: 방송 모니터링 및 종료
송출이 시작되면 콘솔에서 방송 상태를 실시간으로 점검할 수 있습니다.
- 방송 상태 확인: 채널 목록에서 '방송중' 태그가 표시되는지 확인합니다.
- 화면 모니터링: 채널명을 클릭하여 채널 상세 페이지로 이동하면, 실제 송출 화면이 플레이어에 노출됩니다.
- 방송 종료: 인코더 프로그램에서 방송 종료 버튼을 누르면 방송이 종료됩니다.