分析のためのクラウドへの HCL AppScan Source 評価の送信

appscan package -d <save_path> -f <assessment_file> -n <file_name>

また Linux™ と macOS では、次のコマンドを発行します。

appscan.sh package -d <save_path> -f <assessment_file> -n <file_name>

• -d: -d <save_path> と指定します。<save_path> には IRX ファイルの保存先ディレクトリーが入ります。
• -f: -f <assessment_file> と指定します。<assessment_file> には、スキャン用にパッケージ化する .ozasmt ファイルが入ります。現行ディレクトリーに <assessment_file> ファイルがない場合は、このオプションを使用して評価ファイルのパスとファイル名を指定します。
  注: このオプションが必要なのは、以下の記述のいずれかまたは両方が当てはまる場合のみです。

  • コマンドを発行するディレクトリーに複数のアセスメント・ファイルが含まれている。ディレクトリーに含まれている評価ファイルが 1 つのみであれば、-f オプションが使用されていない場合は、そのファイルがパッケージされます。
  • コマンドを発行するディレクトリーにアセスメント・ファイルが 1 つも含まれていない。この場合は、-f オプションを使用して、パッケージする評価ファイルのパスおよびファイル名を指定する必要があります。
• -n: -n <file_name> と指定します。<file_name> には IRX ファイルの名前が入ります。ファイル名を指定する際に、ファイル拡張子 .irx は付けても付けなくてもかまいません。ファイル拡張子なしで指定すると、ファイル生成時に自動的に拡張子が付けられます。

使用例など、このコマンドに関する追加情報については、「構成コマンド (Windows™)」または「構成コマンド (Linux™ と macOS)」を参照してください。

• HCL Cloud Marketplace:
  Windows™ では、次のコマンドを発行します。

  appscan api_login -P <password> -u <user_name> -persist

  また Linux™ と macOS では、次のコマンドを発行します。

  appscan.sh api_login -P <password> -u <user_name> -persist

  これらの引数は必須です。

  • -P: -P <password> と指定します。<password> には、ASoC サービスへの登録時に指定したパスワードが入ります。
  • -u: -u <user_name> と指定します。<user_name> には、ASoC サービスへの登録時に指定した E メール・アドレスが入ります。

  この引数はオプションです。

  • -persist: ログイン・トークン・ファイルの有効期限が切れたときに、自動的にサービスへの再認証を試みます。

• Windows™ では、次のコマンドを発行します。

  appscan queue_analysis -a <app_id> -f <file> -n <scan_name>

  また Linux™ と macOS では、次のコマンドを発行します。

  appscan.sh queue_analysis -a <app_id> -f <file> -n <scan_name>

  これらの引数は必須です。

  • -f: -f <file> と指定します。<file> は、スキャン用に送信する IRX ファイル、または非 IRX です。ファイルが現行ディレクトリーにない場合、このオプションを使用して ファイル・パスおよびファイル名を指定します。
    注: このオプションが必要なのは、以下の記述のいずれかまたは両方が当てはまる場合のみです。

    • 複数のアセスメント・ファイルが含まれているディレクトリーから、コマンドが発行されています。ディレクトリーに含まれているターゲット・ファイルが 1 つのみで、-f オプションが使用されていない場合は、そのファイルが送信されます。
    • ターゲット・ファイルが 1 つも含まれていないディレクトリーから、コマンドが発行されています。この場合、-f オプションを使用して、送信するファイルのパスとファイル名を指定する必要があります。
  • -a: 分析用に送信するファイル (IRX ファイルまたは非 IRX ファイル) は、既存の AppScan on Cloud アプリケーションに関連付けられている必要があります。このオプションを使用する場合は、-a <app_id> と指定します。<app_id> には、関連付けるアプリケーションの ID が入ります。ID を確認するには、list_apps コマンドを使用します。
• コマンドが完了すると、分析ジョブの ID が表示されます。AppScan on Cloud 分析レポートを受け取るために CLI を使用する場合は、このジョブ ID を appscan get_result (Windows™) または appscan.sh get_result (Linux™ と macOS) コマンドに含める必要があります。この ID をメモしておいてください。CLI を使用して分析レポートを受け取る場合は、AppScan Source で分析レポートを開くことができるように、.ozasmt ファイルが含まれているアーカイブ (.zip) ファイルを受け取るオプションを選択できます。HTML レポートを表示するだけでかまわない場合は、CLI または AppScan on Cloud Web クライアントを使用して、レポートをダウンロードできます。

このコマンドの使用方法について詳しくは、「分析コマンド (Windows™)」または「分析コマンド (Linux™ と macOS)」を参照してください。

appscan get_result -d <file_path> -i <job_id> -t <type>

また Linux™ と macOS では、次のコマンドを発行します。

appscan.sh get_result -d <file_path> -i <job_id> -t <type>

この引数は必須です。

• -i: -i <job_id> と指定します。<job_id> には分析ジョブの ID が入ります。

これらの引数はオプションです。

• -d: -d <file_path> と指定します。<file_path> には、宛先ファイルの完全修飾パスまたはファイル名が入ります。ファイル名が指定されていない場合、ファイル名はスキャン・ジョブ名に基づいた名前になります。パスを指定しない場合、ファイルは現在のディレクトリーに保存されます。このオプションが組み込まれていない場合、ファイルは、スキャン・ジョブ名に基づいたファイル名で現行ディレクトリーに保存されます。
• -t: -t <type> と指定します。<type> には、html または zip が入ります。結果は HTML ファイルとして、または、HTML 結果を含む .zip ファイルとして保存されます。このオプションが組み込まれていない場合、結果は HTML ファイルとして保存されます。

  スキャン結果が package コマンドによって生成された IRX ファイル用のものである場合は、-t zip と指定すると、AppScan バージョン 9.0 以降の製品にロードできる新規の .ozasmt ファイルを含む結果が保存されます。

このコマンドの使用方法について詳しくは、「結果コマンド (Windows™)」または「結果コマンド (Linux™ と macOS)」を参照してください。