Configuration d'un environnement à une seule machine virtuelle

Avant de procéder à l'installation de AppScan 360° à l'aide du script de machine virtuelle unique, configurez votre environnement pour un déploiement optimal.

L'environnement dans lequel vous installez et déployez AppScan 360° nécessite la mise en place d'outils préalables pour des performances optimales :

Important : AppScan 360° ne valide pas les prérequis dans le cadre du processus d'installation.

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 :
  1. Ajoutez fs.inotify.max_user_instances=524288 à /etc/sysctl.conf.
  2. 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°.

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.

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.

Résolution d'écran

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

Informations complémentaires

Le script de configuration d'une machine virtuelle unique AppScan 360° pose une série de questions pour configurer votre environnement. Préparez-vous à répondre aux questions à l'aide des informations suivantes :
  • Cette installation a-t-elle été conçue comme une démonstration de faisabilité d'une installation d'AppScan 360° ? Ou cette installation sera-t-elle utilisée pour la production ?
  • Combien d'examens simultanés prévoyez-vous d'exécuter ? (Installation personnalisée)
  • Voulez-vous activer l'analyse de la composition logicielle (SCA) pour le balayage Open Source ?
  • Quels sont les détails de votre configuration MSSQL ? (Installation personnalisée)
  • Quels sont les détails de votre base de données SCA ? (Installation personnalisée)
  • L'installation utilisera-t-elle un certificat externe ?
  • Quel est le nom de domaine principal de l'installation ?
  • L'installation aura-t-elle accès aux services externes ?
  • La machine virtuelle locale est-elle connectée au serveur DNS local ?
  • Quelle quantité de stockage sera allouée à l'installation ?
  • Voulez-vous vous connecter à votre relais de messagerie SMTP ?
  • Quels sont les détails de votre registre Docker ? (Installation personnalisée)
  • L'installation utilisera-t-elle un proxy ? (Installation personnalisée)