IBM QRadar SOAR Plug-in アプリケーションのトラブルシューティング
以下の情報は、 IBM® QRadar® SOAR プラグイン ・アプリケーションの一般的な問題を識別して解決するのに役立ちます。
構成ファイルとログ・ファイルをローカル・コンピューターにダウンロードすることもできます。 詳しくは、「 ログ・ファイルおよび構成ファイルのダウンロード」を参照してください。
自動エスカレーションが予期したとおりに機能しない
QRadar オフェンスが自動的に SOARにエスカレートされることはありません。
app.log ファイルと circuits.log ファイルには、認証の問題を示す以下のようなメッセージが表示されます。
ユーザー < API KEY> は、 < resource> へのアクセスを許可されていません
| 問題 | 解決方法 (Solution) |
|---|---|
API キーがロックされているか、有効期限が切れています。 |
この問題を解決するには、 SOAR にログインし、API キー・シークレットを再生成するか、新しいキーを作成します。 詳しくは、技術情報「 An app using an API key cannot connect to IBM Security QRadar SOAR 」を参照してください。 |
IP アドレスは SOARでは禁止されています。 |
この問題の解決方法について詳しくは、技術情報「 How to solve the integration app failure with expired API key 」を参照してください。 |
MSSP の API キーが SOAR 子組織にプッシュされませんでした。 |
この問題を解決するには、以下の手順を実行します。
|
- QRadar コンソール に管理者としてログインします。
- 「管理」 タブの 「IBM QRadar SOAR プラグイン」 セクションで、 「構成」をクリックします。
- 「状況」 タブで、 「接続のテスト」をクリックします。
- テストが完了するまで数秒待ってから、 「状況の最新表示」をクリックします。
アプリケーション構成を検証しようとすると内部サーバー・エラーが表示される
QRadar SOAR プラグイン ・アプリケーションを構成したが、 「検証と構成」をクリックすると、アプリケーションが失敗して表示されるInternal Server Error.
この問題は、 getcert.sh スクリプトを QRadarで実行できないために発生します。
この問題を解決するには、CA 証明書を QRadar コンソールにコピーします。 詳しくは、 インバウンド宛先へのアクセスの構成を参照してください。
QRadar コンソール にタイムアウト・エラーが表示される
エラー: escalateURL への呼び出しがタイムアウトになりました
この問題は、 SOAR API 呼び出しの完了に QRadar コンソール のタイムアウト期間よりも長い時間がかかる場合に発生する可能性があります。
SOAR でケースが見つかりません
エラー: ID xxxxx のオブジェクトが見つかりません
QRadar SOAR プラグイン ・アプリケーションで構成されているものと同じ SOAR 組織にログインしていることを確認します。
- QRadar コンソール に管理者としてログインします。
- 「管理」 タブの 「IBM QRadar SOAR プラグイン」 セクションで、 「構成」をクリックします。
組織は、 「アクセス」 タブの 「組織名」 フィールドで確認できます。
ドメインをスクリプト化できないことを示すエラー・メッセージ
以下のエラー・メッセージを含むウィンドウが表示されます。'QRadarDomain' object is not scriptable.
この問題を解決するには、 QRadar ドメインと SOAR 子組織を再マップします。 詳しくは、 QRadar SOAR プラグイン・アプリケーションの構成を参照してください。
エアギャップ環境でのインストールの問題
エアギャップ環境でのインストールおよびアップグレードの問題は、構成の問題が原因である可能性があります。
アップグレード後に、必要なすべての構成情報を必ず指定してください。 詳しくは、 構成を参照してください。
警告: 接続後に再試行中 (再試行 (total=4, connect = None, read = None, redirect = None, status = None)) 'ConnectTimeoutError(<pip._vendor.urllib3.connection.HTTPSConnectionオブジェクト at0x7f624e6a3080>ています、 ' pypi.org への接続がタイムアウトになりました。 (connect timeout=15) ')': /simple/argparse/
QRadar SOAR プラグイン の接続状況が 「競合」 である
「SOAR 接続状況」 には、 IBM QRadarからの SOAR インバウンド宛先の最後の接続テストの状況が表示されます。
接続が 「競合」 状況を示している場合は、インバウンド宛先へのアクセスが正しく構成されていることを確認してください。 詳しくは、 インバウンド宛先へのアクセスの構成を参照してください。
- IBM QRadar SOAR プラグイン 構成で、 「状況」 タブをクリックします。
- をクリックします。
- 「アクセス」 タブで、 「保存」をクリックします。
アプリは古いインバウンド・メッセージ・キューのモニターを続行します
IBMSecurity SOARPlatformまたはSOAR forIBM Cloud Pak® for Securityの新しいインスタンスに接続するためにQRadar SOARPlug-inアプリを再設定した後、アプリは以前の構成から受信メッセージキューからのメッセージを処理し続けます。
- 「管理」 タブの 「IBM QRadar SOAR プラグイン」 セクションで、 「構成」をクリックします。
- 「状況」 タブで 「アクション」をクリックし、 「接続の削除」をクリックします。
- 「アクセス (Access)」 タブで、 「検証と構成 (Verify and configure)」をクリックし、 「保存」をクリックします。
構成の検証中に正しくないゲートウェイ・エラーが発生しました
以下を受け取ったとします。Bad Gatewayアプリケーション構成の検証時にエラーが発生しました。SOAR API キーが最新であることを確認してください。
SOAR forIBM Cloud Pak for Securityのインスタンスにアプリを接続している場合は、API Key がまだ有効で、正しい組織へのパーミッションが許可されていることを確認します。 新しい API キーを作成し、構成変更をプッシュすることが必要になる場合があります。
APIキーの権限についての詳細は、 最小システム要件を参照してください。
パフォーマンスはほぼリアルタイムではありません
新しいオフェンスの作成に遅延が発生する可能性があります。
- QRadar と SOARの間のネットワークが切断されます。
- QRadar または SOARのいずれかにおけるハイパフォーマンス要求。
- 同時に処理されるメッセージのバーストが大きくなります。
この状態が続く場合は、サポート・チケットをオープンして、 IBM サポート・アナリストにご使用の環境を確認してもらいます。
QRadar SOARPlug-inアプリのインストール後に作成されたドメインで、オフェンスの自動エスカレーションが機能しない
QRadar SOARPlug-inアプリをインストールした後、QRadarで新しいドメインが作成されるたびに、管理者はアプリの接続をリセットする必要があります。 これにより、新しく作成されたドメインで自動オフェンス・エスカレーションが機能するようになります。
- 「管理」 タブの 「IBM QRadar SOAR プラグイン」 セクションで、 「構成」をクリックします。
- 「状況」 タブで 「アクション」をクリックし、 「接続の削除」をクリックします。
- 「アクセス (Access)」 タブで、 「検証と構成 (Verify and configure)」をクリックし、 「保存」をクリックします。
- Mappings]タブで[Verify and configure]をクリックし、[Save]をクリックする。
- Configuration Push をクリックします。