Guide des conditions préalables

Introduction

Ce document fournit une liste de contrôle complète des conditions préalables au déploiement de HCL AppScan 360°, couvrant le serveur de déploiement, le cluster Kubernetes, les dépendances externes et les ressources requises.

Conditions préalables du serveur de déploiement

Le serveur de déploiement est un système basé sur Linux utilisé pour lancer et gérer le déploiement de AppScan 360°.

Catégorie Exigence
Système d'exploitation Ubuntu 22.04/Ubuntu 24.04/RHEL 9
Logiciel
  • Shell bash : requis pour l'exécution des scripts d'installation
  • Docker : pour le service de conteneur local sur Ubuntu (voir Installation de Docker)
  • Podman : pour le service de conteneur local sur RHEL (souvent préinstallé)
  • Kubectl : pour la gestion des clusters Kubernetes (voir Installation de Kubectl)
  • Helm 4 : pour les déploiements de graphiques (voir Installation de Helm)
Remarque :

Pour les nouvelles installations et les démonstrations de faisabilité (POC), assurez-vous que le fuseau horaire de l'hôte est défini sur UTC avant de démarrer l'installation.

Si l'hôte est défini sur un fuseau horaire local, l'exécution de l'examen peut échouer pendant une courte période après le déploiement jusqu'à ce que les certificats se synchronisent avec le fuseau UTC

.

Conditions préalables relatives aux clusters Kubernetes (environnement distribué)

  • Pour les installations utilisant One Click installer ou le programme d'installation basé sur Helm, un cluster Kubernetes est requis. Le cluster doit satisfaire aux conditions préalables suivantes pour garantir la compatibilité et les performances optimales de la plateforme AppScan 360°.

  • Le cluster Kubernetes héberge la plateforme AppScan 360° et nécessite des composants ainsi que des configurations spécifiques.

Catégorie Exigence
Composants

  • Contrôleur de passerelle (compatible API de passerelle v1.4.0)

  • CERT-manager (v1.11.0 ou autre version compatible)
Stockage

  • Classe de stockage avec mode d'accès ReadWriteMany (RWX)

  • Pilote Kubernetes CSI avec prise en charge du contexte de sécurité fsGroup
Gestion de réseau

  • Double pile IPv4/IPv6 (si IPv6 est nécessaire)

  • Prise en charge de la stratégie réseau pour les communications chiffrées
Nœuds worker
  • Assurez-vous que les ressources sont suffisantes pour l'examen dynamique et statique (voir Ressources requises)
Références
Remarque : Pour le balayage dynamique, augmentez le nombre d'instances inotify dans le noyau dans tous les nœuds où les examens dynamiques sont exécutés :

  • Ajoutez fs.inotify.max_user_instances=524288 à /etc/sysctl.conf .

  • Redémarrez le nœud pour que les modifications soient prises en compte.

  • Pour les clusters plus petits, 32800 peut suffire, mais 524288 est recommandé pour un examen dynamique robuste.

Valider la configuration

  • Vérifiez les conditions préalables à l'aide des commandes suivantes :
    Vérification Commande
    Connectivité Kubernetes kubectl version
    Connectivité Docker docker version
    Connectivité Helm helm version
    Cert-Manager kubectl get pods --namespace cert-manager
    Connectivité passerelle kubectl get gatewayclass
    Classe de stockage kubectl get storageclass
    Volumes persistants kubectl get pv
    Connectivité SQL ping <MSSQL_SERVER_IP>
    Connexion au registre de conteneur docker login <PRIVATE_REGISTRY_URL>
  • Utilisez AppScan 360° Setup Assistant pour la validation interactive des paramètres de configuration et de la connectivité avant le déploiement.

Dépendances externes

AppScan 360° s'appuie sur des services externes qui doivent être configurés et accessibles.
Catégorie Exigence
Base de données

MSSQL Server 2019 ou version supérieure, configuré avec des droits db_creator. Environ 150 Ko de stockage par exécution d'examen.
Authentification SSO via OIDC (Keycloak/Okta) OU LDAP (Microsoft Active Directory/Domino) via le port 389/636/TCP
E-mail Serveur SMTP via le port 25/TCP pour les notifications
Octroi des licences Portail de gestion des licences HCL via le port 443/TCP (ID HCL requis)
Registre de conteneur Registre de conteneur distant pour le stockage et l'extraction d'images de conteneur AppScan 360°
Réseau Certificat approuvé pour une communication sécurisée (importer les certificats non approuvés dans le magasin de clés JRE du client, si nécessaire)
Stockage Stockage de fichiers pour les données d'examen (voir Exigences de stockage)
HCL Harbor Pour maintenir à jour le catalogue des problèmes et les données de vulnérabilité pour les examens SCA

Notes supplémentaires

  • ID HCL : nécessaire pour accéder au portail de licence et de téléchargement HCL et à HCL Harbor

  • Navigateurs pris en charge : utiliser les dernières versions de Chrome, Safari, Edge ou Firefox pour l'interface utilisateur d'AppScan 360°

  • Résolution d'écran : la résolution recommandée est de 1920 x 1080 pour un affichage optimal

  • DNS : publier le nom de domaine complet avec l'adresse IP désignée dans le serveur DNS

Ports réseau :

  • 22/TCP : SSH vers le serveur de déploiement

  • 25/TCP : SMTP

  • 389/TCP : lDAP

  • 80, 443, 8080/TCP : accès Web

  • 5443,6443,7443,8443/TCP : ports supplémentaires requis uniquement pour la configuration d'une machine virtuelle unique.

Points d'accès :

  • Portail utilisateur : https://<CK_CONFIGURATION_DISCLOSED_SITE_URL>
  • API utilisateur : https://<CK_CONFIGURATION_DISCLOSED_SITE_URL>/api
  • API utilisateur (Swagger) : https://<CK_CONFIGURATION_DISCLOSED_SITE_URL>/swagger

Utilisateurs locaux par défaut :

  • Administrateur, mot de passe Admin12!

  • Utilisateur, mot de passe User123!