AppScan 360° のシングル仮想マシンへの Express インストール

Express モードは、シングル VM セットアップで概念実証 (POC) 評価を行うことを目的としています。カスタム・モードよりも少ない判断でガイド付きインストール・パスを提供します。

💡 ベスト・プラクティス: あらゆる新規インストールまたはメジャー・アップグレードの前にAppScan 360 セットアップ・アシスタントを実行します。

重要な注:

  1. ターゲット・システムで、すべてのインストールおよび設定作業を管理者として実行します。

  2. セットアップ・スクリプトは環境固有の質問をします。前提条件セットアップ・ガイド を確認し、必要な値を準備してから開始します。

  3. Express モードは評価シナリオ用です。実稼働環境への配置とアップグレード計画には、カスタム/実稼働環境ガイダンスを使用します。

インストールファイルの準備

  1. シングル VM セットアップ・キットと必要な AppScan キットを MyHCLSoftware ポータル から 1 つのディレクトリーにダウンロードします。例えば、/home/username/AppScan360_singleVM です。
    すべてのインストール・キット・ファイルは同じディレクトリーに保存します。一般的なキット・ファイル:
    • AppScan360_SingleVMsetup_v<version>.run
    • AppScan360_v<version>.run
    • AppScan360_ASRA_v<version>.run
    • AppScan360_DTCS_v<version>.run (DAST テンプレート機能に必要)
    • AppScan360_SCA_v<version>.run (オプション)
  2. すべてのキットを作業フォルダーに移動し、実行可能にします。
    mkdir -p ~/aio-setup
mv *.run ~/aio-setup/
cd ~/aio-setup
chmod +x *.run

証明書の配置 (オプション)

  1. SSO (LDAP、OIDC) や SMTP などのサービスにカスタム証明書または自己署名証明書を使用する場合は、最初に証明書フォルダーを作成します。
    sudo ./AppScan360_SingleVMsetup_v<version>.run -- $PWD prepareCertsFolders
    コマンドは、次のフォルダー構造を作成します。
    フォルダー 関数
    ~/aio-setup/certs/ メイン証明書フォルダー
    ~/aio-setup/certs/docker/ Docker レジストリー証明書 (通常、express/PoC インストールでは不要)
    ~/aio-setup/certs/ldap/ LDAP 証明書 (LDAPS)
    ~/aio-setup/certs/smtp/ SMTP 証明書 (SMTPS)
    ~/aio-setup/certs/oidc/ OIDC 証明書
    ~/aio-setup/certs/otel/ Open Telemetry 証明書 (コレクターがプライベート CA によって署名されている場合に使用)
    ~/aio-setup/certs/ingress/ Ingress/アプリケーション・ドメイン証明書 (オプション、提供されない場合は自己署名証明書が生成されます)
  2. フォルダーが作成されたら、証明書ファイルを適切なパスに配置します。

インストールの実行

  1. インストールの開始:
    cd ~/aio-setup
sudo ./AppScan360_SingleVMsetup_v<version>.run -- $PWD
    中断されたインストールを停止してクリーニングするには:
    cd aioWorkspace
./disengageAS360-AIO.sh
    インストール・ログ・ファイルは、./aioWorkspace/logs に作成されます。
  2. プロンプトが表示されたら、Express モード (POC) を選択します。
    Please select your installation path:
1. 🚀  Express Mode (POC)
2. 🛠️  Custom Mode (Production)
Enter 1 or 2 [Default: 1]:
  3. Express モード (POC) アンケートに回答します。

    Express モード (POC) でのキー・プロンプト。

    • オプションのソフトウェア・コンポジション分析 (SCA) セクション:
      Do you want to install the optional SCA kit for this evaluation? (y/n) [Default: n]:

    • プライマリー・ドメイン (最終アクセス URL の生成に使用):

      Please enter the primary domain name for this instance. This will be used to create the access URL.(e.g., appscan-test.local):
    • アウトバウンド・アクセスに必要な外部ドメインまたは IP (SSO または SMTP エンドポイントなど):
      Provide the external domain(s) or IP address(es) this instance must access for external services (e.g., SSO, SMTP). Use commas to separate multiple values. If none, press Enter to skip:

    • ローカル DNS 接続:

      Is the VM connected to a local DNS server? (y/n) [Default: n]:

    • 共有ストレージ・サイズ (デフォルトは 20 GB):

      A small amount of storage is required for your evaluation. We will allocate a default of 20 GB to accommodate all chosen components. Press Enter to accept 20 GB or specify a different size:

    • SMTP メール・リレー (オプション):

      Do you want to configure an SMTP Mail Relay(SMR)? (y/n) [Default: n]:

      SMTP が有効になっている場合は、以下のような追加プロンプトが表示されます。

      • SMR ホスト

      • SMR ポート

      • SMR ユーザー名

      • 認証モード:
        Select SMTP authentication mode:
1. Password
2. Client Secret
Enter 1 or 2 [Default: 1]:

      選択に基づいて、インストーラーは SMR パスワードまたは SMR クライアント・シークレットのいずれかを要求します。

    • SMTP セキュア・トランスポート:
      Does the SMR operate over SSL/TLS. If yes, a certificate is required to be present in certs/smtp folder (y/n)?
  4. 確認して続行します。
    > Continue with installation? (y/n) [Default: y]:
    確認後、インストーラーは以下のような Express コンポーネントを実行します。
    • Kubernetes クラスター (K0S)
    • Docker Private Registry (DPR)
    • SQL Server インスタンス (MSSQL)
    • AppScan 360° のセントラル・プラットフォーム (ASCP) とそのコンポーネント。
    • AppScan 修復アドバイザリー (ASRA)
    • DAST テンプレート・コンバーター・サービス (DTCS)
    • ソフトウェア・コンポジション分析 (SCA)、選択した場合
    完了すると、インストーラーは以下を出力します。
    • 追加する hosts ファイル・エントリー
    • AppScan 360 にアクセスするための最終 URL
  5. 生成 IP アドレスとホスト名のマッピングをホスト・ファイルに追加します。
    オペレーティング・システム ホスト・ファイル・パス
    Linux、MacOS /etc/hosts
    Windows C:\Windows\System32\drivers\etc\hosts
    例:
    192.168.1.100 appscan.appscan-test.local

ログインおよびアクティブ化 AppScan 360°

AppScan 360° にログインしてアクティブ化するには、次の手順を実行します。
  1. インストール完了時に印刷された URL を開きます。https://<host>.<domain>。
  2. デフォルトの資格情報でサインインします。
    • ユーザー名: Admin
    • パスワード: Admin12!
  3. AppScan 360° ライセンス・ファイルをアップロードして、デプロイメントをアクティブ化します。

アンインストール

AppScan 360° の express シングル VM インストールを削除するには:
cd ~/aio-setup/aioWorkspace
sudo ./disengageAS360-AIO.sh
これにより、インストールされているコンポーネントと、このセットアップによって作成された AppScan 360° リソースが削除されます。

インストール方法の変更

Express モードを超えて移動する場合: