ユーザーログエラー対応ガイド
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 内部データストレージ一時障害 SOFTCAMP 2 認証サービス連携エラー SOFTCAMP 3.1.2 推奨措置
- **[ユーザー]**再ログイン後、同じ作業を再試行してください。
- **[顧客会社管理者]**同じタイムゾーンの他のユーザーにも同じエラーが発生したか確認する(インフラ系の問題判断)
- 同じ症状が続く場合はSOFTCAMP お問い合わせ
3.2 POST_FAVORITE_ITEM / DELETE_FAVORITE_ITEM (お気に入り登録 / 削除)
🔧 責任区分の要約 —
소프트캠프 영역
このイベントのERRORはサービス内部データストレージの問題によってのみ発生します。顧客側の措置項目なしでSOFTCAMPへの問い合わせ対象です。
項目 内容 イベント POST_FAVORITE_ITEM— お気に入り登録DELETE_FAVORITE_ITEM— お気に入り削除一般的な性格 サービス内部データストレージの問題で主に発生。 3.2.1 発生可能原因
# 原因 担当 1 内部データストレージ接続エラー SOFTCAMP 2 その他のサービス内部例外 SOFTCAMP 3.2.2 推奨措置
- **[ユーザー]**しばらくして再試行
- 繰り返し発生時SOFTCAMP お問い合わせ
3.3 GET_EXTERNAL_INTERFACE_ACCESS_URL (トップバー外部リンク接続)
🔧 責任区分の要約 —
고객사 관리자 1차 점검
1次で顧客管理者の上部バー外部リンク設定を確認。設定が正常にもかかわらず発生する場合は、SOFTCAMPに問い合わせてください。
項目 内容 イベント 管理者がユーザーページの上部バーに設定したカスタムボタンをユーザーがクリックして外部URLにアクセスする動作 3.3.1 発生可能原因
# 原因 担当 備考 1 上部バーの外部リンクが設定されていない状態で呼び出し 顧客会社管理者 管理者ページのUIで事前にブロックされるため、通常は発生しません。 2 内部データストレージの取得エラー SOFTCAMP — 3.3.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エラーページなど) 対象サイト側 対象サイト側の問題の可能性が高い 推奨措置
- ユーザーPCから対象サイトに直接アクセスし、同じファイルのアップロードが正常かどうかを比較
- 直接接続も失敗する場合 → 対象サイト側の問題と判断
- 直接接続は正常ですが、隔離ブラウザでのみ失敗する場合 →SOFTCAMP お問い合わせ
3.4.2 [ケース B] SHIELD Drive ファイル → 隔離ブラウザサイト (SHIELD Drive ファイルのインポートステップ失敗)
ユーザーが SHIELD Drive ダイアログでファイルを選択して隔離ブラウザサイトにアップロードする時、SHIELD Driveで元のファイルを取得するステップ