Installation personnalisée d'AppScan 360° sur une seule machine virtuelle

Le script de configuration d'AppScan 360° sur une seule machine virtuelle pose une série de questions pour configurer votre environnement. Vérifiez les informations de configuration dans la section Configuration d'un environnement à une seule machine virtuelle et rassemblez les données nécessaires pour finaliser l'installation.

mv AppScan360_v2.0.0.run ascp-AppScan360_v2.0.0.run
mv AppScan360_v2.0.0.run asra-AppScan360_ASRA_v2.0.0.run
mv AppScan360_SCA_v2.0.0.run sca-AppScan360_SCA_v2.0.0.run # (Optional)

mkdir -p ~/aio-setup
mv *.run ~/aio-setup/

./AppScan360_SingleVMsetup_v2.0.0_Online.gz.run -- $PWD prepareCertsFolders

cd ~/aio-setup
./AppScan360_SingleVMsetup_v2.0.0_Online.gz.run -- $PWD

1. > Will this production deployment include Software Composition Analysis (SCA)? This requires license. (y/n) [Default: n]:

   La valeur par défaut est n.

   • o : Incluez le composant d'analyse de la composition logicielle (SCA) dans votre installation. L'analyse SCA vous permet d'analyser les applications pour détecter les vulnérabilités des composants Open Source.
   • n : N'incluez pas le composant d'analyse de la composition logicielle (SCA) dans votre installation.

2. > To ensure system stability, we strongly recommend validating your server's hardware against your expected workload. This helps prevent scan failures and performance issues after installation. Do you want to perform this resource check now? (y/n) [Default: y]:

   La valeur par défaut est o.

   • o : Validez les ressources matérielles par rapport à votre charge de travail d'examen prévue. Cette opération est recommandée pour les environnements de production.
     Indiquez le nombre attendu d'examens simultanés :

     🖥️ *** Production Workload & Resource Planning ***
     📊 To calculate hardware requirements, please specify the maximum number of scans you expect to run at the same time (concurrently).
     💡 You can enter 0 if a scan type will not be used.
     
     > Enter desired number of concurrent STATIC (SAST) scans [Default: 1]:
     > Enter desired number of concurrent DYNAMIC (DAST) scans [Default: 1]:
     > Enter desired number of concurrent INTERACTIVE (IAST) scans [Default: 1]:

     Si vous avez choisi d'activer l'analyse SCA, indiquez le nombre attendu d'examens SCA simultanés :

     Enter desired number of concurrent SCA scans [Default: 1]:

   • n : Ignorez la validation des ressources.
3. Les installations de production doivent configurer une base de données MSSQL externe. Répondez aux invites au fur et à mesure qu'elles s'affichent.

   • 🛢️ *** Database Configuration ***
     > Enter Database Hostname or IP:

   • > Enter Database Port [Default: 1433]:

   • > Enter Database User for AppScan:

   • > Enter Database User Password:

   • > Enter the name for the main AppScan database [Default: AppScan360DB]:

4. Si vous avez choisi d'inclure l'analyse de la composition logicielle (SCA) dans l'installation :

   • Saisissez le nom de la base de données SCA :

     > Please provide a name for the new SCA database [Default: AppScan360_SCA_DB]:

   • Saisissez le nom de la base de données d'agrégation SCA :

     > Please provide a name for the new SCA Aggregation database [Default: > AppScan360_SCA_Aggregation_DB]:

   • Saisissez les informations de registre pour les mises à jour SCA ou acceptez les valeurs par défaut, le cas échéant :

     > SCA Registry Address [Default: hclcr.io]:
     > SCA Registry Path [Default: appscan360/as360-k8s-docker-images]:
     > SCA Registry Username (typically your HCL ID):
     > SCA Registry Password/Token:

5. > Please enter the primary domain name for this installation. This will be used to create the access URL (e.g., yourcompany.com):

   Il s'agit d'un champ obligatoire sans valeur par défaut. Le nom de domaine spécifié est utilisé pour créer l'URL d'accès de votre instance AppScan 360°. Par exemple, si vous saisissez appscan-test.local, votre URL AppScan 360° sera https://hostname.appscan-test.local.

   Le nom de domaine doit être facile à mémoriser et unique dans votre environnement réseau, et ne doit pas entrer en conflit avec les domaines existants.

6. > Please enter the external domain(s) or IP(s) that this instance will need to access for external services(such as SSO, SMTP, etc.). Separate multiple entries with commas:

   Saisissez tous les domaines ou adresses IP auxquels votre instance AppScan 360° doit se connecter, tels que :

   • Serveurs SMTP pour les notifications par e-mail

   • Fournisseurs d'authentification SSO (LDAP, OIDC)

   • Outils CI/CD externes

   Séparez les différentes entrées par des virgules. Laissez vide si aucun service externe n'est nécessaire.

7. > Is the VM connected with the local DNS server (y/n)? 

   La valeur par défaut est n.

   • o : Votre machine virtuelle est connectée à un serveur DNS. Le système utilise le nom d'hôte pour les configurations liées au réseau.
   • n : Votre machine virtuelle n'est connectée à aucun serveur DNS. Le système utilise les adresses IP directement pour les configurations liées au réseau.

8. > To plan for long-term storage costs, estimate the number of scan results you plan to retain. > Specify the shared storage capacity in GB [Default: 200]:

   Ce stockage est utilisé pour les journaux, les fichiers de configuration, les données persistantes et les journaux d'examen partagés entre les composants. La valeur par défaut est 200GB.

   • Appuyez sur Entrée pour accepter la valeur par défaut, ou
   • Saisissez un numéro différent pour spécifier une valeur de stockage personnalisée, puis appuyez sur Entrée.

9. > Do you want to connect with your SMTP Mail Relay (SMR)(y/n)? 

   La valeur par défaut est n.

   Un relais de messagerie SMTP est un serveur intermédiaire qui accepte les e-mails sortants de votre système et les transfère aux serveurs de messagerie des destinataires. Le relais permet de garantir la transmission des e-mails et peut appliquer certaines règles telles que le filtrage des spams. Dans AppScan 360°, configurez un relais pour recevoir des notifications par e-mail lorsqu'un un examen est terminé, si un examen planifié a été lancé, etc.

   • o : intégrez AppScan 360° avec un relais de messagerie SMTP pour envoyer des e-mails depuis le déploiement. Lorsque vous sélectionnez y, saisissez l'hôte, le port, les informations d'identification et les détails de chiffrement appropriés lorsque le SMR vous invite à finaliser la connexion :

     • > Please enter the SMTP host:

     • > Please enter the SMTP port:

       Le numéro de port est généralement 25, 465 ou 587.

     • > Please enter the SMTP username:

       Si l'authentification est requise.

     • Please enter the SMTP password:

       Si l'authentification est requise.

     • > Does your SMTP server use SSL/TLS? If yes, a certificate is required to be present in certs/smtp folder (y/n)?

   • n : aucun serveur SMTP n'est configuré ; les utilisateurs ne peuvent pas recevoir de notifications par e-mail associées.

• > What is the external Docker Private Registry (DPR) address (FQDN:PORT)?

• > What is the external Docker Private Registry (DPR) username?

  Si l'authentification est requise

• > What is the external Docker Private Registry (DPR) password?

  Si l'authentification est requise

• 🐳 Docker registry and Helm repository context names are used to set the context for docker images and helm charts.
  💡 To set these to an empty string(root repository), type EMPTY
  ------------------------------------------------------------------------------------------------
  > What is the docker registry context/repository name [Default: as360-k8s-docker-images]:

• > What is the helm repository context/repository name [Default: as360-k8s-helm-packages]:

✅ Summary of your choices:
  Installation Mode: Custom (Production)
  Install SCA Kit: [y/n]
  Domain: [your domain]
  Connected to Local DNS: [y/n]
  Storage Size: [size]GB
  Use SMTP Mail Relay: [y/n]
  Docker Private Registry Address: [address]
  Scan Concurrency: SAST=[n], DAST=[n], IAST=[n], SCA=[n]
  MSSQL Host: [host], Port: [port], DB: [database]
  [Additional configuration details...]

> Continue with installation? (y/n) [Default: y]:

Vérifiez que les informations sont correctes et saisissez o.

The AS360 Single VM was installed, to access it do the following:
  1. Add to your 'hosts' file the following line: [IP_ADDRESS] [HOSTNAME].[DOMAIN]
  2. Access https://[HOSTNAME].[DOMAIN] in your browser