Configuration de l'environnement distribué AppScan 360°

ID HCL

Votre ID HCL associe votre compte à des licences valides et à un accès aux logiciels et au support. Il est nécessaire pour accéder au portail de licence et de téléchargement HCL et à HCL Harbor.

Pour obtenir des informations complètes sur la création d'un ID HCL et l'accès aux licences et aux logiciels, consultez ce document.

Système Linux

Un système Linux Ubuntu, version 24.04 ou ultérieure, est nécessaire pour lancer le déploiement. Le déploiement réel peut se faire dans un cluster Kubernetes distant, mais le déploiement est lancé depuis cette machine Linux. Bash shell et openssl doivent être installés sur le système, qui doit être en mesure de se connecter au serveur SQL désigné.

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.

Service de conteneur local (Docker)

Docker est un service de conteneur local qui peut envoyer des images vers un registre distant. Docker est requis lors de l'installation de la plateforme AppScan 360° et de Conseils de résolution AppScan à partir d'un fichier d'archive téléchargé depuis le portail de licence et de téléchargement HCL.

Kubectl

Kubectl est utilisé pour communiquer avec les clusters Kubernetes distants.

Des instructions complètes pour l'installation et la configuration de Kubectl sont disponibles ici.

Helm 3

Helm 3 est un ensemble de ressources qui facilite la configuration et l'utilisation des applications Kubernetes.

Les instructions complètes d'installation de l'interface de ligne de commande Helm sont disponibles ici.

Remarque : Les versions 3.14 à 3.17 de Helm sont validées pour fonctionner avec AppScan 360°.

Vérifier la communication entre Linux et les services de composants

Pour valider la connectivité Kubernetes, exécutez :

> kubectl version

ou

> kubectl get nodes

Pour valider la connectivité Docker, exécutez :

> docker version

Pour valider la connectivité Helm, exécutez :

> helm version

Cluster Kubernetes

Le cluster se trouve à l'emplacement où résident les conteneurs d'agent de la plateforme AppScan 360° et où ils sont utilisés.

Un fournisseur de stockage prenant en charge ReadWriteMany est requis. Si un fournisseur de stockage personnalisé comme longhorn doit être utilisé, assurez-vous qu'il prend en charge `ReadWriteMany.

En outre, pour garantir des autorisations de fichier et une sécurité appropriées pour les pods accédant à des volumes persistants, le pilote Kubernetes CSI doit prendre en charge le contexte de sécurité fsGroup.

Remarque : Si et uniquement si IPv6 est nécessaire pour votre utilisation de AppScan 360°, la distribution Kubernetes doit avoir la double pile IPv4/IPv6 activée.

Contrôleur d'ingress

Déployez un contrôleur d'ingress qui prend en charge le protocole HTTPS.

Le contrôleur d'ingress recommandé est NGINX (version 1.11.5 ou 1.12.1 ou ultérieure). Cependant, si un contrôleur d'ingress est déjà présent dans le cluster, il n'est pas nécessaire d'en installer un nouveau.

Le contrôleur doit satisfaire les exigences suivantes :

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

Cert-manager

Installez et configurez Cert-manager.

serveur de mesures

Source évolutive et efficace de mesures de ressources de conteneur pour les pipelines d'évolutivité automatique intégrés Kubernetes.

MSSQL

MSSQL est un système de gestion de bases de données relationnelles.

SSO (LDAP Active Directory/Open ID Connect)

Active Directory authentifie et autorise tous les utilisateurs et ordinateurs d'un réseau, en définissant et en appliquant des politiques de sécurité pour l'accès au réseau.

Open ID Connect est une couche d'authentification au-dessus d'OAuth 2.0. Elle permet aux clients de vérifier l'identité de l'utilisateur final basée sur l'authentification effectuée par un serveur d'autorisation et d'obtenir des informations de profil de base sur l'utilisateur final de manière interopérable et similaire à REST.

Important : Lors de la mise à niveau à partir de AppScan 360° version 1.1.0 ou antérieure, la configuration LDAP ne peut pas être utilisée à nouveau telle quelle. Vous devez vérifier que tous les paramètres LDAP répondent aux exigences actuelles/mises à jour de AppScan 360° avant de procéder à l'installation.

Réseau

Le réseau doit être chiffré et prendre en charge la stratégie du réseau.

Important : Nous recommandons vivement que le certificat installé pour la communication entre le client et AppScan 360° soit un certificat de confiance. En l'absence de certificat reconnu, la communication entre le client et AppScan 360° sera non fiable ; les clients peuvent importer le certificat dans le magasin de clés JRE du client. Cependant, cette option peut ne pas fonctionner pour les clients d'analyse statique (comme un plug-in Azure) qui téléchargent Utilitaire de ligne de commande Static Analyzer (SAClientUtil) à partir de AppScan 360° automatiquement.

Stockage

AppScan 360° utilise deux types de stockage. L'espace de stockage nécessaire dépend largement du nombre d'examens et de la taille de l'application examinée. A titre indicatif, la taille moyenne de stockage requise pour l'exécution d'un seul examen correspond à ce qui suit :

Stockage de la base de données du serveur MSSQL : 150 KB
Stockage de fichiers : 10 Mo

Stockage estimé par nombre d'exécutions d'examen :


Exécutions d'examen	1 000	100 000	1 000 000
Stockage sur serveur MSSQL	150 Mo	15 Go	150 GB
Stockage de fichiers	10 Go	1 To	10 TB

La taille minimale recommandée pour la base de données et le stockage des fichiers est de 200 Go chacun pour le stockage temporaire des journaux.

Remarque : Le stockage doit être chiffré, redondant, partageable entre les pods et prendre en charge le mode d'accès RWX (ReadWriteMany).

Vous pouvez supprimer manuellement les précédents examens pour gagner de l'espace.

UC et mémoire

Les besoins en UC et en mémoire dépendent du nombre d'utilisateurs et de la charge de travail prévue.

Par défaut, la tâche Kubernetes alloue les ressources minimales pour chaque examen. Dans certains cas, en fonction de facteurs tels que le niveau d'activité des utilisateurs, le degré d'automatisation, la taille de l'application et la fréquence des examens, davantage de ressources peuvent être nécessaires pour que l'examen s'exécute correctement ; si les ressources sont disponibles, le module essaiera de s'adapter aux ressources maximales définies. S'il n'y a pas suffisamment de ressources pour évoluer, certains examens peuvent échouer.

Pour des résultats optimaux, fournissez suffisamment de ressources pour que le système puisse évoluer en fonction des besoins. L'allocation des ressources est fonction du nombre d'examens simultanés.

AppScan 360° ressources de plateforme

Lors de l'exécution de la plateforme AppScan 360° uniquement :


		Mémoire	UC (vCore)
ASCP
	Minimum	42 GB	10
	Maximum	48 Go	12

Remarque : Les ressources de la plateforme AppScan 360° sont constantes et viennent s'ajouter aux ressources nécessaires au balayage.

Recherche de ressources

Lors de l'exécution d'examens, ressources supplémentaires :


		Mémoire	UC (vCore)
Analyse dynamique : examen unique
	Minimum	3 Go	2
	Recommandé	4 Go	3
Analyse dynamique : cinq examens simultanés
	Minimum	15 Go	10
	Recommandé	20 Go	15
Analyse dynamique : dix examens simultanés
	Minimum	30 Go	20
	Recommandé	40 Go	30
Analyse statique : examen unique
	Minimum	16 Go	2
	Maximum	28 GB	4
Analyse statique : cinq examens simultanés
	Minimum	80 Go	10
	Maximum	140 Go	20
Analyse statique : dix examens simultanés
	Minimum	160 GB	20
	Maximum	280 GB	40
Analyse de la composition logicielle (SCA) : examen unique
	Minimum	10 GB	4
	Recommandé	20 Go	10
Analyse de la composition logicielle (SCA) : cinq examens simultanés
	Minimum	50 GB	20
	Recommandé	100 GB	50
Analyse de la composition logicielle (SCA) : dix examens simultanés
	Minimum	100 GB	40
	Recommandé	200Gb	100

Pour obtenir une plus grande simultanéité, il faut disposer de ressources supplémentaires suffisantes :

Multipliez les ressources de balayage énumérées ci-dessus pour une analyse unique par le nombre d'examens simultanés prévus, et ajoutez-les aux ressources de la plateforme AppScan 360°.
Exemple :
- Les ressources minimales pour cinq examens simultanés seraient de 122 Go de mémoire et 20 UC (42 Go pour la plateforme AppScan 360° + 80 Go pour le balayage et 10 UC pour la plateforme AppScan 360° + 10 UC pour le balayage).
- Les ressources minimales pour 12 examens simultanés seraient de 234 Go de mémoire et 34 UC (42 Go pour la plateforme AppScan 360° + 192 Go pour le balayage et 10 UC pour la plateforme AppScan 360° + 24 UC pour le balayage).
Assurez-vous qu'un nombre suffisant de licences AppScan 360° est fourni lors de l'installation de la plateforme AppScan 360°.
Définissez la configuration de Kubernetes et la disponibilité des ressources pour permettre à plusieurs examens d'être opérationnels en même temps.
Nous vous recommandons de ne pas dépasser 25 examens simultanés.

Le nombre maximal de chaque service dépend du profil de charge d'examen maximal attendu, c'est-à-dire du nombre maximal d'examens soumis, du pourcentage d'examen de code source/fichiers binaires et du pourcentage d'examen de fichiers IRX. En raison de ces inconnues, il est possible que la configuration optimale ne puisse pas être définie lors du déploiement initial. La configuration HCL AppScan 360° peut être ajustée en fonction de la charge de l'examen réelle.

Remarque : Pour effectuer un examen, les ressources requises doivent être disponibles sur un seul nœud. Les nœuds recommandés pour un examen statique doivent disposer d'au moins 28 Go de RAM et de quatre cœurs. Les nœuds recommandés pour un examen dynamique doivent disposer d'au moins 4 Go de RAM, trois cœurs et 200 Go d'espace disque pour le stockage temporaire des journaux.

Base de données

L'installation, la gestion, la sauvegarde, la maintenance et l'octroi de licence de la base de données relèvent de la responsabilité de l'utilisateur.
MSSQL Server 2019 et versions ultérieures sont pris en charge.
Avant d'installer HCL AppScan 360°, assurez-vous de disposer d'un utilisateur doté des droits db_creator.

Navigateur

AppScan 360° prend en charge les dernières versions des navigateurs suivants :

Chrome
Safari
Edge
Firefox

Fournisseur d'identité

Deux utilisateurs locaux sont créés lors du processus d'installation.

	Administrateur	Gestionnaire d'applications
Nom d'utilisateur	Admin	User
Mot de passe	Admin12!	User123!

Pour intégrer d'autres utilisateurs, HCL AppScan 360° requiert Microsoft Active Directory.

Résolution d'écran

La résolution d'écran recommandée pour HCL AppScan 360° est de 1920 x 1080.

Points d'accès

Composant	URL Ingress
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`

Remarque : La publication du FQDN Ingress avec l'IP désignée de l'Ingress dans le serveur DNS est nécessaire.