-846X (エッジ/認証サーバーエラー)
このドキュメントは機械翻訳で作成された下書きであり、現在レビュー中です。機械翻訳の特性上、一部の内容が不正確であったり、韓国語の原文と異なる場合があります。より正確な情報については、韓国語のドキュメントをご参照ください。
再生 URL 検証段階（エッジサーバー）で発生するエラーです。主にセキュリティポリシー違反または再生制限条件を満たした場合に発生します。
-8464
- エラーコード: -8464
- タイプ:
ERROR_DUPLICATION_BLOCK_PROCESS - 概要: 登録デバイス数の上限超過
原因
Kollus VOD コンソールで設定した「登録デバイスの最大数」を超えた状 態で、新しいデバイスから動画の再生を試みた場合に発生します。
- チャンネル設定メニュー内で [登録デバイスの同時再生を許可] または [登録デバイス 1 台のみ再生可能（重複再生不可）] ポリシーが有効になっている場合です。
- 許可されたデバイス登録数をすべて使用した状態で、新しいデバイスを追加登録してアクセスしようとした場合にブロックされます。
解決方法
- ユーザー向け案内ポップアップの表示: ユーザー 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 - 概要: 同一メディアキーの重複使用
原因
- すでに 1 度使用した再生 URL をクライアントがそのままコピーして複数回再利用しようとした場合です。基本的に One-time URL 属性のキーはセキュリティ上、1 回のみ使用可能です。
- クライアントが同一の URL で複数の再生リクエストを同時にサーバーへ送信した場合です。
- ユーザーがブラウザ画面を更新（
F5）または戻る操作を行った後、同一の URL をそのまま再呼び出しした場合です。
解決方法
動画再生リクエストイベントが発生するたびに、サーバーから新しい JWT を発行する構造にビジネスロジックを変更してください。
-8479
- エラーコード: -8479
- タイプ:
ERROR_DUPLICATION_BLOCK_MEDIA_KEY - 概要: 重複ログインおよび同時視聴のブロック
原因
Kollus VOD コンソールのチャンネル設定で「同時に 1 つのデバイスのみ再生可能」セキュリティポリシーが有効になっている状態で発生します。
同一のユーザー識別子（client_user_id）を使用するセッションがすでに別のデバイスで再生を維持している場合、新しいデバイスから再生を試みると重複アクセスとみなされ、新しいセッションの実行がブロックされます。
- 動作方式: コンソールのポリシー設定オプションに応じて、新しいデバイスでの再生開始時に既存デバイスのストリーミングセッションが即座に切断されて
-8479エラーが返されるか、または新しくアクセスしたデバイス側の物理的な再生行為自体が全面的にブロックされます。
診断
同時視聴ポリシー違反によるブロック履歴を追跡するには、以下の API を呼び出してください。
- 照会 API:
GET /service-accounts/{key}/duplicate-blocks/logs
ユーザー向けメッセージ（例）
"別のデバイスで再生中のため、このデバイスでは再生できません。別のデバイスの再生を停止してから再度お試しください。"