이 가이드는 산업의 개념을 플랫폼에 현재 있는 객체(부케, 라인, 패키지, 파트너 계정, 노드, API)에 대응시킵니다. 이는 개념적 대응이며 산업 전용 기능이 아닙니다. 또한 파트너 계정은 위임 계정이며 격리된 테넌트가 아닙니다.
개념적 대응
패널에는 무대나 티켓이라는 이름의 항목이 없습니다. 표는 어떤 객체가 어떤 역할을 하는지 보여주며, 아래 장들은 그 순서대로 설정합니다.
| 내 산업에서는 | 플랫폼에서는 | 패널에서의 위치 |
|---|---|---|
| 무대 채널 | 실시간 채널: 소스, EPG, 출력 형식을 가진 스트림 | Streams → 실시간 스트림 추가(소스 URL 또는 RTMP 푸시) |
| 티켓 유형 | 부케: 패키지가 부여하는 채널, 영화, 시리즈의 이름 있는 묶음 | Bouquets, Streams와 Movies / Series에서 생성 |
| 티켓 또는 패스 | 라인: 패키지, 부케, 만료일, 연결 제한, 출력을 가진 하나의 액세스 | Lines → 추가, 또는 활성화 코드, 또는 Reseller API |
| 행사 종료 | 라인의 만료일. 패키지, 크레딧 또는 API로 갱신됩니다 | 라인의 만료일과 패키지의 기간 |
| 티켓당 기기 수 | 라인의 최대 연결 수: 동시에 시청할 수 있는 기기 수 | 라인의 최대 연결 수 |
| 티켓 판매·등록 연동 | Reseller API와 웹훅: 자체 시스템에서 수행하는 패널의 작업 | 리셀러 대시보드의 Reseller API 키와 웹훅 |
| 행사장 노드 | 스트리밍 노드: 패널에서 등록하는 엣지 서버. 현장 또는 건물당 하나 | Servers → 노드 추가(SSH로 설치) |
사전 준비
설치 전에 준비할 것.
- 공개 주소 또는 도메인이 있고 예상 피크 시청자에게 충분한 업링크를 갖춘 서버(Ubuntu 22.04 또는 24.04), 그리고 행사장 노드용으로 행사장 네트워크의 장비.
- RTMP를 푸시할 수 있는 무대별 인코더와, 무대·일정·티켓 유형 목록.
- 티켓이 패널에 도달하는 방식에 대한 결정. 활성화 코드 일괄 생성, 또는 티켓 판매 시스템의 Reseller API 호출.
인프라 구축
먼저 오리진, 그다음 행사장.
- 관리 서버에서 설치 프로그램을 실행하고 패널을 TLS가 적용된 리버스 프록시 뒤에 둡니다. 신뢰할 프록시를 설정해 IP 규칙이 시청자의 실제 주소를 보게 합니다.
- 재생 기본 주소를 참석자가 접속하는 공개 주소로 설정합니다.
- 행사장의 장비에 Servers에서 노드를 등록합니다. 패널이 SSH로 설치하고 로컬 스크린이 노드로 연결됩니다.
- 티켓 데스크용으로 라인 권한은 있고 카탈로그 권한은 없는 파트너 계정(리셀러)을 만듭니다.
콘텐츠 정리
무대는 채널로, 티켓은 패키지로.
- 채널 목록이 프로그램처럼 읽히도록 일자별 또는 트랙별로 카테고리를 추가합니다.
- 티켓 유형마다 부케 하나를 만듭니다. 그 티켓으로 볼 수 있는 무대를 넣습니다.
- 티켓 유형마다 행사 기간을 기간으로 하는 패키지 하나를 만들고, 필요하면 기자와 연사용 체험 패키지도 만듭니다.
- 후원사의 무대나 라운지 피드용 부케를 만들고 후원사 패키지로만 부여합니다.
파트너(리셀러) 설정
액세스를 발급하는 경우의 티켓 데스크.
- 티켓 데스크용으로 라인 권한은 있고 카탈로그 권한은 없는 그룹을 만듭니다.
- 데스크를 그 그룹과 발급할 코드에 충분한 크레딧을 가진 리셀러로 추가합니다.
- 자체 티켓을 판매하는 공동 주최자나 지역 파트너에게는 자체 파트너 계정과 자체 패키지를 부여합니다.
참석자 액세스 설정
티켓마다 라인 하나.
- 티켓마다 하나씩, 각 티켓 유형의 패키지에 연결된 활성화 코드를 일괄 생성하고, 티켓과 함께 인쇄하거나 이메일로 보냅니다.
- 온라인 티켓 판매에는 커머스 플랫폼의 커넥터를 설치하거나, 티켓 판매 시스템이 패키지와 요청 ID로 action=create_line을 호출하게 합니다.
- 코드가 관객 전체에 공유되지 않도록 최대 연결 수를 티켓당 기기 1~2개로 설정합니다.
- 입장 전에 참석자가 쓸 것과 같은 플레이어로 체험 라인을 테스트합니다.
세션 녹화
행사 후의 녹화본.
- 각 무대를 녹화해 트랙별 시리즈의 에피소드로 라이브러리에 추가하거나 VOD 인제스트 작업으로 인제스트합니다.
- 녹화본은 별도의 부케와 패키지로 부여해, 실시간용 라인이 만료된 뒤에도 참석자가 액세스를 유지하게 합니다.
- 공지하기 전에 해당 패키지의 테스트 라인으로 녹화본 재생을 확인합니다.
무대 채널
무대를 실시간 채널로.
- 인코더의 RTMP 푸시로 무대마다 실시간 스트림을 추가하고, 시청할 수 있는 티켓 유형의 부케에 넣습니다.
- 캐치업을 활성화해 세션 시작을 놓친 참석자가 되감을 수 있게 합니다.
- 첫 세션 전에 행사장 노드가 각 무대를 오리진에서 한 번만 받는지, 스크린이 그 노드로 연결되는지 확인합니다.
만료
액세스는 행사와 함께 끝납니다.
- 모든 티켓 패키지의 기간을 행사 마지막 날에 끝나도록 설정하면 아무 작업 없이 라인이 만료됩니다.
- 연사나 늦게 합류한 후원사에게는 새 패키지를 만드는 대신 라인 하나를 연장하거나 단기 코드를 발급합니다.
- 분실되거나 공유된 티켓의 라인은 Lines에서 비활성화합니다. 감사 로그에 기록이 남습니다.
티켓 판매 시스템과의 연동
시스템이 액세스를 제어하고 플레이어가 재생합니다.
- 티켓 판매 또는 등록 시스템이 Reseller API로 라인을 생성하고 line.created, line.expired 같은 웹훅을 수신합니다.
- 지원되는 커머스 플랫폼의 온라인 티켓 판매는 해당 커넥터를 사용합니다. 특정 티켓 판매 제품용 기본 커넥터는 없습니다.
- 시청자용 싱글 사인온은 없습니다. 참석자는 라인의 자격 증명 또는 활성화 코드로 플레이어에 로그인합니다.
보안 고려 사항
티켓은 한 사람의 것입니다.
- 패널과 재생 기본 주소는 TLS로 제공하고 TRUSTED_PROXIES를 리버스 프록시로 설정합니다.
- 모든 패널 계정에 2단계 로그인을 적용하고, 티켓 데스크가 무대를 변경할 수 없도록 권한 그룹을 둡니다.
- 서명되고 만료되는 재생 링크와 티켓별 낮은 연결 제한.
- 오프사이트 사본이 있는 암호화된 데이터베이스 백업과, 라인과 무대의 모든 변경을 기록하는 감사 로그.
문제 해결
가장 먼저 확인할 일반적인 항목.
- 참석자가 무대를 열지 못함: 라인의 패키지, 무대를 담은 부케, 만료일을 확인합니다.
- 행사장에서는 무대가 멈추는데 온라인은 정상: 행사장 노드의 하트비트와 스크린에서 그 노드로 가는 경로를 확인합니다.
- 활성화 코드가 거부됨: 이미 사용되지 않았는지, 해당 패키지가 아직 유효한지 확인합니다.
- 감사 로그에 프록시의 주소가 표시됨: TRUSTED_PROXIES를 그 프록시로 설정하고 패널을 재시작합니다.