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 子組織にプッシュされませんでした。

この問題を解決するには、以下の手順を実行します。
  1. SOARにログインします。
  2. 構成組織で、 「管理者設定」 > 「ユーザー」 タブに移動します。
  3. QRadar SOAR プラグイン ・アプリケーションの API キーが子組織に割り当てられていることを確認します。
  4. 管理者設定 > 「構成のプッシュ」 メニューに移動し、 「構成のプッシュ」をクリックします。
システム状況を確認するには、以下の手順を実行します。
  1. QRadar コンソール に管理者としてログインします。
  2. 「管理」 タブの 「IBM QRadar SOAR プラグイン」 セクションで、 「構成」をクリックします。
  3. 「状況」 タブで、 「接続のテスト」をクリックします。
  4. テストが完了するまで数秒待ってから、 「状況の最新表示」をクリックします。

アプリケーション構成を検証しようとすると内部サーバー・エラーが表示される

QRadar SOAR プラグイン ・アプリケーションを構成したが、 「検証と構成」をクリックすると、アプリケーションが失敗して表示されるInternal Server Error.

この問題は、 getcert.sh スクリプトを QRadarで実行できないために発生します。

この問題を解決するには、CA 証明書を QRadar コンソールにコピーします。 詳しくは、 インバウンド宛先へのアクセスの構成を参照してください。

QRadar コンソール にタイムアウト・エラーが表示される

以下のメッセージが QRadar 「コンソール」 ブラウザー・ウィンドウに表示されます。
エラー: escalateURL への呼び出しがタイムアウトになりました

この問題は、 SOAR API 呼び出しの完了に QRadar コンソール のタイムアウト期間よりも長い時間がかかる場合に発生する可能性があります。

この問題を解決するには、 SOAR タイムアウト値をデフォルト値の 30 秒より大きくします。 この値を大きくすると、 SOAR API 呼び出しが完了するまでの時間が長くなります。
注: 場合によっては、API 呼び出しが正常に完了しても、このメッセージが QRadar インターフェースに表示されることがあります。 QRadar インターフェースのタイムアウト値は変更できません。

SOAR でケースが見つかりません

QRadar SOAR プラグイン ・アプリケーションはケースを作成しますが、 SOARでケースを表示しようとすると、以下のエラー・メッセージが表示されます。
エラー: ID xxxxx のオブジェクトが見つかりません

QRadar SOAR プラグイン ・アプリケーションで構成されているものと同じ SOAR 組織にログインしていることを確認します。

アプリで構成されている組織を表示するには、以下の手順を実行します。
  1. QRadar コンソール に管理者としてログインします。
  2. 「管理」 タブの 「IBM QRadar SOAR プラグイン」 セクションで、 「構成」をクリックします。

    組織は、 「アクセス」 タブの 「組織名」 フィールドで確認できます。

ドメインをスクリプト化できないことを示すエラー・メッセージ

以下のエラー・メッセージを含むウィンドウが表示されます。'QRadarDomain' object is not scriptable.

この問題を解決するには、 QRadar ドメインと SOAR 子組織を再マップします。 詳しくは、 QRadar SOAR プラグイン・アプリケーションの構成を参照してください。

エアギャップ環境でのインストールの問題

エアギャップ環境でのインストールおよびアップグレードの問題は、構成の問題が原因である可能性があります。

アップグレード後に、必要なすべての構成情報を必ず指定してください。 詳しくは、 構成を参照してください。

Docker コンテナー・ログにこのメッセージが含まれている場合は、アプリケーション・コンテナーが最終的にビルドされるため、このメッセージを無視できます。
警告: 接続後に再試行中 (再試行 (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 インバウンド宛先の最後の接続テストの状況が表示されます。

接続が 「競合」 状況を示している場合は、インバウンド宛先へのアクセスが正しく構成されていることを確認してください。 詳しくは、 インバウンド宛先へのアクセスの構成を参照してください。

インバウンド宛先を構成した後、以下の手順に従ってインバウンド宛先への接続を再確立します。
  1. IBM QRadar SOAR プラグイン 構成で、 「状況」 タブをクリックします。
  2. 「アクション」 > 「接続の削除」をクリックします。
  3. 「アクセス」 タブで、 「保存」をクリックします。

アプリは古いインバウンド・メッセージ・キューのモニターを続行します

IBMSecurity SOARPlatformまたはSOAR forIBM Cloud Pak® for Securityの新しいインスタンスに接続するためにQRadar SOARPlug-inアプリを再設定した後、アプリは以前の構成から受信メッセージキューからのメッセージを処理し続けます。

この問題を解決するには、以下のステップに従って、古いメッセージ・キュー構成をクリアします。
  1. 「管理」 タブの 「IBM QRadar SOAR プラグイン」 セクションで、 「構成」をクリックします。
  2. 「状況」 タブで 「アクション」をクリックし、 「接続の削除」をクリックします。
  3. 「アクセス (Access)」 タブで、 「検証と構成 (Verify and configure)」をクリックし、 「保存」をクリックします。

構成の検証中に正しくないゲートウェイ・エラーが発生しました

以下を受け取ったとします。Bad Gatewayアプリケーション構成の検証時にエラーが発生しました。SOAR API キーが最新であることを確認してください。

SOAR forIBM Cloud Pak for Securityのインスタンスにアプリを接続している場合は、API Key がまだ有効で、正しい組織へのパーミッションが許可されていることを確認します。 新しい API キーを作成し、構成変更をプッシュすることが必要になる場合があります。

APIキーの権限についての詳細は、 最小システム要件を参照してください。

パフォーマンスはほぼリアルタイムではありません

新しいオフェンスの作成に遅延が発生する可能性があります。

遅延の原因となる可能性のある要因がいくつかあります。
  • QRadarSOARの間のネットワークが切断されます。
  • QRadar または SOARのいずれかにおけるハイパフォーマンス要求。
  • 同時に処理されるメッセージのバーストが大きくなります。

この状態が続く場合は、サポート・チケットをオープンして、 IBM サポート・アナリストにご使用の環境を確認してもらいます。

QRadar SOARPlug-inアプリのインストール後に作成されたドメインで、オフェンスの自動エスカレーションが機能しない

QRadar SOARPlug-inアプリをインストールした後、QRadarで新しいドメインが作成されるたびに、管理者はアプリの接続をリセットする必要があります。 これにより、新しく作成されたドメインで自動オフェンス・エスカレーションが機能するようになります。

アプリの接続をリセットするには、以下の手順に従ってください:
  1. 「管理」 タブの 「IBM QRadar SOAR プラグイン」 セクションで、 「構成」をクリックします。
  2. 「状況」 タブで 「アクション」をクリックし、 「接続の削除」をクリックします。
  3. 「アクセス (Access)」 タブで、 「検証と構成 (Verify and configure)」をクリックし、 「保存」をクリックします。
ドメインを組織にマッピングするには、以下の手順に従う:
  1. Mappings]タブで[Verify and configure]をクリックし、[Save]をクリックする。
  2. Configuration Push をクリックします。