在單一虛擬機器上自訂安裝 AppScan 360°

自訂模式旨在用於完整的單一 VM 配置以及生產導向的部署。與快速模式相比，此模式支援更多的部署選擇，包括外部資料庫配置、Docker 登錄選擇、選擇性的代理伺服器設定，以及 OpenTelemetry 整合。

註： 以管理員身分在目標系統上執行所有安裝與配置步驟。

開始之前

  1. 檢閱設定單一 VM 環境並收集設定過程中所需的值。
  2. 從MyHCLSoftware入口網站將所有必要的套件下載到一個目錄中。例如 /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 （選用）
  3. 準備工作目錄並將套件設為可執行：
    mkdir -p ~/aio-setup
mv *.run ~/aio-setup/
cd ~/aio-setup
chmod +x *.run

放置憑證（選填）

  1. 如果您對 LDAP、OIDC、SMTP、Docker 登錄、輸入，或 OpenTelemetry 收集器信任，使用了自訂或自簽憑證，請先建立憑證資料夾結構：
    sudo ./AppScan360_SingleVMsetup_v<version>.run -- "$PWD" prepareCertsFolders
    此指令會建立：
    資料夾 功能
    ~/aio-setup/certs/ 主憑證資料夾
    ~/aio-setup/certs/docker/ Docker 登錄憑證
    ~/aio-setup/certs/ldap/ LDAP 憑證 (LDAPS)
    ~/aio-setup/certs/smtp/ SMTP 憑證 (SMTPS)
    ~/aio-setup/certs/oidc/ OIDC 憑證 (OIDCS)
    ~/aio-setup/certs/otel/ 當收集器使用私有 CA 時，OpenTelemetry 憑證
    ~/aio-setup/certs/ingress/ 輸入憑證（選用，如果未提供，則會產生自我簽署）
  2. 建立資料夾後，在開始安裝前，將憑證檔案放到相應的路徑中。

執行安裝

  1. 啟動安裝程式：
    cd ~/aio-setup
sudo ./AppScan360_SingleVMsetup_v2.1.0.run -- $PWD

    如果需要停止並清理中斷的安裝：

    cd aioWorkspace
./disengageAS360-AIO.sh
    安裝日誌檔會寫入到 ./aioWorkspace/logs。
  2. 出現提示時，選擇 自訂模式（正式版）。
    Please select your installation path:
1. 🚀  Express Mode (POC)
2. 🛠️  Custom Mode (Production)
Enter 1 or 2 [Default: 1]:

完成自訂問卷調查

與快速模式相比，生產流程詢問的問題更廣泛。

選取 SCA

Will this production deployment include Software Composition Analysis (SCA)? This requires license. (y/n) [Default: n]:

如果啓用 SCA，其他資料庫和登錄提示稍後會在流程中顯示。

資料庫配置

選擇資料庫類型：

Please select the database type for this production deployment:
1. 🔷 Microsoft SQL Server (MSSQL)
2. 🐘 PostgreSQL
Enter 1 or 2 [Default: 1]:

然後提供資料庫連線詳細資料：

> Enter Database Hostname or IP:
> Enter Database Port [Default: 1433]:
> Enter Database User for AppScan:
> Enter Database User Password:
> Enter the name for the main AppScan database [Default: AppScanCloudDB]:

如果選擇 PostgreSQL，則預設埠爲 5432。

SCA 專屬配置

如果啓用了SCA，安裝程式還會要求：

> Please provide a name for the new SCA database [Default: AppScan360_SCA_DB]:
> Please provide a name for the new SCA Aggregation database [Default: AppScan360_SCA_Aggregation_DB]:
> SCA Registry Address [Default: hclcr.io]:
> SCA Registry Path [Default: appscan360/as360-k8s-docker-images]:
> SCA Helm Repository Path [Default: appscan360/as360-k8s-helm-packages]:
> SCA Registry Username (typically your HCL ID):
> SCA Registry Password/Token:

如果要啓用 SCA 漏洞資料庫更新，請使用 HCL 憑證。

網路配置

主要網域：

Please enter the primary domain name for this installation. This will be used to create the access URL (e.g., yourcompany.com):

傳出存取所需的外部網域或 IP：

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 this VM connected to a local DNS server? (y/n) [Default: n]:

OpenTelemetry 端點：

Provide the OpenTelemetry collector endpoint URL. If not applicable, press Enter to skip (recommended format: http://<opentelemetry-collector-host>:4317):

共享儲存空間大小：

To plan for long-term storage costs, estimate the number of scan results you plan to retain. > Specify the shared storage capacity in GB [Default: 200]:

SMTP 郵件中繼（選填）

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

如果啓用，安裝程式將會要求：

What is the SMR host?
What is the SMR port?
What is the SMR username?

鑑別模式：

Select SMTP authentication mode:
1. Password
2. Client Secret
Enter 1 or 2 [Default: 1]:

然後會要求輸入 SMR 密碼或 SMR 用戶端機密，隨後接著：

Does the SMR operate over SSL/TLS. If yes, a certificate is required to be present in certs/smtp folder (y/n)?

Docker 登錄配置

自訂模式支援套件管理的本端 Docker Private Registry 或外部登錄。

選擇是否讓套件在本端安裝並管理 DPR：

Do you want the kit to install and manage a local Docker Private Registry (DPR) on this VM? (y/n) [Default: n]:

如果選擇 n，安裝程式會要求提供外部登錄詳細資料：

What is the external Docker Private Registry (DPR) address (FQDN:PORT)?
What is the external Docker Private Registry (DPR) username?
What is the external Docker Private Registry (DPR) password?
What is the docker registry context/repository name [Default: as360-k8s-docker-images]:
What is the helm repository context/repository name [Default: as360-k8s-helm-packages]:

如果要使用登錄根路徑而非上下文路徑，請在上下文提示下輸入 EMPTY。

如果選擇 y，套件會自動準備一組本端 DPR。

代理伺服器（選填）

Do you want to use a proxy service? (y/n) [Default: n]:

如果啓用，安裝程式將會要求：

What is the proxy host?
What is the proxy port?
Does the proxy require user/password credentials? (y/n):
What is the proxy username?:
What is the proxy password?:

最終確認

在安裝開始之前，指令碼會顯示您的選擇摘要並要求確認：

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

安裝程式配置的內容

確認後，安裝程式會配置：
  • Kubernetes 叢集 (K0S)
  • AppScan 360° 中央平台 (ASCP) 與支援元件。
  • AppScan 補救諮詢 (ASRA)
  • 軟體組合分析 (SCA) 測試（如選取）
  • 外部資料庫連線
  • Docker 登錄連線

安裝時間取決於系統硬體效能和網路效能。

完成後，安裝程式會列印：
  • 要新增的主機檔案項目
  • 最終 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°：
  1. 開啟安裝完成時顯示的 URL：https://<host>.<domain>
  2. 以預設憑證登入：
    • 使用者名稱：Admin
    • 密碼：Admin12!
  3. 上傳您的 AppScan 360° 授權檔案以啟動產品。

備份建議事項

定期備份這些項目：

  • 資料庫
  • 安裝目錄中的配置檔
  • 授權資訊

變更安裝方法

對於分散式部署，請遵循 AppScan 360° 的分散式安裝。

常見的安裝問題

問題 解決方案
資料庫連線失敗 確認資料庫認證和網路連線
磁碟空間不足 確保 VM 有足夠的儲存空間來儲存您所選的配置
憑證錯誤 驗證憑證檔案格式，檔案名稱以及 certs 資料夾中的位置
Docker 登錄連線 確認登錄憑證、地址和網路連線
任何其他問題 疑難排解手冊