コンテナー化スキャンのトラブルシューティング

• [アプリケーション] > (アプリケーション) > [すべてのスキャンを表示] > (スキャン名)の順に選択します。または、
• [スキャン] > (スキャン名) を選択します。

• オープン・ソース
• IPVA なし/破損した IRX
• 不明エラー

1. ターゲット・ファイルがオープン・ソース・ファイルでないことと、openSourceOnly パラメーターが使用されていないことを確認して、appscan prepare を再実行します。
   注: ここで、appscan prepare 用にサポートされているパラメーターを確認します。
2. 問題が解決しない場合は、スキャン・ログをダウンロードし、管理者にエスカレーションします。

1. スキャン・ページ (アプリケーション > アプリケーション > すべてのスキャンの表示 > (スキャン名) または スキャン > (スキャン名)) で、スキャンの詳細の下に表示されている実行 ID をコピーします。
2. スキャン・ページの右上で、管理スキャン > ダウンロード・ログを選択します。

   AppScan 360° ZIP ファイルをローカル・システムにダウンロードします。ダウンロードの場所を書き留めておきます。

3. ZIP ファイルの内容を解凍します。
4. service.log ファイルを開きます。

   このファイルから、エラーがスローされたステップを特定できるはずです。

   次に例を示します。

   Request received to perform scan for execution-id 4277b41a-18ad-44ad-81c9-9542e7af83d7.
   Initiated fetch scan data request with scan-id e7330058-c743-41af-8914-95eb30554d78.
   Downloaded scan data successfully.
   Request received to perform scan.
   Initiated prepare request with scan-id e7330058-c743-41af-8914-95eb30554d78.
   Received prepare (PERFORM_PREPARE) request with scan-id e7330058-c743-41af-8914-95eb30554d78 by preparer-6d7c4c9c58-c4kgq.
   Execution completed with exit code -1.
   Request received to publish status to server for scan-id e7330058-c743-41af-8914-95eb30554d78. (Failed: Execution completed with exit code -1.)

   この例では、エラーは PERFORM_PREPARE ステップ中にスローされました。prepare ステップ中に障害が発生したため、準備ポッドを調べます。

• 実行 ID

  上記の service.log の例では、 execution-id 4277b41a-18ad-44ad-81c9-9542e7af83d7。

• スキャン ID

  上記の service.log の例では、 scan-id e7330058-c743-41af-8914-95eb30554d78。

• 準備ポッド ID (該当する場合)

  上記の service.log の例では、 preparer-6d7c4c9c58-c4kgq。

• アナライザ・ポッド ID (該当する場合)
• AppScan 360°または service.log のスキャン・ページに報告されたエラー。
• ログ ZIP ファイル。
• スキャンするアプリケーション/プロジェクトの詳細。

• スキャン・ログへのアクセス
• IPVA なし/破損した IRX エラーが表示されている IRX を調査する
• オープン・ソース・エラーのある IRX の調査
• スキャンのためのポッド・ログへのアクセス
• その他のエラー・ケースの調査

1. Swagger ページを開きます。
2. 右上の [スキャンサービス] > [スキャン管理サービス] を選択します。
3. [許可]をクリックします。
4. デプロイメント中に渡したAppScan Central Platformシークレット (--auth-token flag) を入力し、[許可] をクリックします。
5. [ぜひお試しください。] をクリックします。
6. スキャン ID をテキストボックスに貼り付けて、[実行]をクリックします。

   スキャン ID がわからない場合は、スキャン・ページからダウンロードした service.log で確認できます。

7. 応答の本文で、[ログのダウンロード] リンクをクリックします。

   これにより、複数のログ・ファイルを含む ZIP ファイルがローカル・マシンにダウンロードされます。ダウンロードしたファイルの場所を書き留めておきます。

8. 次のログを抽出して、エラーを調査します:
   • prepare.log
   • StaticAnalyzer-Errors.log
   • SASTAgent.log
9. エラーがあれば解決し、スキャンを再試行します。

1. Kubernetes IDE で、調査しているポッドのログをダウンロードします。
2. このファイルで、スキャン ID 文字列を検索します。
   準備または分析ステージは、ログ内で次のようになります。

   Payload(id= e7330058-c743-41af-8914-95eb30554d78, type=PERFORM_PREPARE,
   Payload(id= e7330058-c743-41af-8914-95eb30554d78, type=PERFORM_ANALYSIS,

   これらの行の後に、準備コマンドと解析コマンドが実行されます。ここにエラーが表示されます。何が問題かがこのログに明確に示されていない場合は、ポッドに接続してさらに調査してください。
3. ポッドに接続して、次のコマンドを実行します。

   >: cd ~/data/scans/<scan_id>/logs

4. エラーの検索:
   1. 準備エラーについては、prepare.log および SAClientUtil/logs/client.log を参照してください。

      SAClientUtil/logs/client.log ~/SAClientUtil にあります。

   2. 解析エラーについては、StaticAnalyzer-Errors.log および SASTAgent.log を参照してください。

• オープン・ソース・ファイル・タイプ・エラー
• 既知のファイル・タイプがないエラー
• スキャン可能なファイルがないエラー

Problems found during validation. 
The prepare operation found only open source files types. To run opensource only, use the -oso flag. To run security and opensource, include additional supported file types.

• appscan prepare コマンドでサポートされていないパラメーターを使用していないことを確認します。openSourceOnly="true" または -oso が表示されている場合は、このパラメーターを削除します。

  AppScan 360° appscan prepare では、 openSourceOnly または -oso パラメーターはサポートされていません。

• IRX をアップロードし、サードパーティ・ライブラリのみがある場所でスキャンを実行する場合は、サードパーティ・スキャンを有効にします。以下のいずれかです。

  1. サードパーティ・フラグを appscan prepare に追加して、サードパーティ・ライブラリをピックアップし、スキャンを再試行します。

     コマンドは次のようになります: appscan prepare -tp。

  2. thirdParty="true" を appscan-config.xml に追加して、スキャンを再試行します。

     例については、CLI を使用した IRX ファイル生成の構成を参照してください。

• ZIP をアップロードし、サードパーティ・ライブラリのみがある場所でスキャンを実行する場合は、サードパーティ・スキャンを有効にします:
  • サードパーティのコードをスキャンする場合は、 add thirdParty="true" を appscan-config.xml に追加して、スキャンを再試行します。

No known scan file types were found during discovery. 
Please specify a location that contains .class, .jar, .war, .ear, .dll, .exe, PHP, Ruby, NPM packages, or JavaScript files.

Problems found during validation. 
No scannable files found. If you are trying to scan third party code, generate the IRX file using the --thirdParty option. If you are trying to scan for open source, generate the IRX using the -oso option. For a list of supported file types, refer to https://help.hcl-software.com/appscan/ASoC/src_language_support.html#src_language_support__table_ylp_rn5_jw.

• サードパーティ・ライブラリのみがある場所でスキャンを実行する場合は、サードパーティ・スキャンを有効にする必要があります。以下のいずれかです。
  1. サードパーティ・フラグを appscan prepare に追加して、サードパーティ・ライブラリをピックアップし、スキャンを再試行します。

     コマンドは appscan prepare -tp のようになります。

  2. thirdParty="true" を appscan-config.xml に追加して、スキャンを再試行します。

     例については、CLI を使用した IRX ファイル生成の構成を参照してください。

• データ・フロー分析スキャンを実行する場合は、ターゲット・スキャンの場所に Java、.NET、または C/C++ 用の正しいコンパイル済みファイル・タイプが含まれていることを確認してから、スキャンを再試行してください。

• ソース・コードのみのスキャンを実行する場合は、ターゲット・ロケーションに正しいソース・コード・ファイル・タイプが含まれていることを確認してから、スキャンを再試行してください。
• ソース・コードのみのスキャンを実行しない場合は、appscan prepare コマンドまたは appscan-config.xml から –sco フラグを削除して、スキャンを再試行します。

• 実行 ID
• スキャン ID
• 準備ポッド ID (該当する場合)
• アナライザ・ポッド ID (該当する場合)
• AppScan 360°または service.log のスキャン・ページに報告されたエラー。
• ログ ZIP ファイル。
• スキャンするアプリケーション/プロジェクトの詳細。
• 問題のトラブルシューティングおよび/または解決のために実行された手順の詳細。