先決條件安裝指南

介紹

本文件提供部署 HCL AppScan 360° 所需的完整先決條件核對清單，其中包括部署伺服器、Kubernetes 叢集、外部相依關係和資源需求。

部署伺服器先決條件

部署伺服器是基於 Linux 的系統，用於啟動和管理 AppScan 360° 部署。

類別 需求
作業系統 Ubuntu 22.04 / Ubuntu 24.04 / RHEL 9
軟體
  • Bash shell - 執行安裝指令碼時所需
  • Docker - 用於 Ubuntu 上的本端儲存器服務（請參閱 Docker 安裝）
  • Podman - 用於 RHEL 上的本端儲存器服務（通常已預先安裝）
  • Kubectl - 用於 Kubernetes 叢集管理，（請參閱 Kubectl 安裝）
  • Helm 4 - 用於圖表部署（請參閱 Helm 安裝）
註：

對於全新安裝和概念驗證 (POC)，在開始安裝之前，請務必將主機時區設定爲 UTC。

如果主機設定為本端時區，在部署後的短時間內，掃描執行可能會失敗，直到憑證與 UTC 同步為止

。

Kubernetes 叢集先決條件（用於分散式環境）

  • 對於使用一鍵式安裝程式或以 Helm 為基礎的安裝程式進行安裝，必須配備 Kubernetes 叢集。為確保 AppScan 360° 平台的相容性與最佳效能，該叢集必須滿足以下先決條件。

  • Kubernetes 叢集負責託管 AppScan 360° 平台，並需要特定的元件和配置。

類別 需求
元件

  • 閘道控制器（符合 Gateway API v1.4.0 規範）

  • Cert-manager（符合 v1.11.0 規範）
儲存體

  • 具有 ReadWriteMany (RWX) 存取模式的儲存類別

  • 支援 fsGroup 安全環境定義的 Kubernetes CSI 驅動程式
網路

  • 雙協定 IPv4/IPv6（如果需要 IPv6）

  • 支援加密通訊的網路原則
工作者節點
  • 請確保有足夠的資源可用於動態和靜態掃描（請參閱資源需求）
參照
註： 對於動態掃描，在所有執行動態掃描的節點中增加核心中的 inotify 執行個體數量：

  • 將 fs.inotify.max_user_instances=524288 新增至 /etc/sysctl.conf。

  • 重新啟動節點，讓變更生效。

  • 對於較小的叢集，32800 可能已足夠，但建議使用 524288 以支援穩定的動態掃描。

驗證配置

  • 使用以下指令驗證先決條件：
    檢查 指令
    Kubernetes 連線能力 kubectl version
    Docker 連線能力 docker version
    Helm 連線能力 helm version
    Cert-Manager kubectl get pods --namespace cert-manager
    閘道連線能力 kubectl get gatewayclass
    儲存類別 kubectl get storageclass
    持續性磁碟區 kubectl get pv
    SQL Connectivity ping <MSSQL_SERVER_IP>
    儲存器登錄登入 docker login <PRIVATE_REGISTRY_URL>
  • 在部署之前，利用 AppScan 360° Setup Assistant 對配置參數和連線能力進行交互式驗證。

外部相依關係

AppScan 360° 依賴必須進行配置且可存取的外部服務。
類別 需求
資料庫

MSSQL Server 2019 或更新版本，並具備 db_creator 權限。每次掃描執行約需 150 KB 儲存空間。
鑑別 SSO 透過 OIDC (Keycloak / Okta) 或 LDAP (Microsoft Active Directory / Domino) 透過埠 389/636/TCP
電子郵件 SMTP 伺服器透過埠 25/TCP 使用傳送通知
授權 HCL 授權管理入口網站透過埠 443/TCP（需要HCL ID）
儲存器登錄 用於儲存和提取 AppScan 360° 儲存器映像的遠端儲存器登錄
網路 用於安全通訊的受信任憑證（如有需要，可將不受信任的憑證匯入用戶端 JRE 金鑰儲存庫）
儲存體 用於掃描資料的檔案儲存體（請參閱儲存體需求）
HCL Harbor 用於維護 SCA 掃描的最新問題型錄和漏洞資料

其他注意事項

  • HCL ID - 必要項目，用於存取 HCL 授權與下載入口網站和 HCL Harbor。

  • 瀏覽器支援 - 使用最新版的 Chrome、Safari、Edge 或 Firefox，以存取 AppScan 360° 使用者介面。

  • 螢幕解析度 - 建議解析度為 1920x1080，以獲得最佳顯示效果。

  • DNS - 需要連同 DNS 伺服器中的指定 IP 一起發佈 FQDN。

網路埠：

  • 22/TCP - 透過 SSH 連線至部署伺服器

  • 25/TCP - SMTP

  • 389/TCP - LDAP

  • 80, 443, 8080/TCP - Web 存取

  • 5443,6443,7443,8443/TCP - 僅限單一 VM 設定時需要。

存取點：

  • 使用者入口網站：https://<CK_CONFIGURATION_DISCLOSED_SITE_URL>
  • 使用者 API：https://<CK_CONFIGURATION_DISCLOSED_SITE_URL>/api
  • 使用者 API (Swagger)：https://<CK_CONFIGURATION_DISCLOSED_SITE_URL>/swagger

預設本端使用者：

  • 管理員 — 密碼：Admin12!

  • 使用者 — 密碼：User123!