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

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

sudo ./AppScan360_SingleVMsetup_v2.1.0.run -- $PWD prepareCertsFolders

cd ~/aio-setup
sudo ./AppScan360_SingleVMsetup_v2.1.0.run -- $PWD

cd aioWorkspace
./disengageAS360-AIO.sh

Please select your installation path:
1. 🚀  Express Mode (POC)
2. 🛠️  Custom Mode (Production)
Enter 1 or 2 [Default: 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.
• 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: AppScanCloudDB]:

• 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 ID):
    > SCA Registry Password/Token:
    > SCA Helm Repository Path [Default:appscan360/as360-k8s-helm-packages]:

  • Remarque : Utilisez votre ID et votre mot de passe/jeton pour activer les mises à jour automatiques de la base de données des vulnérabilités SCA. Votre système doit être connecté à Internet pour les mises à jour automatiques.

    🔗 Network Configuration
    > 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.

  > 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.

  > 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.

    > 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 200 Go.
  • 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.

    > 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 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.
• Sélectionnez si le DPR local doit être configuré, si aucun DPR externe n'a pu être introduit

  > Do you want the kit to install and manage a local Docker Private 
  Registry (DPR) on this VM? (y/n) [Default: n]:

• Si o est sélectionné, les requêtes docker supplémentaires seront ignorées et les valeurs par défaut seront définies pour elles. Si n est sélectionné, saisissez les détails DPR, car des questions supplémentaires vont suivre
  • Configuration du registre Docker :

    🐳 Docker Registry Configuration
    > 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]:

    🔄 Proxy Service Configuration
    > Do you want to use a proxy service? (y/n) [Default: n]:

  • o : Configurez un service proxy.

    > What is the proxy host?

    > What is the proxy port?

    > Does the proxy require user/password credentials? (y/n):

    > What is the proxy username?:

    > What is the proxy password?:

  • n : Ignorez la configuration du proxy.

✅ 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]

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

Vérifiez que les informations sont correctes et saisissez o pour continuer. Si elles sont incorrectes ou à modifier, saisissez n et appuyez sur Entrée

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