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

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

場所証明書 (必要に応じて)

1. SSO (LDAP、OIDC) や SMTP などのサービスにカスタム証明書または自己署名証明書を使用する場合は、証明書フォルダーを準備します。

   sudo ./AppScan360_SingleVMsetup_v2.1.0.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 証明書 (OIDCS サポート用)
   ~/aio-setup/certs/ingress/	Ingress 証明書 (オプション、提供されない場合は自己署名が生成されます)

2. フォルダー構造を作成したら、続行する前に適切なフォルダーに証明書を配置します。

インストールの実行

1. 以下のコマンドを使用してインストールを実行します
   注: フォルダーの場所からインストールしている場合でも、ファイルのフォルダーの場所 (この場合は現在の作業ディレクトリー) を指定します。

   cd ~/aio-setup
   
   sudo ./AppScan360_SingleVMsetup_v2.1.0.run -- $PWD

   注: 何らかの理由でインストールを中止/削除するには、CTRL+C を押してから実行してください。

   cd aioWorkspace
   ./disengageAS360-AIO.sh

   インストール・ログ・ファイルは、./aioWorkspace/logs にあります。
2. 次のようにプロンプトが表示されたら、1 を入力して Express/PoC インストールを指定します。Enter キーを押します。

   Please select your installation path:
   1. 🚀  Express Mode (POC)
   2. 🛠️  Custom Mode (Production)
   Enter 1 or 2 [Default: 1]:

3. インストール環境にソフトウェアコンポジション分析 (SCA) を含めるかどうかを選択します。

   Do you want to install the optional SCA kit for this evaluation? (y/n)?

   デフォルトは n です。

   • y: お使いのインストール環境にソフトウェア・コンポジション分析 (SCA) を含めます。SCA でアプリケーションにオープン・ソース・コンポーネントの脆弱性がないか分析できます。

   • n: お使いのインストール環境でソフトウェア・コンポジション分析 (SCA) を有効にしないでください。

4. インストール手順では、入力内容に基づいて一連の質問が行われます

   Please enter the primary domain name for this instance.

   • これはデフォルト値のない必須フィールドです。指定されたドメイン名は AppScan 360° インスタンスのアクセス URL の作成に使用されます。例えば、appscan-test.local を入力すると、AppScan 360°の URL は https://hostname.appscan-test.local になります。ドメイン名は、覚えやすい名前にし、ネットワーク環境内で一意であり、既存のドメインと競合しないようにする必要があります。

     > 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:

   • 次のように、AppScan 360° インスタンスが接続する必要があるドメインまたは IP アドレスを入力します。
     • E メール通知用の SMTP サーバー
     • SSO 認証プロバイダー (LDAP、OIDC)
     • 外部 CI/CD ツール
   • 複数のエントリーを指定する場合は、コンマで区切ります。外部サービスが不要な場合は、空白のままにします。

     > Is the VM connected with the local DNS server (y/n)?

     • デフォルトは n です。
       • y: VM が DNS サーバーに接続されています。ネットワーク関連の構成にホスト名が使用されます。
       • n: VM が DNS サーバーに接続されていません。ネットワーク関連の設定に IP アドレスが直接使用されます。

     > 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:

   • このストレージは、コンポーネント間で共有されるログ、構成ファイル、および永続データに使用されます。デフォルトは 20GB です。
     • Enter キーを押してデフォルト値を受け入れるか、
     • 別の数字を入力してカスタム・ストレージ値を指定し、Enter キーを押します。

     > Do you want to connect with your SMTP Mail Relay (SMR)(y/n)?

   • デフォルトは n です。

     SMTP メール・リレーは、システムから送信された電子メールを受け入れ、受信者の電子メール・サーバーに転送する中間サーバーです。リレーは、電子メールの配信を保証し、スパム・フィルタリングなどの特定のルールを適用できます。AppScan 360° で、スキャンが完了したとき、スケジュール/スキャンが開始されたときなどに通知メールを受信するようにリレーを設定します。

     • y: 配置から電子メールを送信するために、AppScan 360° を SMTP メールリレーと統合します。y を選択した場合は、SMR にセットアップを完了するように求めるプロンプトが表示されたら、適切なホスト、ポート、資格情報、および暗号化の詳細を入力します。

       > Please enter the SMTP host:

       > Please enter the SMTP port:

     • 通常、ポート番号は 25、465、または 587 です。

       > Please enter the SMTP username:

     • 認証が必要な場合

       > Please enter the SMTP password:

     • 認証が必要な場合。

       > Does your SMTP server use SSL/TLS? (y/n)?

     • n: SMTP サーバーが設定されません。ユーザーは関連する電子メール通知を受信できません。
5. インストールでは、選択内容の概要が表示され、インストールを続行するかどうかを尋ねられます。

   > Continue with installation? (y/n) [Default: y]:

6. 情報が正しいことを確認し、y と入力します。
   インストールを進めるにあたり、次のものがインストールおよび構成されます。

   • Kubernetes クラスター (K0S)

   • Docker Private Registry (DPR)

   • SQL Server インスタンス (MSSQL)
   • AppScan 360° のセントラルプラットフォーム (ASCP) とその構成要素。
   • AppScan 修復アドバイザリー (ASRA)
   • DAST テンプレートコンバーター・サービス (DTC)
   • ソフトウェア・コンポジション分析 (SCA)、選択した場合
7. 数分後、インストールが完了すると、完了メッセージが表示されます。

   The AS360 Single VM was installed, to access it do the following:
     1. Add to your 'hosts' file the following line: [IP_ADDRESS] 
   [HOSTNAME].[DOMAIN]
   
    2. Access https://[HOSTNAME].[DOMAIN] in your browser

8. ホスト・ファイルに指定された IP アドレスとホスト名を追加します。

   オペレーティング・システム	ホスト・ファイルの場所
   Linux、MacOS	/etc/hosts
   Windows	C:\Windows\System32\drivers\etc\hosts

   例:

   192.168.1.100 appscan.appscan-test.local

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

アンインストール

インストール方法の変更