Skip to main content

-846X (Edge/Auth Server Errors)

Notice

This document is a machine-translated draft and is currently undergoing review. Some content may be inaccurate or differ from the original Korean version. For the most precise information, refer to the Korean documentation.

These errors occur during the playback URL validation stage (edge server). They are mainly triggered by security policy violations or when playback restriction conditions are met.

-8464​

  • Error code: -8464
  • Type: ERROR_DUPLICATION_BLOCK_PROCESS
  • Summary: Registered device limit exceeded

Cause​

This error occurs when a user attempts to play a video from a new device while the maximum number of registered devices configured in the Kollus VOD console has already been reached.

  • This applies when the [Concurrent playback on registered devices] or [One registered device at a time] policy is enabled in the channel settings.
  • Access is blocked when a user attempts to register and access an additional new device after all allowed device slots have been used.

Resolution​

  • Display a user-facing popup: Show a message on the viewer UI such as "This device exceeds the registered device limit. Please remove one of your existing devices or contact customer support."
  • Manage the device list: If an administrator needs to directly manage or reset a user's registered device list, access the Kollus VOD console or use the admin API to handle it.

-8467​

  • Error code: -8467
  • Type: ERROR_MEDIA_KEY_TIME_EXPIRE
  • Summary: Media key validity period expired

Cause​

This occurs when a playback URL is generated, cached by the client for an extended period, and then a playback attempt is made after a delay. The media key included in the playback URL has expired. This is separate from the expt value in the JWT Payload — it is the edge server's own validity expiration policy.

Resolution​

Re-issue a new playback URL (JWT) and try playing the video again. If the client-side source code includes logic that caches the playback URL, reduce the TTL (time-to-live) of that cache, or modify the logic to issue a new URL every time a video is called.

-8469​

  • Error code: -8469
  • Type: ERROR_HEAVY_REQUEST
  • Summary: Excessive playback requests detected

Cause​

This occurs when an excessive number of playback API requests originate from the same viewer account or the same network IP address within a short period of time.

Resolution​

Adjust the logic on the authentication server side to reduce the frequency of playback URL generation and issuance. Also, implement defensive code in the client-side application to prevent unnecessary duplicate requests caused by actions such as repeated user clicks from being sent consecutively.

-8471​

  • Error code: -8471
  • Type: ERROR_GEO_RESTRICTION
  • Summary: Country/region playback restriction policy violated

Cause​

This occurs when a playback request comes from an IP address that violates the country/region playback allowlist policy defined in the console channel settings or in the JWT.

Diagnosis​

  • Go to the channel settings menu in the Kollus VOD console and verify that the allowed and blocked country lists are configured correctly.
  • If the geo_policy field is declared in the JWT Payload generated by the integration server, validate its input value.
  • If the user is using a VPN, the actual location of the bypassed IP may be identified as a restricted country, causing this error even in an otherwise normal environment.

User-facing message (example)​

"This content is not available in your region."

-8475​

  • Error code: -8475
  • Type: ERROR_USED_MEDIA_KEY
  • Summary: Duplicate use of the same media key

Cause​

  • The client copied an already-used playback URL and attempted to reuse it multiple times. By default, a one-time URL key can only be used once for security purposes.
  • The client sent multiple playback requests simultaneously to the server using the same URL.
  • The user refreshed the browser (F5) or navigated back, then called the same URL again.

Resolution​

Change the business logic so that a new JWT is issued from the server every time a video playback request event occurs.

-8479​

  • Error code: -8479
  • Type: ERROR_DUPLICATION_BLOCK_MEDIA_KEY
  • Summary: Concurrent login and simultaneous playback blocked

Cause​

This error occurs when the "One device at a time" security policy is enabled in the Kollus VOD console channel settings. When a session using the same viewer identifier (client_user_id) is already maintaining playback on another device, a new playback attempt from a different device is treated as duplicate access and the new session is blocked.

  • Behavior: Depending on the console policy configuration, when playback starts on a new device, either the existing device's streaming session is immediately terminated and the -8479 error is returned, or the physical playback action on the newly accessing device is entirely blocked.

Diagnosis​

Call the following API to track the blocking history for concurrent playback policy violations.

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

User-facing message (example)​

"Playback is already active on another device. Please stop playback on the other device and try again."