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

mkdir -p ~/aio-setup
mv *.run ~/aio-setup/

sudo ./AppScan360_SingleVMsetup_v2.1.0.run -- $PWD prepareCertsFolders

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

cd aioWorkspace
./disengageAS360-AIO.sh

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

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

• 預設值為 n。
  • y: 在您的安裝中納入軟體組成分析 (SCA) 元件。SCA 能讓您分析應用程式的開放原始碼元件漏洞。
  • n：請勿在安裝時納入軟體組成分析 (SCA) 元件。
• 正式版安裝必須配置外部 MSSQL 資料庫。在提示出現時回應。

  🛢️ *** Database Configuration ***
  > 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]:

• 如果您選擇在安裝中加入軟體組成分析 (SCA)：
  • 輸入 SCA 資料庫名稱：

    > Please provide a name for the new SCA database [Default:
     AppScan360_SCA_DB]:

  • 輸入 SCA 聚集資料庫名稱：

    > Please provide a name for the new SCA Aggregation database 
    [Default: > AppScan360_SCA_Aggregation_DB]:

  • 輸入 SCA 更新的登錄資訊，或在適用的情況下接受預設值：

    > SCA Registry Address [Default: hclcr.io]:
    > SCA Registry Path [Default: appscan360/as360-k8s-docker-images]:
    > SCA Registry Username (typically your ID):
    > SCA Registry Password/Token:
    > SCA Helm Repository Path [Default:appscan360/as360-k8s-helm-packages]:

  • 附註：使用您的 ID 與密碼/記號來啟用 SCA 漏洞資料庫的自動更新。您的系統必須連線至網際網路才能進行自動更新。

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

• 這是沒有預設值的必填欄位。指定的網域名稱是用來建立 AppScan 360° 實例的存取 URL。例如，如果輸入 appscan-test.local，您的 AppScan 360° URL 就會是 https://hostname.appscan-test.local。
  網域名稱應便於記憶，且在您的網路環境中是唯一的名稱，不與現有網域衝突。

  > Please enter the external domain(s) or IP(s) that this instance 
  will need to access for external services(such as SSO, SMTP, 
  etc.). Separate multiple entries with commas:

• 輸入 AppScan 360° 實例需要連線的任何網域或 IP 位址，例如：
  • 用於電子郵件通知的 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 位址進行網路相關配置。

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

• 此儲存空間用於元件之間共用的日誌、配置檔、持續性資料和掃描日誌。預設值為 200GB。
  • 請按 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? If yes, a certificate is 
    required to be present in certs/smtp folder (y/n)?

  • n：未設定 SMTP 伺服器；使用者無法收到任何相關電子郵件通知。
• 如果無法引入外部 DPR，請選擇是否設定本端 DPR

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

• 如果輸入 y，將略過後續的 Docker 查詢，並為其設定預設值。如果輸入 n，則請在後續問題出現時輸入 DPR 詳細資料
  • Docker 登錄配置：

    🐳 Docker Registry Configuration
    > 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?

  • 如果需要鑑別

    🐳 Docker registry and Helm repository context names are used to 
    set the context for docker images and helm charts.
    💡 To set these to an empty string(root repository), type EMPTY
    ----------------------------------------------------------------
    --------------------------------
    > 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]:

    🔄 Proxy Service Configuration
    > Do you want to use a proxy service? (y/n) [Default: n]:

  • y: 配置 Proxy 服務。

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

  • n：略過 Proxy 配置。

✅ Summary of your choices:
  Installation Mode: Custom (Production)
  Install SCA Kit: [y/n]
  Domain: [your domain]
  Connected to Local DNS: [y/n]
  Storage Size: [size]GB
  Use SMTP Mail Relay: [y/n]
  Docker Private Registry Address: [address]
  Scan Concurrency: SAST=[n], DAST=[n], IAST=[n], SCA=[n]
  MSSQL Host: [host], Port: [port], DB: [database]

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

確認資訊正確無誤，然後輸入 y 以繼續，若不正確或需要變更，則請輸入 n 並按下 Enter 鍵

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