在單一虛擬機器上快速安裝 AppScan 360°

快速模式旨在用於在單一 VM 設定中進行概念驗證 (POC) 評估。它提供了引導式安裝路徑，相較於自訂模式需要的決策比較少。

💡 最佳實務：在每次新安裝或重大升級之前，請執行 AppScan 360 Setup Assistant。

重要注意事項：

以管理員身分在目標系統上執行所有安裝與配置活動。
安裝指令碼會詢問環境專屬的問題。在開始之前，請檢閱先決條件安裝指南並準備所需的值。
快速模式適用於評估情境。對於生產部署和升級規劃，請使用自訂/生產指南。

準備安裝檔案

從MyHCLSoftware 入口網站將單一 VM 設定套件和所需的 AppScan 套件下載到一個目錄中。例如 /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 （選用）

將所有套件移至工作資料夾並將套件設為可執行。

mkdir -p ~/aio-setup
mv *.run ~/aio-setup/
cd ~/aio-setup
chmod +x *.run

放置憑證（選填）

如果您使用自訂或自簽憑證來提供 SSO（LDAP、OIDC）或 SMTP 服務，請先建立憑證資料夾。

sudo ./AppScan360_SingleVMsetup_v<version>.run -- $PWD prepareCertsFolders

指令會建立下列資料夾結構：


資料夾	功能
`~/aio-setup/certs/`	主憑證資料夾
`~/aio-setup/certs/docker/`	Docker 登錄服務憑證（快速/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/`	輸入/應用程式網域憑證（選用，如果未提供，則會產生自簽憑證）

建立資料夾後，將憑證檔案放到相應的路徑中。

執行安裝

開始安裝：

cd ~/aio-setup
sudo ./AppScan360_SingleVMsetup_v<version>.run -- $PWD

停止並清理中斷的安裝：

cd aioWorkspace
./disengageAS360-AIO.sh

安裝日誌檔會寫入到 ./aioWorkspace/logs。

出現提示時，選擇快速模式(POC)：

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

完成快速模式 (POC) 問卷調查。

快速模式 (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)?

確認並繼續：
```
> Continue with installation? (y/n) [Default: y]:
```
確認後，安裝程式會繼續執行快速元件，包括：
- Kubernetes 叢集 (K0S)
- Docker Private Registry (DPR)
- SQL Server 實例 (MSSQL)
- AppScan 360° 中央平台 (ASCP) 與元件。
- AppScan 補救諮詢 (ASRA)
- DAST 範本轉換器服務 (DTCS)
- 軟體組合分析 (SCA) 測試（如選取）
完成後，安裝程式會列印：
- 要新增的 Hosts 檔項目
- 存取 AppScan 360 的最終 URL

將產生的 IP 位址與主機名稱對映新增至主機檔案。


作業系統	主機檔案路徑
Linux、MacOS	`/etc/hosts`
Windows	`C:\Windows\System32\drivers\etc\hosts`

例如：

192.168.1.100 appscan.appscan-test.local

登入與啟動 AppScan 360°

若要登入並啟動 AppScan 360°：

開啟安裝完成時列印的 URL：https://<host>.<domain>。
以預設憑證登入：
- 使用者名稱：Admin
- 密碼：Admin12!
上傳您的 AppScan 360° 授權檔案以啟動部署。

解除安裝

如果要移除 AppScan 360° 的快速單一 VM 設定：

cd ~/aio-setup/aioWorkspace
sudo ./disengageAS360-AIO.sh

這會移除已安裝的元件和此次安裝建立的 AppScan 360° 資源。

變更安裝方法

如果想要超越快速模式：

有關生產單一 VM 設定，請參閱在單一虛擬機器上上自訂安裝 AppScan 360°。
有關多節點部署，請參閱 AppScan 360° 的分散式安裝。