장치 관리
CASTOVIA가 물리적 장치를 구독과 연결하는 방법 — 모델 지식도 필요 없고, 펌웨어 업데이트도 필요 없으며, MAC 주소만 있으면 됩니다.
지원되는 장치 유형
MAG Boxes
MAG 250, 254, 322, 324, 420, 424 등
Formuler Boxes
Z8 Pro, Z10 Pro, Z11 Pro, GTV 등
Android TV / STB
IPTV 앱이 설치된 모든 Android TV 박스
Enigma2 / Linux STB
Dreambox, VU+ 및 유사 장치
MAC 매칭 작동 방식
전체 흐름은 놀랄 만큼 단순합니다. 로그인 화면도 없고, 인증 정보도 없고, 박스의 설정 파일도 없습니다. 실제로 어떻게 동작하는지 정확히 보면 다음과 같습니다:
MAC 주소 읽기
모든 Set-Top Box에는 공장에서 하드웨어에 고유한 MAC 주소가 각인되어 있습니다. 장치 하단이나 뒷면의 스티커에서 확인할 수 있으며, 형식은 00:1A:79:xx:xx:xx 입니다.
MAC 주소는 영구적이며 변경할 수 없습니다. 이 특정 물리 장치를 고유하게 식별합니다.
Admin Panel에 등록
Admin → Devices에서 "Add Device"를 클릭하고 MAC 주소를 입력합니다. 이를 구독 라인(subscription)에 할당하면 됩니다. 장치 모델, 펌웨어 버전, 기술 세부 정보는 전혀 필요하지 않습니다.
대량 배포의 경우 CSV를 통해 MAC을 일괄 가져올 수도 있습니다.
박스에 Portal URL 설정
박스 자체에는 구성해야 할 설정이 딱 하나 있습니다: Portal URL입니다. 도메인(예: http://tv.yourdomain.com)을 입력하세요. 이것이 박스에 필요한 유일한 구성입니다 — 언제나.
많은 운영자는 고객에게 배송하기 전에 박스에 이를 미리 설정해 두므로, 최종 사용자는 아무런 설정도 하지 않아도 됩니다.
박스가 자동으로 연결
박스가 시작되면 Portal URL로 HTTP 요청을 보내고, 요청에 자신의 MAC 주소를 포함합니다. CASTOVIA는 데이터베이스에서 MAC을 조회해 일치하는 구독을 찾고, 채널 목록, EPG 데이터, VOD 카탈로그를 전달합니다.
박스는 자신의 구성에 대해 아무것도 "알지" 못합니다. 그냥 MAC을 알리고, 서버가 매칭을 처리합니다.
구독자가 TV 시청
최종 사용자는 귀하의 브랜드로 제공되는 채널, EPG 가이드, VOD 라이브러리를 보게 됩니다. 뒤에서 CASTOVIA가 작동하고 있다는 사실은 전혀 알지 못합니다. 그것은 귀하의 브랜드, 귀하의 서비스입니다.
연결 흐름
박스 전원 켜짐
MAC 읽기
Portal URL 접속
요청에 MAC 전송
서버 조회
일치하는 구독 찾기
콘텐츠 전달
채널, EPG, VOD
왜 MAC 기반이 Username/Password보다 나은가
XUI.ONE 같은 기존 패널은 username/password 인증을 사용합니다. STB 장치에서 MAC 기반이 더 우수한 이유는 다음과 같습니다:
계정 공유 불가
MAC 하나 = 물리적 장치 하나입니다. MAC 주소는 username/password처럼 공유할 수 없습니다.
즉시 장치 교체
구독자의 박스가 고장 났나요? 패널에 새 박스의 MAC을 입력하면 기존 것은 즉시 비활성화됩니다. 10초면 끝납니다.
최종 사용자 설정 0
구독자는 박스를 연결하고 WiFi에 연결하기만 하면 됩니다. 로그인 화면도 없고, 비밀번호를 잊어버릴 일도 없습니다.
자동 비활성화
패널에서 MAC을 제거하면 → 박스는 더 이상 연결할 수 없습니다. 원격 삭제나 복잡한 프로비저닝 해제가 필요하지 않습니다.
Username/Password도 지원
CASTOVIA는 앱 기반 구독자(Android, iOS, 웹 플레이어)를 위한 기존 username/password 라인도 지원합니다. MAC 기반 관리는 하드웨어 식별자가 인증 정보를 대체하는 STB/MAG 유형 장치에 특히 적합합니다.