네트워크 화이트리스트 등록
기업 사내망, 학교망 등 방화벽 보안 정책이 엄격히 적용된 특수 네트워크 환경에서 Kollus 플레이어 재생 기능 및 서버 간 콜백 통신이 차단될 때 활용하는 방화벽 차단 대응 가이드입니다.
증상
- 특정 사내망/학교망 환경에서만 영상 재생 오류가 발생합니다.
- 스마트폰 개인용 핫스팟(셀룰러 데이터) 네트워크로 전환하여 테스트하면 정상적으로 재생됩니다.
-
에러 코드
- DNS 해석 실패: -8006, -9006, -10006
- 접속 거부: -8007, -9007, -10007
오류 유형별 차단 주체 분류
발생하는 오류 유형에 따라 화이트리스트 등록 대상과 조치 주체가 다릅니다.
| 오류 유형 | 설명 | 화이트리스트 등록 위치 |
|---|---|---|
| 플레이어 재생 오류 | 시청자 디바이스에서 Kollus CDN 및 스트리밍 서버 접근에 실패하는 현상입니다. | 시청자 사내/학내 네트워크 (해당 기관 방화벽 담당 부서에 도메인 허용 요청 필요) |
| 콜백 서버 접근 오류 | Kollus 게이트웨이 서버가 고객사의 콜백 URL로 검증 요청을 보낼 때 차단당하는 현상입니다. | 고객사 백엔드 콜백 수신 서버 (서버 앞단 방화벽 정책에 Kollus 서버 IP 허용 필요) |
플레이어 재생 오류 (재생 허용 도메인 설정)
시청자가 이용 중인 사내망 또는 학내망 방화벽 설정에서 아래 도메인 대역의 아웃바운드(Outbound) 통신을 허용해야 합니다.
| 도메인 패턴 | 용도 |
|---|---|
*.kollus.com | Kollus 플레이어, CDN, API 전체 |
*.catenoid.net | Kollus 서비스 인프라 |
license.pallycon.com | Multi-DRM (Widevine/FairPlay/PlayReady) 라이선스 서버 |
*.pallycon.com | DoveRunner 라이선스 관련 전체 |
- 고정 IP 목록 안내: 방화벽 정책상 도메인이 아닌 정확한 물리 IP 주소 대역이 필요한 경우, 기술 지원팀(tech_support@kollus.com)으로 문의하면 최신 IP 목록을 제공받을 수 있습니다.
"Kollus 플레이어를 통한 영상 시청을 위해
*.kollus.com,*.catenoid.net,*.pallycon.com도메인 대역에 대한 HTTP/HTTPS(80, 443 포트) 아웃바운드 접속 허용 처리를 요청드립니다."
콜백 서버 접근 오류 (콜백 수신 서버 IP 허용)
고객사의 콜백 수신 서버(DRM 다운로드 콜백 및 플레이 콜백 URL 엔드포인트)가 방화벽으로 보호되어 있는 경우, Kollus 서버로부터 유입되는 인바운드(Inbound) 인증 요청 패킷을 수신할 수 있도록 허용해야 합니다.
최신 Kollus 발 송 서버 고정 IP 목록이 필요한 경우, 기술 지원팀(tech_support@kollus.com)으로 문의해 주세요. 단, IP 목록은 인프라 확장 및 장비 변경 정책에 따라 유동적으로 변동될 수 있습니다. 따라서 도메인 기반 화이트리스트(SNI 필터링 규격)를 사용하는 것이 더 안정적입니다.
단계별 방화벽 진단 가이드
사용자로부터 "특정 사내망/학내망 환경에서만 영상이 재생되지 않는다"는 문의가 접수됐을 때, 해당 네트워크망 내부 PC에서 아래 터미널 명령어를 순서대로 실행하여 차단 여부를 검증하세요.
1. Kollus 스트리밍 도메인 해석 검증 (타깃 네트워크 환경 내부에서 실행)
nslookup v.kr.kollus.com
nslookup edge-kr.kollus.com
2. HTTP/HTTPS 프로토콜 통신 연결 검증
curl -I https://v.kr.kollus.com
3. Multi-DRM 라이선스 도메인 해석 검증 (Multi-DRM 연동 채널인 경우 실행)
nslookup license.pallycon.com
- 결과 판별: 명령어 구동 결과 시스템 응답 패킷이 리턴되지 않거나 Timeout 에러가 검출된다면, 현재 이용 중인 해당 기관 네트워크 방화벽 장비에서 해당 도메인 통신을 차단하고 있는 상태입니다.
주의사항
- 일시적인 네임서버 장애 가능성: 사용자가 무선 Wi-Fi망을 일시적으로 변경했거나 디바이스의 로컬 DNS 서버 설정을 수정한 직후 일시적으로 문제가 해결되는 현상은, 방화벽 차단이 아닌 기기 자체의 일시적인 DNS 장애일 가능성이 높습니다.
- 기업용 보안 솔루션 예외 조치: 사내 인트라넷 환경에 웹 필터링 솔루션, DLP(데이터 유출 방지 시스템), 혹은 SSL 인터셉션 프로그램이 상시 가동되어 HTTPS 트래픽을 검사하는 경우, 추가적인 예외 처리를 연동해야 합니다.
- SSL 인터셉션 우회 설정 필수: SSL 인터셉션이 활성화된 특수 환경에서는 DRM 라이선스 요청이 차단될 수 있으므로 Kollus 및 DoveRunner 관련 도메인은 반드시 SSL 검사 예외 대상(Bypass)으로 등록하세요.