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

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

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キーボード入力のブロック❌—
RBI_PRINTプリント出力❌—
パーソナライズ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 POSTSIGNOUT, POSTRELAYTOKEN (ログアウト, サービス移動)​

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

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

3.1.1 発生可能原因​

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

3.1.2 推奨措置​

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

3.2 POSTFAVORITEITEM, DELETEFAVORITEITEM (お気に入りの登録、削除)​

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

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

3.2.1 発生可能な原因​

#原因担当
1内部データストレージ接続エラーSOFTCAMP
2その他のサービス内部例外SOFTCAMP

3.2.2 推奨措置​

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

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

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

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

3.3.1 発生可能な原因​

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

3.3.2 推奨措置​

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

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

🔧 責任区分の要約 — 외부 사이트 / 사용자 환경 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 サービス内部エラーSOFTCAMPSOFTCAMP お問い合わせ

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

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

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

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

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

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

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

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

隔離ブラウザを通じたファイルダウンロード過程で発生するERRORログです。ダウンロード保存位置(ローカルPC / SHIELD Drive)と失敗地点に応じて、以下の3つのケースに分けます。

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

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

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

推奨措置

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

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

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

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

推奨措置

  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ファイルストレージ連携サービスのアップロード失敗SOFTCAMPSOFTCAMP お問い合わせ
7SHIELD Drive 内部アップロード処理失敗SOFTCAMPSOFTCAMP お問い合わせ
8SHIELD Driveに会社またはユーザー情報がありません顧客会社管理者ユーザー プロビジョニング 状態 確認
9ストレージ情報の取得に失敗しましたSOFTCAMPSOFTCAMP お問い合わせ
10SHIELD Drive ストレージ無効状態顧客会社管理者ストレージの有効化
11SHIELD Drive ストレージ アップロード権限なし顧客会社管理者アップロード権限付与
12空のファイル(0バイト)ダウンロードの試行ユーザー元のファイルを確認
13その他の分類されていない例外SOFTCAMPSOFTCAMP お問い合わせ

推奨措置

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

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

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


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

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

グループ分類主要な性格1次責任領域
Aコンテナ / セッションの作成・割り当てに失敗しましたRBI リソース割り当て段階ユーザー(画面数制限) / 顧客管理者(割り当て拒否)またはSOFTCAMP
Bセッション進入 / 検証失敗ユーザーセッション状態異常ユーザー再入場 → 繰り返し時SOFTCAMP
Cポリシー照会 / 判定失敗ポリシーサービス連携SOFTCAMP(FAILED_NAVIGATED_PAGEは対象サイトを含み、MFA_REQUIREDはユーザー追加認証です)
Dコンテナ接続状態ランタイム接続切断SOFTCAMP
Fブラウザ環境ユーザーPCのChromeバージョンユーザー / 顧客管理者(アップデートポリシー)
Gクロム ネットワーク レイヤー エラー隔離ブラウザ → 外部サイト区間顧客管理者(ネットワーク・セキュリティチェック) / 対象サイト側
Hデフォルト値 (Fallback)分類不可の例外SOFTCAMP

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

4.1 全体errorDetailインデックス​

グループerrorDetail一行の要約
AFAILED_CREATING_CONTAINER隔離ブラウザコンテナ生成API呼び出し失敗
AERROR_GET_CONTAINER_URLコンテナURL取得失敗(分類外例外の代表コード)
AMAXIMUM_PODS_REACHED隔離ブラウザクラスターの収容能力を超えました
AMAXIMUM_TABS_REACHEDユーザー/テナント同時オープンタブ制限超過
ASESSION_CLOSED_FOR_NEW_SCREEN最大同時画面数到達ウィンドウでこの画面を閉じます
AREMOTE_BROWSER_NOT_ENABLED隔離ブラウザの割り当て拒否(機能未使用または設定エラー)
AREMOTE_BROWSER_FORBIDDEN隔離ブラウザの割り当て拒否 (アクセス権限なし)
AREMOTE_BROWSER_SERVICE_ERROR隔離ブラウザサービス一時エラーによる割り当て失敗
BNO_TAB_ID_SESSIONセッション識別子なしまたはマッピングなし(異常なエントリ)
BMISSING_SESSION_DATAセッションコンテキストがありません(期限切れ / 不一致)
BMISSING_CURRENT_URL隔離対象URLが空です
CPOLICY_QUERY_FAILEDポリシーサーバーの取得に失敗しました
CFAILED_NAVIGATED_PAGE許可されたURLですが、実際のページ移動に失敗しました
CMFA_REQUIRED接続に追加認証が必要です
DCONTAINER_DISCONNECTED隔離ブラウザコンテナのリアルタイム接続切断
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呼び出し自体が失敗。主に内部管理サービスの一時障害、認証の期限切れ、バックエンドの例外。SOFTCAMP
ERROR_GET_CONTAINER_URLコンテナURL取得ステップの代表的なエラーコード。具体的な原因が別途分類されていないほとんどの例外がこの値に集約される。SOFTCAMP
MAXIMUM_PODS_REACHED隔離ブラウザクラスター全体の収容能力上限に達しました。新しいコンテナの割り当てが拒否されました。SOFTCAMP
MAXIMUM_TABS_REACHEDユーザー(またはテナント)ごとに同時オープンタブの制限超過。新しいタブ作成ステップでブロック。ユーザー
SESSION_CLOSED_FOR_NEW_SCREEN「最大同時画面数到達」ウィンドウでユーザーがこの画面を閉じて新しい画面を開く。ユーザーの選択に応じた終了。ユーザー
REMOTE_BROWSER_NOT_ENABLED隔離ブラウザ割り当て要求拒否 (400 C4001)。隔離ブラウザ機能が有効になっていないか、サービスアドレス設定が正しくありません。顧客会社管理者 / SOFTCAMP
REMOTE_BROWSER_FORBIDDEN隔離ブラウザ割り当てリクエスト拒否 (403 C4005)。隔離ブラウザにアクセスする権限がありません。顧客会社管理者
REMOTE_BROWSER_SERVICE_ERROR隔離ブラウザサービス一時エラーによる割り当て失敗 (500 C5011)。SOFTCAMP

推奨措置

  • MAXIMUM_TABS_REACHED: ユーザーに使用していないタブを閉じるように案内
  • MAXIMUM_PODS_REACHED: 容量増設協議必要 — SOFTCAMPお問い合わせ
  • SESSION_CLOSED_FOR_NEW_SCREEN: 別途措置不要
  • REMOTE_BROWSER_NOT_ENABLED, REMOTE_BROWSER_FORBIDDEN: 再試行しても解決しません。隔離ブラウザの使用設定とユーザー権限を確認後、継続する場合は SOFTCAMP にお問い合わせください。
  • REMOTE_BROWSER_SERVICE_ERROR: 少々お待ちください、再試行、繰り返す場合は 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 / パースエラー)。ブロック・許可の判定自体が不可能な状態のため、ページへのアクセスがブロックされています。SOFTCAMP
FAILED_NAVIGATED_PAGE政策上許可で判定されましたが、実際のページ移動に失敗しました。隔離ブラウザ内部ナビゲーションの失敗またはリダイレクトループなど。対象サイト側 / SOFTCAMP
MFA_REQUIRED接続しようとしているページには追加の認証が必要です。「追加認証が必要」画面に切り替わります。ユーザー

推奨措置

  • POLICY_QUERY_FAILED全ユーザーに同時発生: サービス内部の問題 → 直ちに SOFTCAMP に問い合わせ
  • FAILED_NAVIGATED_PAGE特定のサイトでのみ発生: 該当サイトのリダイレクション/認証構造を確認
  • MFA_REQUIRED: 画面の**[追加認証]**を押して認証完了

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

errorDetail原因
CONTAINER_DISCONNECTED使用中の隔離ブラウザコンテナとのリアルタイム接続が切断されました。サーバー側コンテナの終了、ネットワークの切断、keep-aliveの失敗など。

💡 管理者が接続セッションを強制終了した場合はユーザーエラーログ(RBI_USAGE_ERROR)に記録されません。強制終了履歴は管理者ログRBI_SESSION_FORCE_TERMINATE(接続セッション強制終了)で確認します。

推奨措置

  • CONTAINER_DISCONNECTED: ユーザー再接続後も繰り返し発生する場合は SOFTCAMP にお問い合わせください

4.6 F. ブラウザ環境​

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

推奨措置

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

4.7 G. クロム ネットワーク レイヤー エラー​

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

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

4.7.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.7.2 顧客管理者チェックリスト​

以下のエラーは隔離ブラウザクラスター → 対象ウェブサーバーの間の隔離環境 egress 区間で発生します。ユーザー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/ポートへのアウトバウンドファイアウォール許可の有無を確認
  • クラスター egress 区間の NAT GW / プロキシ / SD-WAN ルーティングの正常性確認
  • 隔離ブラウザノードのCPU / メモリ / ネットワークRTT指標確認(過負荷による処理遅延の可能性)

対象サイト側 (Inbound)

  • 対象サイトの inbound ファイアウォール / セキュリティグループ で隔離ブラウザクラスター egress IP がブロックされていないか確認
  • 対象サイトがIPホワイトリストポリシーを運用中の場合、隔離ブラウザクラスターのegress 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 送出) していないか確認
  • 対象サイトで短時間に大量リクエストによるRate-Limitブロックの有無を確認(多数のユーザー → 単一の出発地に見える)
  • クライアント 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.8 H. デフォルト値 (Fallback)​

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

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

  1. Chromium エラーコードマッピングにないコードが渡された場合
  2. セッションエラー処理ロジックの基本分岐

推奨措置

  • 該当コードが頻繁に集計される場合、分類拡張が必要な信号であるため、発生時刻・ユーザー・対象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_PRINT プリント出力
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直前の管理者設定変更の有無ポリシー / ストレージ / ファイアウォール変更履歴