設定 AppScan 360° 分散式環境

HCL ID

您的 HCL ID 會將您的帳戶與有效授權建立關聯，並可存取軟體和支援。必須存取 HCL 授權與下載入口網站和 HCL Harbor。

如需建立 HCL ID 和存取授權和軟體的完整資訊，請參閱本文件。

Linux 系統

需要 Ubuntu Linux 系統 24.04 版或更新版本，才能啟動部署。實際部署可在遠端 Kubernetes 叢集中，但部署是從此 Linux 機器起始。系統必須安裝 Bash Shell 和 openssl，而且可以連線至指定的 SQL 伺服器。

對於動態掃描，在所有執行動態掃描的節點中增加核心中的 inotify 執行個體數量：

將 fs.inotify.max_user_instances=524288 新增至 /etc/sysctl.conf。
重新啟動節點，讓變更生效。

本端儲存器服務 (Docker)

Docker 是可將映像檔推送至遠端登錄的本端儲存器服務。從 HCL 授權與下載入口網站下載的封存檔中安裝 AppScan 360° 平台和 AppScan 補救諮詢時，必須使用此服務。

Kubectl

Kubectl 用來與遠端 Kubernetes 叢集通訊。

如需安裝和配置 Kubectl 的完整指示，請參閱這裡。

Helm 3

Helm 3 是一組資源，可讓配置和使用 Kubernetes 應用程式變得更簡單。

如需安裝 Helm CLI 的完整指示，請參閱此處。

註： Helm 版本 3.14 至 3.17 皆已經驗證可搭配 AppScan 360° 使用。

確認 Linux 與元件服務之間的通訊

若要驗證 Kubernetes 連線能力，請執行：

> kubectl version

或

> kubectl get nodes

若要驗證 Docker 連線能力，請執行：

> docker version

若要驗證 Helm 連線能力，請執行：

> helm version

Kubernetes 叢集

叢集是 AppScan 360° 平台代理程式儲存器的所在位置，也是使用的位置。

需要支援 ReadWriteMany 的儲存提供者。如果要使用如 longhorn 的自訂儲存提供者，則確保其支援 ReadWriteMany。

此外，為確保 Pod 存取持續性磁碟區時，檔案許可權及安全性皆正確，Kubernetes CSI 驅動程式必須具備 fsGroup 安全性環境定義支援。

註：唯有當您需要 IPv6 才能使用 AppScan 360° 的情況下，Kubernetes Distribution 必須啟用雙協定 IPv4 及 IPv6 功能。

輸入控制器

部署支援 HTTPS 後端通訊協定的輸入控制器。

建議的輸入控制器為 NGINX（1.11.5 版或 1.12.1 版，或更新版本）。但是，如果叢集中已有適當的輸入控制器，則不需要安裝新的控制器。

這個控制器應該符合下列需求：

proxy-body-size：2g
proxy-connect-timeout：3600
proxy-read-timeout：3600
proxy-send-timeout：3600
enable-access-log-for-default-backend：true
ssl-redirect：true
use-http2：true
use-forwarded-headers：true
compute-full-forwarded-for：true

認證管理員

安裝及配置認證管理員。

指標伺服器

可擴充且有效率的容器資源度量，供 Kubernetes 內建的自動擴充管道使用。

MSSQL

MSSQL 是一種關聯式資料庫管理系統。

SSO (LDAP Active Directory/Open ID Connect)

Active Directory 會鑑別並授權網路中的所有使用者及電腦，指派並強制執行網路存取的安全原則。

Open ID Connect 是 OAuth 2.0 上的驗證層，可讓用戶端根據授權伺服器所執行的鑑別，來驗證一般使用者的身分，並以可交互作業且類似 REST 的方式，取得一般使用者的基本個人資訊。

重要：從 AppScan 360° 1.1.0 版或更早版本升級時，LDAP 配置無法直接沿用。安裝前，您必須確認所有 LDAP 參數均符合 AppScan 360° 目前或更新後的要求。

網路

網路應加密並支援網路原則。

重要：我們強烈建議安裝憑證以進行用戶端之間的通訊，並讓 AppScan 360° 成為受信任的憑證。若無受信任的憑證，用戶端之間的通訊和 AppScan 360° 將不受信任；用戶端可以將憑證匯入至用戶端的 JRE 金鑰儲存庫。然而，此選項可能無法適用於從 AppScan 360° 自動下載 Static Analyzer 指令行公用程式 (SAClientUtil) 的靜態分析用戶端（例如 Azure 外掛程式）。

儲存體

AppScan 360° 使用兩種類型的儲存體。需要的儲存空間主要取決於掃描次數和接受掃描的應用程式大小。作為一項準則，執行單一掃描所需的平均儲存空間大小為：

MSSQL 伺服器 DB 儲存體：150 KB
檔案儲存體：10 MB

每次掃描執行次數的預估儲存空間：


掃描執行	1,000	100,000	1,000,000
MSSQL 伺服器儲存體	150 MB	15 GB	150 GB
檔案儲存體	10 GB	1 TB	10 TB

資料庫和檔案儲存體的建議最小儲存容量為各 200 GB，用於暫時儲存日誌。

註：儲存裝置應加密、備援、可在 Pod 之間共用，並支援 RWX (ReadWriteMany) 存取模式。

您可以手動刪除舊掃描以節省空間。

CPU 和記憶體

CPU 和記憶體需求取決於使用者數量和預期的工作量。

依預設，Kubernetes 工作會為每次掃描分配最小資源。在某些情況下，使用者活躍度、自動化程度、應用程式規模和掃描頻率等因素會造成影響，可能需要更多資源來確保掃描正常運行；假設資源可用，Pod 將嘗試擴充到最大定義的資源。如果資源不足以擴充，部分掃描可能會失敗。

為最大化成功，請提供足夠的資源讓系統能夠在需要時擴充。資源分配是從並行掃描的次數衍生而來。

AppScan 360° 平台資源

當僅執行 AppScan 360° 平台時：


		記憶體	CPU (vCore)
ASCP
	最小	42 GB	10
	最大	48 GB	12

註： AppScan 360° 平台資源是恆定的，並且是掃描所需資源之外的其他資源。

掃描資源

執行掃描時，其他資源：


		記憶體	CPU (vCore)
動態分析掃描：單次掃描
	最小	3 GB	2
	建議	4 GB	3
動態分析掃描：五個並行掃描
	最小	15 GB	10
	建議	20 GB	15
動態分析掃描：十個並行掃描
	最小	30 GB	20
	建議	40 GB	30
靜態分析掃描：單次掃描
	最小	16 GB	2
	最大	28 GB	4
靜態分析掃描：五個並行掃描
	最小	80 GB	10
	最大	140 GB	20
靜態分析掃描：十個並行掃描
	最小	160 GB	20
	最大	280 GB	40
軟體組成分析 (SCA) 掃描：單次掃描
	最小	10 GB	4
	建議	20 GB	10
軟體組成分析 (SCA) 掃描：五個並行掃描
	最小	50 GB	20
	建議	100 GB	50
軟體組成分析 (SCA) 掃描：十個並行掃描
	最小	100 GB	40
	建議	200Gb	100

若要達到額外並行性，必須有足夠可用其他資源：

將上述單次掃描所需的掃描資源乘以預期並行掃描的數量，然後將其加到 AppScan 360° 平台資源。
例如：
- 五個並行掃描的最小資源需求為 122 GB 記憶體和 20 個 CPU（42 GB 用於 AppScan 360° 平台 + 80 GB 用於掃描，以及 10 個 CPU 用於 AppScan 360° 平台 + 10 個 CPU 用於掃描）。
- 12 個並行掃描的最小資源需求為 234 GB 記憶體和 34 個 CPU（42 GB 用於 AppScan 360° 平台 + 192 GB 用於掃描，以及 10 個 CPU 用於 AppScan 360° 平台 + 24 個 CPU 用於掃描）。
確保 AppScan 360° 平台安裝期間發出的 AppScan 360° 授權數量足夠。
定義 Kubernetes 配置與資源的可用性，以允許同時啟動並執行多個掃描。
我們不建議超過 25 個並行執行。

每項服務的最大數量取決於預期的尖峰掃描負載設定檔，也就是提交的掃描峰值數量、掃描原始碼/二進位的百分比，以及掃描 IRX 的百分比。由於這些不明要素，因此可能無法在初始部署時定義最佳配置。HCL AppScan 360° 配置可根據實際掃描負載進行調整。

註：若要執行掃描，掃描所需的資源應可在單一節點上取得。靜態掃描的建議節點應至少有 28 GB 的 RAM 和四個核心；動態掃描的建議節點應至少有 4 GB 的 RAM，三個核心，以及 200 GB 的磁碟空間，用於暫時儲存日誌。

資料庫

資料庫安裝、管理、備份、維護和授權為使用者的責任。
支援 MSSQL Server 2019 及以上版本。
安裝 HCL AppScan 360° 前，請確認有一位具備 db_creator 許可權的使用者。

瀏覽器

AppScan 360° 支援下列瀏覽器的最新版本：

Chrome
Safari
Edge
Firefox

身分提供者

安裝過程中會建立兩位本端使用者。

	管理員	應用程式管理者
使用者名稱	管理員	使用者
密碼	Admin12!	User123!

若要加入其他使用者，HCL AppScan 360° 需要 Microsoft Active Directory。

螢幕解析度

HCL AppScan 360° 的建議畫面解析度為 1920 x 1080。

存取點

元件	輸入 URL
使用者入口網站	`https://<CK_CONFIGURATION_DISCLOSED_SITE_URL>`
使用者 API	`https://<CK_CONFIGURATION_DISCLOSED_SITE_URL>/api`
使用者 API (swagger)	`https://<CK_CONFIGURATION_DISCLOSED_SITE_URL>/swagger`

註：需要連同 DNS 伺服器中的輸入指定 IP 一起發佈輸入 FQDN。