이 가이드는 산업의 개념을 플랫폼에 현재 있는 객체(부케, 라인, 패키지, 파트너 계정, 노드, API)에 대응시킵니다. 이는 개념적 대응이며 산업 전용 기능이 아닙니다. 또한 파트너 계정은 위임 계정이며 격리된 테넌트가 아닙니다.
개념적 대응
패널에는 회의, 주민, 부서라는 이름의 항목이 없습니다. 표는 어떤 객체가 어떤 역할을 하는지 보여주며, 아래 장들은 그 순서대로 설정합니다.
| 내 산업에서는 | 플랫폼에서는 | 패널에서의 위치 |
|---|---|---|
| 의회 회의 또는 공개 채널 | 실시간 채널: 소스, EPG, 출력 형식을 가진 스트림 | Streams → 실시간 스트림 추가(소스 URL 또는 RTMP 푸시) |
| 회의 아카이브와 교육 라이브러리 | VOD 카탈로그: 시즌과 에피소드가 있는 영화와 시리즈, 카테고리, 메타데이터 | Movies와 Series, 또는 VOD 인제스트 작업 |
| 공개 프로그램 또는 부서 컬렉션 | 부케: 패키지가 부여하는 채널, 영화, 시리즈의 이름 있는 묶음 | Bouquets, Streams와 Movies / Series에서 생성 |
| 주민 또는 직원 액세스 | 라인: 패키지, 부케, 만료일, 연결 제한, 출력을 가진 하나의 액세스 | Lines → 추가, 또는 활성화 코드, 또는 Reseller API |
| 공개 또는 직원 액세스의 유효 기간 | 라인의 만료일. 패키지, 크레딧 또는 API로 갱신됩니다 | 라인의 만료일과 패키지의 기간 |
| 의회 시스템 연동 | Reseller API와 웹훅: 자체 시스템에서 수행하는 패널의 작업 | 리셀러 대시보드의 Reseller API 키와 웹훅 |
사전 준비
설치 전에 준비할 것.
- 기관 데이터 센터의 서버(Ubuntu 22.04 또는 24.04), 설치 프로그램, 공개 주소용으로 기관의 리버스 프록시 뒤에 있는 도메인.
- RTMP를 푸시할 수 있는 회의장의 인코더 또는 비디오 믹서, 지난 회의의 녹화본, 직원용 교육 영상.
- 무엇을 공개하고 무엇을 내부용으로 할지, 공개 라인의 유효 기간, 운영자 중 누구에게 패널 계정을 줄지에 대한 결정.
인프라 구축
관리 서버, 그다음 원격 거점.
- 기관의 서버에서 설치 프로그램을 실행하고, 패널을 TLS가 적용된 리버스 프록시 뒤에 두며 TRUSTED_PROXIES를 설정해 감사 로그와 IP 규칙이 실제 주소를 보게 합니다.
- 재생 기본 주소를 주민이 접속하는 공개 주소로 설정하고, 서버에 라이선스 키를 설정합니다.
- 회의장이 있는 제2청사처럼 필요한 거점에는 Servers에서 노드를 등록합니다. 패널이 SSH로 설치합니다.
- 홍보팀에는 공개 라인 권한이 있는 파트너 계정(리셀러)을, 인사 또는 교육 부서에는 직원 라인용 파트너 계정을 만듭니다.
콘텐츠 정리
공개 프로그램과 부서별 컬렉션.
- 회의, 위원회, 공공 정보용 카테고리를 만들고, 기관마다 시리즈 하나, 회의마다 에피소드 하나를 만듭니다.
- 실시간 회의 채널과 아카이브를 담은 공개 부케 하나와, 부서별 교육 컬렉션마다 부케 하나를 만듭니다.
- 공개 부케만 부여하고 이용 기간으로서의 긴 기간을 가진 주민용 패키지를 만듭니다.
- 공개 부케에 교육 부케와 내부 부케를 더하는 직원용 패키지를 만듭니다.
파트너(리셀러) 설정
액세스를 배포하는 팀.
- 라인 권한만 있고 카탈로그나 설정에는 접근할 수 없는 그룹을 만듭니다.
- 홍보팀을 주민용 패키지를 가진 파트너 계정으로, 인사 또는 교육 부서를 직원용 패키지를 가진 파트너 계정으로 추가합니다.
- 여러 부서를 가진 기관은 부서마다 자체 파트너 계정을 줄 수 있습니다. 위임된 계정이며 격리된 설치가 아닙니다.
주민·직원 라인 설정
공개 라인과 직원 라인.
- 의회 웹사이트용 Reseller API 키를 만들어 그 비밀 저장소에 보관합니다. 주민이 액세스를 요청하면 공개 패키지와 요청 ID로 action=create_line을 호출합니다.
- 공개 라인에는 긴 만료일을, 가구 시청에 맞는 연결 제한을 설정합니다.
- 직원 라인은 의회의 직원 시스템에서 API로, 또는 Lines → 추가에서 직원 패키지로 부서별로 만듭니다.
- 네트워크가 허용하면 직원 라인을 기관의 주소 범위에 묶습니다.
회의 아카이브와 교육 라이브러리
녹화본을 주문형으로.
- 녹화된 각 회의를 기관별 시리즈의 에피소드로 추가합니다. VOD 인제스트 작업으로 인제스트하거나 업로드하고 제목, 날짜, 설명을 붙입니다.
- 회의 시리즈는 공개 부케에, 교육 라이브러리는 부서 부케에 넣습니다.
- 공개 패키지와 직원 패키지의 테스트 라인으로 재생을 확인해 누구에게 무엇이 보이는지 확인합니다.
실시간 회의
회의장을 실시간 채널로.
- 회의장 인코더의 RTMP 푸시로 실시간 스트림을 추가하고 공개 부케에 넣습니다.
- 캐치업을 활성화해 늦게 온 시청자가 되감을 수 있게 하고, 어느 회의가 진행 중인지 알 수 있도록 EPG 항목이나 제목을 추가합니다.
- 각 회의 전에 피드를 테스트하고, 제2의 거점에서도 회의를 연다면 그 근처에 노드를 두세요.
만료와 갱신
공개용은 길게, 직원용은 재직에 맞춰.
- 공개 라인은 패키지 기간만큼 유지됩니다. 주민이 다시 요청하면 action=renew_line으로 연장합니다.
- 직원 라인은 그 사람이 기관에서 일하는 동안 갱신하고, 퇴직하면 action=disable_line으로 비활성화합니다.
- 의회 시스템을 웹훅에 등록해 만료 임박 및 비활성화된 라인을 확인합니다.
기관 시스템과의 연동
시스템이 액세스를 제어하고 플레이어가 재생합니다.
- 웹사이트와 직원 시스템이 키와 요청 ID로 Reseller API를 통해 라인을 생성, 갱신, 활성화, 비활성화합니다.
- 시청자용 싱글 사인온도, 특정 공공 부문 제품과의 기본 통합도 없습니다. 시청자는 자신의 라인 자격 증명으로 플레이어에 로그인합니다.
- 보고 도구에는 읽기 전용 플래그, IP 허용 목록, 만료일이 있는 Admin API 키를 사용합니다.
보안 고려 사항
기관이 운영하고, 열어야 할 곳은 열어 둡니다.
- 플랫폼은 기관의 인프라에서 TLS가 적용된 리버스 프록시 뒤에 두고, 공개 자료와 내부 자료는 별도 부케로 분리합니다.
- 모든 패널 계정에 2단계 로그인과 팀별 권한 그룹을 적용하고, 패널이 외부에서 접속 가능하다면 로그인에 reCAPTCHA 또는 Turnstile을 설정합니다.
- 서명되고 만료되는 재생 링크, 라인별 연결 제한, 직원 라인의 주소 고정.
- 오프사이트 사본이 있는 암호화된 데이터베이스 백업과, 라인과 카탈로그의 모든 변경을 기록하는 감사 로그.
문제 해결
가장 먼저 확인할 일반적인 항목.
- 주민이 시청하지 못함: 라인의 만료일, 활성 상태 여부, 패키지의 공개 부케를 확인합니다.
- 회의가 시작되지 않음: 인코더에서 스트림으로의 푸시와 패널에서의 스트림 상태를 확인합니다.
- 직원에게 교육 라이브러리가 보이지 않음: 직원 라인의 패키지와 그것이 부여하는 부케를 확인합니다.
- 감사 로그에 프록시의 주소가 표시됨: TRUSTED_PROXIES를 그 프록시로 설정하고 패널을 재시작합니다.