-9XXX, -10XXX (コールバック/ネットワーク Curl エラー)
-9xxx と -10xxx のエラーコードは、libcurl エラーコードの仕様を基に定義されたネットワーク通信エラーです。
各エラーコードの末尾の数字は、Curl 固有のエラー番号を意味します。 DRM Download Callback の処理中に例外が発生した場合は -90XX の形式で返され、Play Callback の処理中に例外が発生した場合は -10XXX 形式のコードにマッピングされて対応されます。
エラーコードコールバック対応表
| DRM Download Callback | Play Callback | Curl エラー種 別 | 説明 |
|---|---|---|---|
| -9001 | -10001 | CURLE_UNSUPPORTED_PROTOCOL (1) | サポートされていないプロトコル（コールバック URL 形式エラー） |
| -9006 | -10006 | CURLE_COULDNT_RESOLVE_HOST (6) | DNS 解決失敗（ドメインを IP アドレスに変換不可） |
| -9007 | -10007 | CURLE_COULDNT_CONNECT (7) | サーバー到達後に接続拒否、または特定ポートがブロックされている |
| -9028 | -10028 | CURLE_OPERATION_TIMEDOUT (28) | コールバック対象サーバーの応答 Timeout |
| -9056 | -10056 | CURLE_RECV_ERROR (56) | データ受信中にネットワーク接続が強制終了された |
-9001 / -10001
- エラーコード: -9001, -10001
- 概要: libcurl がサポートしていないプロトコルの使用
原因
| 原因 | 説明 | 例 |
|---|---|---|
| プロトコルの欠落 | https:// などが省略されている場合です。 | example.com/callback |
| 無効なプロトコル | メディア通信でサポートされていない外部プロトコル形式が指定されている場合です。 | ftp://example.com/callback, file:///... |
| URL 形式エラー | 特殊記号の入力ミスにより、正常なアドレスの解析ができない場合です。 | http:/example.com（スラッシュ欠落）、https//...（コロン欠落） |
| 空白・特殊文字の混入 | Kollus コンソールの設定画面でアドレスを入力する際に、微細な空白が含まれている場合です。 | - |
診断
Kollus VOD コンソールシステムに登録されているコールバック URL をそのままコピーし、正しい形式かどうかを確認してください。
呼び出しアドレスが https:// または http:// から始まっているかを確認してください。
curl -v "YOUR_CALLBACK_URL"
-9006 / -10006
- エラーコード: -9006, -10006
- 概要: コールバックサーバードメインの DNS 解決失敗
原因
- 一時的なネットワーク不安定: Wi-Fi ネットワークの切り替え直後、またはモバイルデータ通信の電波環境が一時的に弱くなっている場合です。
- DNS サーバーエラー: ISP または社内イントラネットの DNS サーバー機器に一時的な障害が発生した場合です。
- 社内ネットワーク内部ファイアウォールによるブロック: 企業・学校・公共機関の内部ネットワーク環境において、セキュリティポリシーにより外部の特定ドメインへの通信が任意にブロックされている場合です。
- コールバック URL ドメインの入力ミス: 存在しないドメインアドレスを誤って入力した場合です。
解決方法
方法 A: ネットワークへの再接続（基本対処）
- ご利用のデバイスの Wi-Fi 設定をオフにしてから再度オンにするか、モバイルデータ通信に切り替えて通信状態を更新してください。
- これにより、現在の環境に蓄積された古い DNS キャッシュデータがクリアされます。
方法 B: コールバック URL ドメインの有効性確認
以下のコマンドを実行して、現在設定されているコールバック対象サーバードメインの解決経路を追跡してください。
nslookup your-callback-domain.com
# or
dig your-callback-domain.com
- 結果の判別: コマンドの実行結果が無応答、または
NXDOMAINエラーが返された場合は、ドメインアドレスに入力ミスがあるか、DNS 登録処理に問題が発生している状態です。
方法 C: 社内ネットワークのセキュリティファイアウォール例外処理
Kollus サーバーがコールバック URL にリクエストを送信する構成のため、お客様のサーバー（コールバック受信サーバー）が Kollus サーバーの IP からのリクエストを許可する必要があります。
- 参考文書: ネットワークホワイトリスト設定
方法 D: 営業担当者へのお問い合わせ
上記の対処を順番に実施した後もエラーが継続して検出される場合は、 エラーが観測されているデバイスの OS 環境、ネットワーク回線の種類、サービスページのログに記録されたエラー発生頻度などの具体的なデータを収集のうえ、営業担当者(jp_sales@catenoid.net)までお問い合わせください。
-9007 / -10007
- エラーコード: -9007, -10007
- 概要: DNS 解決は成功したが対象サーバーへの接続失敗
診断
- お客様のコールバック受信サーバーが正常に稼働しているか確認してください。
- ネットワークファイアウォールの設定で、80（HTTP）または 443（HTTPS）ポートが開放されているか確認してください。
- Kollus サーバーの IP がお客様のコールバックサーバーのファイアウォールで許可されているか確認してください。
- 参考文書: ネットワークホワイトリスト設定
-9028 / -10028
- エラーコード: -9028, -10028
- 概要: コールバックサーバーの応答 Timeout
診断および解決方法
- パフォーマンス基準: コールバックサーバーの応答完了時間は、最大 3 秒以内に収まるよう、構造的に演算の最適化を行う必要があります。
- ボトルネック箇所の追跡: Timeout が繰り返し発生する場合は、データベース（DB）クエリや外部 API 呼び出しなどによるボトルネックが発生していないか、ソースコードのロジックをデバッグしてください。
-10035
- エラーコード: -10035
- 概要: プレイコールバック（認証）通信中のSSL/TLSハンドシェイク失敗
原因
コールバックサーバー側（全ユーザー対象で発生する場合）
- サーバーが許可するTLSバージョンおよび暗号スイート（Cipher Suite）がクライアントの対応範囲と不一致（例：TLS 1.3のみ許可、旧式の暗号スイートのみ許可など）
- ロードバランサー（LB）、WAF、CDNなどのTLS終端機器によるハンドシェイク遮断または接続の強制切断
- TLS終端機器やサーバーの過負荷によるハンドシェイク処理中の接続終了
- SNI（Server Name Indication）が含まれないリクエストに対するサーバー側の拒否設定
クライアント側（一部ユーザー対象で発生する場合）
- セキュリティ・ウイルス対策ソフトのHTTPSスキャン（SSL Inspection）による干渉
- 企業・学校・公共ネットワークのプロキシまたはファイアウォールによる遮断
- ハンドシェイク進行中の一時的なローカルネットワークの瞬断・切断
診断および解決方法
コールバックサーバー側
- プロトコルおよび暗号スイートの確認: SSL Labsまたは
openssl s_client -tls1_2/-tls1_3コマンドでサーバーの対応仕様を確認し、TLS 1.2/1.3および汎用的な暗号スイートを許可するように設定します。 - インフラログの分析: ユーザーからの報告日時を基準に、コールバックサーバー、ロードバランサー（LB）、WAFのログでハンドシェイク失敗や遮断ログを確認します。
クライアント側
以下の手順で確認を進めます。
- 別ネットワークでのテスト: モバイルホットスポット（テザリング）やモバイルデータ通信など、異なるネットワーク環境でも再現するか確認します。
- セキュリティソフトの確認: ウイルス対策ソフトのHTTPSスキャン機能を無効化し、正常に動作するか確認します。
- OSのアップデート: 端末のOSを最新バージョンにアップデートし、最新の暗号化ライブラリが適用された状態を維持します。