前提条件セットアップ・ガイド

はじめに

このドキュメントでは、HCL AppScan 360° の導入、配置サーバー、Kubernetes クラスター、外部依存関係、およびリソース要件を網羅するための前提条件の包括的なチェックリストについて説明します。

配置サーバーの前提条件

配置サーバーは、AppScan 360° 配置の開始と管理に使用される Linux ベースのシステムです。

カテゴリー 要件
オペレーティング・システム Ubuntu 22.04/Ubuntu 24.04/RHEL 9
ソフトウェア
  • Bash シェル - インストール・スクリプトの実行に必要
  • Docker - Ubuntu 上のローカル・コンテナー・サービス用 (「Docker のインストール」を参照)
  • Podman - RHEL (プリインストールされていることが多い) 上のローカル・コンテナー・サービス用
  • Kubectl - Kubernetes クラスター管理用 (「Kubectl のインストール」を参照)
  • Helm 4 - チャート配置用 (「Helm のインストール」を参照）
注:

新規インストールおよび概念実証 (POC) の場合は、インストールを開始する前にホストのタイムゾーンが UTC に設定されていることを確認してください。

ホストがローカル・タイムゾーンに設定されている場合、証明書が UTC と同期するまで、配置後の短期間スキャンの実行が失敗することがあります

。

Kubernetes クラスターの前提条件 (分散環境の場合)

  • One Click Installer または Helm Based Installer を使用してインストールする場合は、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
    Storage class (ストレージ・クラス) kubectl get storageclass
    永続ボリューム kubectl get pv
    SQL 接続 ping <MSSQL_SERVER_IP>
    コンテナー・レジストリーへのログイン docker login <PRIVATE_REGISTRY_URL>
  • AppScan 360° セットアップ・アシスタントを利用して、配置前の構成パラメーターと接続性のインタラクティブな検証を行います。

外部依存関係

AppScan 360° 構成およびアクセス可能な外部サービスに依存します。
カテゴリー 要件
データベース

db_creator 権限を持つ、MSSQL Server 2019 以上。スキャン実行あたり約 150 KB のストレージ。
認証 ポート 389/636/TCP 経由の OIDC (Keycloak/Okta) または LDAP (Microsoft Active Directory/Domino) 経由のSSO
電子メール 通知用ポート 25/TCP 経由の SMTP サーバー
ライセンス交付 ポート 443/TCP 経由の HCL ライセンス管理ポータル (HCL ID が必要)
コンテナーレジストリー AppScan 360° コンテナー・イメージを格納および取得するためのリモート・コンテナー・レジストリー
ネットワーク 信頼できる証明書による安全な通信 (必要に応じて信頼できない証明書をクライアント JRE キーストアにインポート)
ストレージ スキャンデータのファイルストレージ (「ストレージ要件」を参照)
HCL Harbor SCA スキャンのための最新の問題カタログと脆弱性データを維持するため

その他の注意事項

  • HCL ID - HCL ライセンス、ダウンロード・ポータル、HCL Harbor へのアクセスに必要

  • ブラウザーのサポート - AppScan 360° のユーザー・インターフェｰスには、Chrome、Safari、Edge、Firefox の最新バージョンを使用してください

  • 画面解像度 - 最適な表示を実現するために、推奨解像度は 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!