メインコンテンツまでスキップ

ユーザーログエラー対応ガイド

SHIELD Gate 統合ログ中ユーザーログイベントがWARNまたはERRORレベルで記録されたときの意味と対応手順を整理した顧客用運用ガイドです。

目次​

1. 概要​

1.1 ログレベルの区分​

レベル意味
INFO正常動作または一般イベントの記録。別途措置は不要。
WARNサービス利用に直接的な影響はないが、点検の価値がある状況。
ERROR機能の実行に失敗しました。原因の確認と対応が必要です。

1.2 本ガイドの範囲​

  • このガイドはユーザーログの中でERROR レベルが発生する可能性のあるイベントに限定して詳細な対応を説明します。
  • 常にINFOロマンに記録されるイベントの一覧は5.1 付録参照。

2. ユーザーログイベントの概要​

以下の表はSHIELD Gateユーザーログの全イベントとERRORレベル発生可能性を整理したものです。

分類イベントコードイベント名ERROR 発生対応セクション
認証CALLBACK_SECURITY365_CODEログイン⚠️ (※1)—
POST_SIGN_OUTログアウト✅3.1
POST_RELAY_TOKENサービス移動✅3.1
NAVIGATE_TO_ADMIN_PAGE管理者ページに移動❌—
隔離ブラウザPOST_INQUIRY_WORK_ITEM_ACCESS_URLブラウザ接続❌—
RBI_URL_CHANGEDブラウザ接続後の移動❌—
RBI_CHECK_INPUT_TEXTユーザー入力の機微情報検査❌—
RBI_CLIPBOARD_ACCESS_RB2PC隔離ブラウザでコピー❌—
RBI_CLIPBOARD_ACCESS_PC2RB隔離ブラウザに貼り付け❌—
RBI_USAGE_ERROR隔離ブラウザエラー✅3.6 / 4
RBI_SESSION_TIMEOUT隔離ブラウザセッションタイムアウト❌—
RBI_KEYBOARD_INPUTキーボード入力のブロック❌—
パーソナライズPOST_FAVORITE_ITEMお気に入りに登録✅3.2
DELETE_FAVORITE_ITEMお気に入りの削除✅3.2
ファイルRBI_FILE_UPLOADファイルアップロード✅3.4
RBI_FILE_DOWNLOADファイルダウンロード✅3.5
RBI_FILE_VIEWER_REQUESTSHIELD Viewer リクエスト❌—
上部バーGET_EXTERNAL_INTERFACE_ACCESS_URL上部バー外部リンク接続✅3.3

※1 CALLBACK_SECURITY365_CODE 案内
ログインイベントはログインに成功した場合のみ記録されます。ログイン失敗自体はユーザー情報を確定できないため、別途ERRORログに残りません。ログイン失敗が繰り返される場合は、SOFTCAMPにお問い合わせください。

3. ERROR発生イベント別対応ガイド​

表内の「担当」表記規約
사용자— 再ログイン・再試行・環境確認など、自分で解決可能な範囲
고객사 관리자— 政策・権限・ファイアウォール・DNS・証明書など、顧客の運用領域で確認・設定によって解決可能な範囲
대상 사이트 측— 隔離ブラウザでアクセスする外部ウェブサイトの責任範囲
소프트캠프— サービス内部の問題と判断されるため、問い合わせが必要な範囲

3.1 POST_SIGN_OUT / POST_RELAY_TOKEN (ログアウト / サービス移動)​

🔧 責任区分の概要 — 소프트캠프 영역
このイベントのERRORはサービス内部の問題のみで発生します。顧客側の設定によって引き起こされるケースはなく、顧客側の措置項目なしですぐにSOFTCAMPにお問い合わせください対象です。

項目内容
イベントPOST_SIGN_OUT— SHIELD Gate ログアウトPOST_RELAY_TOKEN— Security365 管理センターから SHIELD Gate 管理者ページに移動
一般的な性格サービス内部の問題のみで発生します。ユーザー/顧客の設定から引き起こされるケースはありません。

3.1.1 発生可能な原因​

#原因担当
1内部データストレージ一時障害ソフトキャンプ
2認証サービス連携エラーソフトキャンプ

3.1.2 推奨措置​

  1. **[ユーザー]**再ログイン後、同じ作業を再試行してください。
  2. **[顧客会社管理者]**同じタイムゾーンの他のユーザーにも同じエラーが発生したか確認する（インフラ関連の問題判断）
  3. 同じ症状が続く場合はSOFTCAMP お問い合わせ

3.2 POST_FAVORITE_ITEM / DELETE_FAVORITE_ITEM (お気に入り登録 / 削除)​

🔧 責任区分の概要 — 소프트캠프 영역
このイベントのERRORはサービス内部データストレージの問題によってのみ発生します。顧客側の対応項目なしでSOFTCAMPへの問い合わせ対象です。

項目内容
イベントPOST_FAVORITE_ITEM— お気に入りに登録DELETE_FAVORITE_ITEM— お気に入りを削除
一般的な性格サービス内部データストレージの問題で主に発生。

3.2.1 発生可能な原因​

#原因担当
1内部データストレージ接続エラーソフトキャンプ
2その他のサービス内部例外ソフトキャンプ

3.2.2 推奨措置​

  1. **[ユーザー]**しばらくしてから再試行
  2. 繰り返し発生時SOFTCAMP お問い合わせ

3.3 GET_EXTERNAL_INTERFACE_ACCESS_URL (トップバー外部リンクアクセス)​

🔧 責任区分の概要 — 고객사 관리자 1차 점검
1次で顧客管理者の上部バー外部リンク設定を確認。設定が正常にもかかわらず発生する場合はSOFTCAMPにお問い合わせください。

項目内容
イベント管理者がユーザーページの上部バーに設定したカスタムボタンをユーザーがクリックして外部URLにアクセスする動作

3.3.1 発生可能な原因​

#原因担当備考
1上部バーの外部リンクが設定されていない状態で呼び出し顧客会社管理者管理者ページのUIで事前にブロックされるため、通常は発生しません。
2内部データストレージの照会エラーソフトキャンプ—

3.3.2 推奨措置​

  1. **[顧客会社管理者]**管理者ページ > 上部バー設定で該当のカスタムボタンが正常に登録されているか確認
  2. 設定が正常にもかかわらず繰り返し発生する場合SOFTCAMP お問い合わせ

3.4 RBI_FILE_UPLOAD (ファイルアップロード)​

🔧 責任区分の概要 — 외부 사이트 / 사용자 환경 1차 점검
ほとんどのケースはアップロード対象サイト側の問題またはユーザーPCのネットワーク環境の問題が1番の原因です。SHIELD Driveに関連する失敗は、権限・認証を確認した後、SOFTCAMPに問い合わせる対象です。

隔離ブラウザを通じてファイルアップロードプロセスで発生するERRORログです。アップロードパスによって原因が異なるため、以下の4つのケースに分けて説明します。

3.4.1 [ケース A] ローカル PC → 隔離ブラウザでアクセスしたサイトのアップロード​

ユーザーが隔離ブラウザで開いているサイトにローカルファイルを添付してアップロードする際に発生します。

#発生原因担当確認方法
1アップロード対象サイトサーバーの異常応答（サイトの一時障害、認証の期限切れ、ファイルサイズ/形式ポリシー違反など）対象サイト側ユーザーが対象サイトに直接アクセスして同じファイルをアップロード詩にも同様の症状があるか比較
2ネットワーク切断 / CORS / DNS失敗によるリクエスト自体の失敗ユーザー / 顧客管理者ユーザーPCのネットワーク状態、VPN接続、ファイアウォールポリシーの確認
3対象サイトがJSONではない形式で応答（HTMLエラーページなど）対象サイト側対象サイト側の問題の可能性が高い

推奨される対策

  1. ユーザーPCから対象サイトに直接アクセスし、同じファイルのアップロードが正常かどうかを比較する。
  2. 直接接続も失敗する場合 → 対象サイト側の問題と判断
  3. 直接接続は正常ですが、隔離ブラウザでのみ失敗する場合 →SOFTCAMP お問い合わせ

3.4.2 [ケース B] SHIELD Drive ファイル → 隔離ブラウザサイト (SHIELD Drive ファイルのインポートステップ失敗)​

ユーザーがSHIELD Driveダイアログでファイルを選択して隔離ブラウザサイトにアップロードする際、SHIELD Driveから元のファイルを取得する手順で失敗。

#発生原因担当措置
1SHIELD Driveの認証が期限切れまたはトークンが無効ですユーザーログアウト後再ログイン
2ユーザーにそのファイルへのアクセス権がありません顧客会社管理者ファイル/フォルダーのアクセス権限の付与
3ファイルはSHIELD Driveから既に削除されたか、移動されていますユーザーSHIELD Driveでファイルの存在を確認後、再試行
4SHIELD Drive サービス内部エラーソフトキャンプSOFTCAMP お問い合わせ

3.4.3 [ケース C] SHIELD Drive ファイル → 隔離ブラウザサイト (対象サイトアップロード段階失敗)​

ケースBと同じ流れですが、SHIELD Driveからファイルを正常に取得した後隔離ブラウザで接続したサイトにアップロードする段階で失敗。

#発生原因担当確認方法
1対象サイトサーバーの異常応答対象サイト側ユーザーが対象サイトに直接アクセスして同じ症状か比較
2ネットワークの切断またはCORSエラー顧客会社管理者ネットワーク / ファイアウォールポリシーの確認

3.4.4 [ケース D] 複数ファイルのアップロード (非同期失敗)​

ローカルファイルまたはSHIELD Driveファイルを一度に複数アップロードする際、一部のファイルのアップロード応答処理段階で失敗。

  • 原因・措置基準はケース Aと同じ
  • 特定のファイルだけが繰り返し失敗するのか、全体が一斉に失敗するのかを区別して確認する

3.5 RBI_FILE_DOWNLOAD (ファイルダウンロード)​

🔧 責任区分の概要 — 혼합 (SHIELD Drive 저장은 관리자 영역 비중 큼)
ダウンロードポリシートリガー失敗（ケースA）とSHIELD Driveアップロードネットワーク失敗（ケースB）はSOFTCAMP 処理領域. SHIELD Driveの保存中に応答エラー（ケースC）が発生するのはほとんどの場合顧客管理者のストレージ / 権限 / 拡張子ポリシー設定領域。

隔離ブラウザを通じてファイルダウンロードプロセスで発生するERRORログです。ダウンロード保存場所（ローカルPC / SHIELD Drive）と失敗地点に応じて、以下の3つのケースに分けられます。

3.5.1 [ケース A] ダウンロードポリシートリガーの失敗​

ユーザーが隔離ブラウザサイトでファイルダウンロードボタンをクリックすると、SHIELD Gateバックエンドのダウンロードポリシー処理ステップで失敗。

#発生原因担当
1SHIELD Gate サーバー内部エラー (一時ファイル生成失敗、データストレージエラーなど)ソフトキャンプ
2隔離ブラウザコンテナでファイルを取得する段階のエラーソフトキャンプ
3分類されていない例外ソフトキャンプ

推奨される対策

  1. **[ユーザー]**同じファイルの再ダウンロードを試みる
  2. 他のファイルは正常にダウンロードされるが、特定のファイルだけが繰り返し失敗する場合は、そのファイルの情報とともにSOFTCAMP お問い合わせ

3.5.2 [ケース B] SHIELD Drive ストレージへのダウンロード — ネットワーク / HTTP 例外​

SHIELD Driveを使用する環境で、隔離ブラウザサイトのダウンロードファイルをSHIELD Driveに保管する流れの中SHIELD Drive アップロード API 呼び出し自体が失敗場合。

#発生原因担当
1SHIELD Gate サーバー / 隔離ブラウザコンテナファイル処理エラーソフトキャンプ
2サーバーダウン、タイムアウトなどの一時的なネットワーク例外ソフトキャンプ

推奨される対策

  1. **[ユーザー]**しばらくしてから再試行
  2. 同じタイムゾーンで多数のユーザーが同じ症状を経験している場合 → インフラに関する問題の可能性
  3. 繰り返し発生時SOFTCAMP お問い合わせ

3.5.3 [ケース C] SHIELD Drive ストレージへのダウンロード — 応答ビジネスコード失敗​

ケースBと同じ流れですが**API呼び出しは成功しましたが、SHIELD Drive側の応答が異常です。**の場合。

#発生原因担当措置
1SHIELD Drive ストレージが作成されていません顧客会社管理者SHIELD Drive ストレージの作成
2SHIELD Gateはそのストレージにアクセス権がありません顧客会社管理者ストレージアクセス権限の設定
3ファイル名がSHIELD Driveの命名規則に違反していますユーザーファイル名を変更して再試行してください
4ユーザーストレージ容量超過顧客会社管理者ファイル整理または容量増設
5SHIELD Driveはその拡張子をサポートしていません / ブロックされています顧客会社管理者SHIELD Drive 拡張子ポリシーの確認
6ファイルストレージ連携サービスのアップロード失敗ソフトキャンプSOFTCAMP お問い合わせ
7SHIELD Drive 内部アップロード処理失敗ソフトキャンプSOFTCAMP お問い合わせ
8SHIELD Driveに会社またはユーザー情報がありません顧客会社管理者ユーザー プロビジョニング 状態 確認
9ストレージ情報の取得に失敗しましたソフトキャンプSOFTCAMP お問い合わせ
10SHIELD Drive ストレージ無効状態顧客会社管理者ストレージの有効化
11SHIELD Drive ストレージのアップロード権限がありません顧客会社管理者アップロード権限の付与
12空のファイル（0バイト）のダウンロードを試みましたユーザー元のファイルを確認
13その他の分類されていない例外ソフトキャンプSOFTCAMP お問い合わせ

推奨される対策

  1. 管理者設定系列(1·2·5·8·10·11)はまず設定を確認・補完します。
  2. 設定正常後にも発生した場合SOFTCAMP お問い合わせ

3.6 RBI_USAGE_ERROR (アイソレーションブラウザエラー)​

隔離ブラウザ使用中に発生したシステムエラーをすべて包括するイベントです。errorDetail値によって具体的な原因が区別され、詳細な分類と対応は4章 RBI_USAGE_ERROR 詳細コードガイドを参照してください。

4. RBI_USAGE_ERROR 詳細コード (errorDetail) 対応ガイド​

RBI_USAGE_ERRORイベントと共に記録されるerrorDetailフィールドで具体的な原因を特定します。分類体系は次の8つのグループです。

グループ分類主要な性格1次責任領域
Aコンテナ / セッションの作成・割り当て失敗RBI リソース割り当て段階ユーザー（タブ制限）またはソフトキャンプ
Bセッションの開始 / 検証失敗ユーザーセッションの状態異常ユーザー再入場 → 繰り返し時ソフトキャンプ
Cポリシーの照会 / 判定失敗ポリシーサービス連携ソフトキャンプ(FAILED_NAVIGATED_PAGEは対象サイトを含みます)
Dコンテナ接続状態ランタイム接続切断管理者の措置結果またはソフトキャンプ
Eヘルスチェック失敗隔離ブラウザインスタンス起動状態顧客会社管理者（ファイアウォール/DNS）+ SOFTCAMP
Fブラウザ環境ユーザーPCのChromeバージョンユーザー / 顧客管理者（更新ポリシー）
Gクロームネットワーク層エラー隔離ブラウザ → 外部サイト区間顧客管理者（ネットワーク・セキュリティチェック） / 対象サイト側
Hデフォルト値 (Fallback)分類不能な例外ソフトキャンプ

💡 運用のヒント
Gグループはユーザー数が増えるほど比重が最も大きくなるグループです。ほとんどの顧客のネットワーク・セキュリティ機器の点検で1次解決が可能します。チェックリスト(4.8.2をまず実行した後も解消されないものはSOFTCAMPに問い合わせると対応が早くなります。

4.1 全体errorDetailインデックス​

グループerrorDetail一行要約
AFAILED_CREATING_CONTAINER隔離ブラウザコンテナ生成API呼び出し失敗
AERROR_GET_CONTAINER_URLコンテナURLの取得に失敗しました（分類外の例外の代表コード）
AERROR_GET_CONTAINER_URL_REASSIGNコンテナ URL 再割り当てパス失敗
AMAXIMUM_PODS_REACHED隔離ブラウザクラスターの容量超過
AMAXIMUM_TABS_REACHEDユーザー/テナントの同時オープンタブ制限を超えました
BNO_TAB_ID_SESSIONセッション識別子なしまたはマッピングなし（異常なエントリ）
BMISSING_SESSION_DATAセッションコンテキストなし（期限切れ / 不一致）
BMISSING_CURRENT_URL隔離対象のURLが空です
CPOLICY_QUERY_FAILEDポリシーサーバーの取得に失敗しました
CFAILED_NAVIGATED_PAGE許可されたURLですが、実際のページ移動に失敗しました
DCONTAINER_DISCONNECTED隔離ブラウザコンテナのリアルタイム接続切断
DSESSION_TERMINATED_BY_ADMIN管理者によるセッション強制終了
EHEALTH_CHECK_NETWORK_ERROR隔離ブラウザインスタンスへの到達失敗 (TCP/TLS)
EHEALTH_CHECK_TIMEOUT隔離ブラウザインスタンスのヘルスチェック応答遅延
FBROWSER_VERSION_UPDATE_REQUIREDChromeの最小バージョン未満
GERR_TIMED_OUT全体リクエストタイムアウト
GERR_NETWORK_CHANGEDネットワーク切り替え (Wi-Fi ↔ LAN, VPN再接続)
GERR_CONNECTION_CLOSED接続が切断されました。
GERR_CONNECTION_RESETサーバー/パスデバイスがRSTを送信
GERR_CONNECTION_REFUSED対象ポートはリッスンしていません
GERR_CONNECTION_ABORTED接続異常終了 (クライアントの視点)
GERR_CONNECTION_FAILED一般接続失敗
GERR_NAME_NOT_RESOLVEDDNS照会失敗
GERR_INTERNET_DISCONNECTEDクライアントのインターネット接続がありません
GERR_SSL_PROTOCOL_ERRORTLSハンドシェイクの失敗
GERR_ADDRESS_INVALID不正なIP / ホスト表記
GERR_ADDRESS_UNREACHABLEルーティング上到達不可
GERR_SSL_CLIENT_AUTH_CERT_NEEDEDmTLS クライアント証明書の要求
GERR_TUNNEL_CONNECTION_FAILEDHTTP CONNECT プロキシトンネリングの失敗
GERR_NO_SSL_VERSIONS_ENABLED利用可能なTLSバージョンがありません
GERR_SSL_VERSION_OR_CIPHER_MISMATCHTLSバージョン / 暗号スイート交渉失敗
GERR_CONNECTION_TIMED_OUTTCP接続確立タイムアウト
GERR_PROXY_CONNECTION_FAILED設定されたプロキシ接続に失敗しました
GSSL_CERTIFICATE_ERRORサーバー証明書の有効性エラー
GERR_CERT_AUTHORITY_INVALID発行CAの信頼性がありません
GERR_EMPTY_RESPONSEサーバーが応答なしに接続を終了しました
HUNKNOWN_SYSTEM_ERROR分類不可 / マッピングされていないすべての例外のデフォルト値

4.2 A. コンテナ / セッションの作成・割り当て失敗​

errorDetail原因担当
FAILED_CREATING_CONTAINER隔離ブラウザコンテナ生成API呼び出し自体が失敗。主に内部管理サービスの一時障害、認証の期限切れ、バックエンドの例外。ソフトキャンプ
ERROR_GET_CONTAINER_URLコンテナURL取得ステージの代表的なエラーコード。具体的な原因が別途分類されていないほとんどの例外がこの値に集約される。ソフトキャンプ
ERROR_GET_CONTAINER_URL_REASSIGN既存のコンテナが異常であるため新しいコンテナへの再割り当て試みていたが失敗。ソフトキャンプ
MAXIMUM_PODS_REACHED隔離ブラウザクラスター全体の収容能力上限に達しました。新しいコンテナの割り当てが拒否されました。ソフトキャンプ
MAXIMUM_TABS_REACHEDユーザー（またはテナント）ごとに同時オープンタブの制限超過。新しいタブの作成ステップでブロック。ユーザー

推奨される対策

  • MAXIMUM_TABS_REACHED: ユーザーに使用していないタブを閉じるように案内
  • MAXIMUM_PODS_REACHED: 容量増設協議必要 — SOFTCAMP問い合わせ
  • その他のAグループコード：持続再発時はSOFTCAMPにお問い合わせください

4.3 B. セッションの開始 / 検証失敗​

errorDetail原因
NO_TAB_ID_SESSIONセッション識別子(tabId)がないか、クライアントセッションストレージにマッピングがない異常なエントリー. ブックマーク / 直接リンクを開く、親ウィンドウなしで隔離されたブラウザページを直接開く場合など。
MISSING_SESSION_DATAセッション識別子はあるが、一致するセッションコンテキスト（ユーザー/ポリシー/対象URLなど）がない。セッションの有効期限後の再入場またはサーバー-クライアントの状態不一致。
MISSING_CURRENT_URL隔離ブラウザに移動する対象URLが空です。エントリパスパラメータが欠落しているか、親ウィンドウからのURLの渡しに失敗しました。

推奨される対策

  1. **[ユーザー]**管理者ページ/ユーザーページ正常進入経路で再接続
  2. 正常な経路で繰り返し発生する場合SOFTCAMP お問い合わせ

4.4 C. 政策の照会 / 判定​

errorDetail原因担当
POLICY_QUERY_FAILEDポリシーサーバーの照会APIが失敗しました（ネットワーク / 5xx / パースエラー）。ブロック・許可の判定自体が不可能な状態のため、ページへのアクセスがブロックされています。ソフトキャンプ
FAILED_NAVIGATED_PAGE政策上許可判定されたが、実際のページ移動に失敗。隔離ブラウザ内部のナビゲーション失敗またはリダイレクトループなど。対象サイト側 / SOFTCAMP

推奨される対策

  • POLICY_QUERY_FAILED全ユーザーに同時発生: サービス内部の問題 → 直ちに SOFTCAMP に問い合わせ
  • FAILED_NAVIGATED_PAGE特定のサイトでのみ発生: 該当サイトのリダイレクション/認証構造を確認

4.5 D. コンテナ接続状態 (ランタイム)​

errorDetail原因
CONTAINER_DISCONNECTED使用中の隔離ブラウザコンテナとのリアルタイム接続が切断されました。サーバー側コンテナの終了、ネットワークの切断、keep-aliveの失敗など。
SESSION_TERMINATED_BY_ADMIN管理者は中央管理コンソールで該当ユーザーセッションを強制終了. 再接続は試みず、画面が非アクティブになります。

推奨される対策

  • SESSION_TERMINATED_BY_ADMIN: 正常な期待動作 — 管理者の措置の結果
  • CONTAINER_DISCONNECTED: ユーザー再接続後も繰り返し発生する場合はSOFTCAMPにお問い合わせください

4.6 E. ヘルスチェック失敗​

隔離ブラウザインスタンスの状態確認ステップでの失敗です。一般的なパスではWARNレベルで記録され通過しますが、特定の進入条件ではERRORページに昇格します。

errorDetail原因
HEALTH_CHECK_NETWORK_ERROR隔離ブラウザインスタンスまでTCP / TLSレベル到達失敗。ファイアウォール / ウェブフィルター / ネットワークDLPブロック、DNS失敗、クライアントオフライン、証明書問題の可能性。
HEALTH_CHECK_TIMEOUTインスタンスは生存している可能性がありますが、ヘルスチェックの応答が2秒に達していません。インスタンスの起動遅延、ノードの過負荷、ネットワークのRTTの急増。

推奨される対策

  1. **[顧客会社管理者]**社内ファイアウォール / ウェブフィルター / DNS設定でSHIELD Gateドメインがブロックされていないか確認
  2. **[ユーザー]**VPN / セキュリティエージェント再起動後再試行
  3. 同じタイムゾーンで多数のユーザーに再現される場合、インフラ関連の問題 → SOFTCAMPに問い合わせ

4.7 F. ブラウザ環境​

errorDetail原因
BROWSER_VERSION_UPDATE_REQUIREDユーザーが使用しているChromeのバージョンがサポートされている最小バージョンを下回っています。隔離ブラウザ機能に必要なWebView APIがないため、アップデート要求画面に切り替わります。

推奨される対策

  • ユーザーにChromeの更新通知 (自動更新をブロックするポリシー環境では、管理者が更新を許可する必要があります)

4.8 G. クロームネットワーク層エラー​

隔離ブラウザ → 外部対象ウェブサーバー区間でChromiumが返したエラーコードをそのまま記録した項目です。

この区間のエラーはユーザーPC ↔ SHIELDゲートではなく隔離ブラウザクラスター ↔ 対象サイト区間で発生します。点検は隔離ブラウザ側のegressネットワークと対象サイト側のingressポリシーを優先します。

4.8.1 エラーコードマッピング​

Chrome codeerrorDetail主な原因
-7ERR_TIMED_OUT全体リクエストタイムアウト。遅いサーバー / パス。
-21ERR_NETWORK_CHANGEDネットワーク切り替え (Wi-Fi↔LAN, VPN再接続)。
-100ERR_CONNECTION_CLOSEDサーバーがデータの送受信中に接続が終了しました。
-101ERR_CONNECTION_RESETサーバー / 中間機器のRST送信。L4機器・プロキシで強制切断。
-102ERR_CONNECTION_REFUSED対象ポートがリッスンしていません。サービスがダウンしているか、ポートのタイプミスです。
-103ERR_CONNECTION_ABORTED異常な接続終了 (クライアントの観点)。
-104ERR_CONNECTION_FAILED一般接続失敗。詳細分類不可能なL4問題。
-105ERR_NAME_NOT_RESOLVEDDNSの照会に失敗しました。ドメインが存在しないか、DNSサーバーに問題があります。
-106ERR_INTERNET_DISCONNECTEDクライアントのインターネット接続がありません。
-107ERR_SSL_PROTOCOL_ERRORTLSハンドシェイクに失敗しました。
-108ERR_ADDRESS_INVALID無効なIP/ホスト表記。
-109ERR_ADDRESS_UNREACHABLEルーティング上、目的地に到達できません。
-110ERR_SSL_CLIENT_AUTH_CERT_NEEDEDサーバーがクライアント証明書を要求する (mTLS)。
-111ERR_TUNNEL_CONNECTION_FAILEDHTTP CONNECT プロキシトンネリングに失敗しました。
-112ERR_NO_SSL_VERSIONS_ENABLED利用可能なTLSバージョンがありません。
-113ERR_SSL_VERSION_OR_CIPHER_MISMATCHTLSバージョン / 暗号スイート交渉失敗。
-118ERR_CONNECTION_TIMED_OUTTCP接続確立タイムアウト。ファイアウォールのドロップ、ルーティング失敗の疑い。
-130ERR_PROXY_CONNECTION_FAILED設定されたプロキシ接続に失敗しました。
-200SSL_CERTIFICATE_ERRORサーバー証明書の有効性エラー (包括)。
-202ERR_CERT_AUTHORITY_INVALID発行CAの信頼性がありません。プライベートCAがインストールされていないなど。
-324ERR_EMPTY_RESPONSEサーバーが何の応答も返さずに接続を終了しました。

4.8.2 顧客管理者チェックリスト​

以下のエラーは隔離ブラウザクラスター → 対象ウェブサーバーの間の隔離環境のエグレス区間で発生します。ユーザーPC → SHIELD Gate区間ではなく、隔離ブラウザクラスター側のネットワーク/ポリシーを優先的に確認してください。

① DNS 解決失敗 (ERR_NAME_NOT_RESOLVED)​

  • 隔離ブラウザクラスターに設定されたDNSサーバー（社内 / 外部）の応答正常性確認

  • 対象ドメインが社内DNSにのみ存在する場合、隔離ブラウザクラスターでも同じDNSを参照しているか確認してください。

  • 顧客環境のドメインブロックポリシー（DNSシンクホール、カテゴリブロック）に引っかかっていないか確認する

  • 特定のドメインだけが失敗するのか、全体のドメインが失敗するのかを隔離ブラウザ内の他のサイトで比較テスト

② ネットワークタイムアウト / 到達失敗 (ERR_TIMED_OUT, ERR_CONNECTION_TIMED_OUT, ERR_CONNECTION_FAILED, ERR_ADDRESS_UNREACHABLE)​

隔離ブラウザ側 (Outbound)

  • 隔離ブラウザクラスタが位置するネットワークで対象サーバーのIP/ポートへoutbound ファイアウォールの許可確認 여부

  • クラスターエグレス区間のNAT GW / プロキシ / SD-WANルーティングの正常性確認

  • 隔離ブラウザノードのCPU / メモリ / ネットワークRTT指標確認（過負荷による処理遅延の可能性）

対象サイト側 (Inbound)

  • 対象サイトのインバウンドファイアウォール / セキュリティグループ隔離ブラウザクラスタのegress IPがブロックされていないか確認してください

  • 対象サイトがIPホワイトリストポリシーを運用中の場合、隔離ブラウザクラスターのエグレスIPが登録されているか確認してください。

  • GeoIP / 国別ブロックポリシーに隔離ブラウザクラスターリージョンがかかっていないか確認する（海外リージョン使用時に頻繁）

  • クラウドWAF（Cloudflare / Akamaiなど）IP評判 / ボットブロックポリシーにegress IPが設定されていないか確認する（多数のユーザートラフィックが単一のIPに集中し、評判が低下する可能性がある）

  • 対象サーバーの同時接続数 / Rate-Limitの閾値に達したか確認

比較テスト

  • ユーザーPCで同じサイトが直接接続できるか比較 → 直接接続も失敗した場合、対象サーバー / インターネット回線の問題

  • **別の隔離ブラウザノード（別のegress IP）**同一サイト接続比較 → 特定IPブロックの有無識別

③ 接続拒否 / 強制終了 (ERR_CONNECTION_CLOSED, ERR_CONNECTION_RESET, ERR_CONNECTION_REFUSED, ERR_CONNECTION_ABORTED)​

  • 対象のウェブサーバー / サービス自体が正常に稼働しているか確認する (ERR_CONNECTION_REFUSEDは通常サービスダウン)

  • 経路上の L4 / WAF / IPS 機器が隔離ブラウザの egress トラフィックを**自動遮断 (RST送出)**していないか確認

  • 対象サイトで短時間に大量のリクエストによるレート制限ブロック確認 (複数ユーザー → 単一出発地に見える)

  • クライアント User-Agent / TLS フィンガープリンティングに基づくブロック（ボット検出）ポリシーの確認

④ インターネット接続 / ネットワーク切り替え (ERR_INTERNET_DISCONNECTED, ERR_NETWORK_CHANGED)​

  • 隔離ブラウザクラスタのインターネット回線 / NAT GW / egress IPの正常性確認

  • 同じタイムゾーンの他のユーザーにも同じエラーが発生しているか確認する（全体に影響がある場合はインフラの問題）。

  • ERR_NETWORK_CHANGEDクライアントPC側のネットワーク切り替えでも発生する可能性があります → ユーザー回線（VPN再接続、Wi-Fi ↔ LANスイッチング）を同時に確認

⑤ TLS / SSL ネゴシエーション失敗 (ERR_SSL_PROTOCOL_ERROR, ERR_NO_SSL_VERSIONS_ENABLED, ERR_SSL_VERSION_OR_CIPHER_MISMATCH)​

  • 対象サイトが要求するTLS 最小バージョン(例: TLS 1.2 / 1.3) が隔離ブラウザポリシーと互換性があるか確認

  • 古いバージョンのサイト（TLS 1.0 / 1.1のみサポート）への接続時のセキュリティポリシーに基づく許可の可否の検討

  • パス上のSSLインターセプト（SSL Inspection）デバイスが交渉失敗を引き起こさないことを確認する

⑥ サーバー証明書エラー (SSL_CERTIFICATE_ERROR, ERR_CERT_AUTHORITY_INVALID)​

  • 対象サイトの証明書の期限切れ / ドメイン不一致 / 自己署名確認 여부

  • 社内の独自CAで発行されたサイトであればSHIELD GateにプライベートCA証明書を登録する状態確認

⑦ クライアント証明書の要求 (ERR_SSL_CLIENT_AUTH_CERT_NEEDED)​

  • 対象サイトが**mTLS(相互認証書)**を要求するか確認

  • 隔離ブラウザ環境のクライアント証明書インジェクション（ノードマウント / ポリシー配布）構成の検討

  • mTLSサイトの場合、隔離ブラウザの使用自体がポリシー上不適切である可能性があります → 例外処理（直接接続の許可）を検討

⑧ プロキシ / トンネリング失敗 (ERR_TUNNEL_CONNECTION_FAILED, ERR_PROXY_CONNECTION_FAILED)​

  • 隔離ブラウザクラスターに設定された**アウトバウンドプロキシ (PAC / 明示的プロキシ)**正常動作の確認

  • プロキシ認証情報（アカウント / トークン）の有効期限確認

  • 対象サイトがHTTPS CONNECTトンネリングをブロックしていないか確認してください。

⑨ 誤った住所表記 (ERR_ADDRESS_INVALID)​

  • ユーザーが入力したURLの形式エラーの有無（ポート番号、特殊文字）

  • 隔離ブラウザのエントリーパラメータのエンコーディング / デコーディングプロセスの損傷の有無

⑩ 空の応答 (ERR_EMPTY_RESPONSE)​
  • 対象サーバーがリクエスト受信直後に応答なしで接続を切断する状態 → ネットワークまたは対象サイトの問題を確認する必要があります。
共通チェック​

  • 同じエラーが特定のサイトにのみ発生 → サイト（またはサイトポリシー）問題に絞られる

  • 同じエラーが複数のサイトに同時発生→ 隔離ブラウザインフラ / egress回線の問題

  • 同じエラーが特定のユーザーにのみ発生 → 該当ユーザーのポリシー / グループ / ルーティングポリシーの確認

  • 発生時刻の隔離ブラウザノード状態（ヘルスチェック、コンテナ再起動イベント）を確認する

4.9 H. デフォルト値 (Fallback)​

errorDetail原因
UNKNOWN_SYSTEM_ERRORA~Gのいずれの分類にも該当しない例外の基本値。原因特定ができていないすべてのケース。

実質的にこの値に帰結する追加ケース:

  1. ヘルスチェックがHTTP / 分類不能エラーを返した場合
  2. Chromium エラーコードマッピングにないコードが渡された場合
  3. セッションエラー処理ロジックの基本分岐

推奨される対策

  • 該当コードが頻繁に集計される場合、分類拡張が必要な信号であるため、発生時刻・ユーザー・対象URLを収集してSOFTCAMPに伝達。

5. 付録​

5.1 ERRORレベルが発生しないイベント​

次のイベントは設計上INFOレベルのみで記録されますERRORは残りません。

NAVIGATE_TO_ADMIN_PAGE          관리자 페이지로 이동
POST_INQUIRY_WORK_ITEM_ACCESS_URL  브라우저 접속
RBI_URL_CHANGED                 브라우저 접속 후 이동
RBI_CHECK_INPUT_TEXT            사용자 입력 민감정보 검사
RBI_CLIPBOARD_ACCESS_RB2PC      격리 브라우저 → 로컬 PC 복사
RBI_CLIPBOARD_ACCESS_PC2RB      로컬 PC → 격리 브라우저 붙여넣기
RBI_SESSION_TIMEOUT             격리 브라우저 세션 타임아웃
RBI_KEYBOARD_INPUT              키보드 입력 차단
RBI_FILE_VIEWER_REQUEST         SHIELD Viewer 요청

5.2 SOFTCAMPへの問い合わせ時に伝える情報​

問題解決にかかる時間を短縮するために、SOFTCAMPに問い合わせる際は以下の項目を一緒に伝えてください。

#項目備考
1発生時刻 (YYYY-MM-DD HH:MM:SS, タイムゾーンを含む)正確な時間範囲は必須
2会社識別子 / テナント名—
3影響を受けたユーザーID（またはメール）単一ユーザー / 複数ユーザーの有無も含めて
4イベントコード例:RBI_USAGE_ERROR
5errorDetail値RBI_USAGE_ERRORの場合は必須
6対象URL（該当する場合）隔離ブラウザでアクセスしていたサイトのアドレス
7再現の有無 / 再現ステップ再現される場合の段階的記録
8ユーザーのブラウザ / OS バージョンブラウザ環境の問題 (Fグループ) 区分用
9同じタイムゾーンの他のユーザーにも発生するかどうかインフラ関連の問題判断資料
10直前の管理者設定変更の有無ポリシー / ストレージ / ファイアウォール変更履歴