본문으로 건너뛰기

-846X (엣지/인증 서버 에러)

재생 URL 검증 단계(엣지 서버)에서 발생하는 에러들입니다. 주로 보안 정책 위반 또는 재생 제한 조건 충족 시 발생합니다.

-8464​

  • 에러 코드: -8464
  • 타입: ERROR_DUPLICATION_BLOCK_PROCESS
  • 요약: 디바이스 개수 제한 초과

원인​

Kollus VOD 콘솔에서 설정한 '등록 디바이스 최대 수'를 초과한 상태에서 새로운 디바이스로 영상 재생을 시도할 때 발생합니다.

  • 채널 설정 메뉴 내에서 [등록된 기기만 중복 재생 허용] 또는 [등록된 기기 중 동시에 하나의 기기만 재생 허용] 정책이 활성화되어 있는 경우입니다.
  • 허용된 디바이스 등록 대수를 모두 사용한 상태에서 새로운 디바이스 기기를 추가로 등록 및 접근하려고 시도할 때 차단됩니다.

해결 방법​

  • 사용자 안내 팝업 노출: 시청자 UI 화면에 "이 기기는 등록된 기기 수 한도를 초과했습니다. 기존 기기 중 하나를 해제하거나 고객 지원에 문의해 주세요." 등의 안내 문구를 출력하세요.
  • 디바이스 목록 관리: 관리자가 사용자의 등록 기기 목록을 직접 관리하거나 초기화해야 하는 경우, Kollus VOD 콘솔 시스템에 접속하거나 관리자 API를 활용하여 처리하세요.

-8467​

  • 에러 코드: -8467
  • 타입: ERROR_MEDIA_KEY_TIME_EXPIRE
  • 요약: 미디어 키 유효 기간 만료

원인​

재생 URL을 생성한 후, 클라이언트에서 해당 URL을 장시간 캐시해 두고 뒤늦게 재생을 시도하여 발생합니다. 재생 URL에 포함된 미디어 키 자체의 유효 시간이 만료된 상태이며, 이는 JWT Payload 내부의 expt 설정값 만료와는 별개로 동작하는 엣지 서버 자체의 유효성 만료 처리 정책입니다.

해결 방법​

새로운 재생 URL(JWT)을 다시 발급받은 후 동영상을 재생해 보세요. 만약 클라이언트 측 소스 코드에서 재생 URL을 임의로 캐시하는 로직이 구현되어 있다면 해당 캐시의 TTL(유효 기간)을 줄이거나, 영상을 호출할 때마다 매번 새로 URL을 발급받도록 로직을 수정하세요.

-8469​

  • 에러 코드: -8469
  • 타입: ERROR_HEAVY_REQUEST
  • 요약: 과도한 재생 요청 발생

원인​

단시간 내에 동일한 시청자 계정 또는 동일한 네트워크 IP 주소로부터 과도한 재생 API 요청이 발생한 경우입니다.

해결 방법​

인증 서버단에서 재생 URL을 생성 및 발급하는 빈도를 줄이도록 로직을 조정하고, 클라이언트 측 애플리케이션에서 사용자의 중복 클릭 등으로 인한 불필요한 중복 요청이 연속해서 전송되지 않도록 방어 코드를 구현하세요.

-8471​

  • 에러 코드: -8471
  • 타입: ERROR_GEO_RESTRICTION
  • 요약: 국가/지역 재생 제한 정책 위배

원인​

콘솔 채널 설정 또는 JWT 내에 정의된 특정 국가/지역 재생 허용 정책을 위반한 IP 주소 환경에서 영상 재생 요청이 유입된 경우입니다.

진단​

  • Kollus VOD 콘솔의 채널 설정 메뉴로 이동하여 허용 및 차단 국가 목록이 올바르게 구성되어 있는지 확인하세요.
  • 연동 서버에서 생성하는 JWT Payload 내부에 geo_policy 설정 필드가 선언되어 있는 경우 해당 입력값을 검증하세요.
  • 사용자가 VPN을 이용 중인 경우, 우회된 IP의 실제 위치가 제한 국가로 판별되어 정상적인 환경에서도 해당 에러가 발생할 수 있습니다.

사용자 안내 (예시)​

"해당 콘텐츠는 현재 지역에서 시청할 수 없습니다."

-8475​

  • 에러 코드: -8475
  • 타입: ERROR_USED_MEDIA_KEY
  • 요약: 동일한 미디어 키 중복 사용

원인​

  • 이미 한 번 사용된 재생 URL 주소를 클라이언트가 그대로 복사하여 여러 번 재사용하려고 시도한 경우입니다. 기본적으로 One-time URL 속성의 키는 보안상 단 1회만 사용이 가능합니다.
  • 클라이언트에서 동일한 URL로 복수의 재생 요청을 동시에 서버로 전송한 경우입니다.
  • 사용자가 브라우저 화면을 새로고침(F5)하거나 뒤로 가기 동작을 수행한 뒤, 동일한 URL을 그대로 재호출한 경우입니다.

해결 방법​

영상 재생 요청 이벤트가 발생할 때마다 새로운 JWT를 서버에서 발급하는 구조로 비즈니스 로직을 변경하세요.

-8479​

  • 에러 코드: -8479
  • 타입: ERROR_DUPLICATION_BLOCK_MEDIA_KEY
  • 요약: 중복 로그인 및 동시 시청 차단

원인​

Kollus VOD 콘솔 채널 설정에서 '동시에 하나의 기기만 재생 허용' 보안 정책이 활성화되어 있는 상태에서 발생합니다. 동일한 시청자 식별자(client_user_id) 데이터를 사용하는 세션이 이미 다른 기기에서 재생을 유지하고 있을 때, 새로운 기기에서 재생을 시도하면 중복 접근으로 간주하여 새 세션 실행을 차단합니다.

  • 동작 방식: 콘솔 정책 설정 옵션에 따라 새 기기에서의 재생 시작 시 기존 기기의 스트리밍 세션이 즉시 끊어지며 -8479 에러가 반환되거나, 혹은 신규로 진입한 새 기기 측의 물리적 재생 행위 자체가 전면 차단됩니다.

진단​

동시 시청 정책 위반으로 인한 차단 이력을 추적하기 위해 아래 API를 호출하세요.

  • 조회 API: GET /service-accounts/{key}/duplicate-blocks/logs

사용자 안내 (예시)​

"다른 기기에서 재생 중이어서 이 기기에서는 재생할 수 없습니다. 다른 기기의 재생을 중단 후 시도해 주세요."