Installation rapide d'AppScan 360° sur une seule machine virtuelle

Le mode Express est destiné aux évaluations pour démonstration de faisabilité (POC) dans une configuration de machine virtuelle unique. Il fournit un chemin d'installation guidé avec moins de décisions que le mode personnalisé.

💡 Pratique recommandée : Exécutez AppScan 360 Setup Assistant avant chaque nouvelle installation ou mise à niveau majeure.

Remarques importantes :

  1. Effectuez toutes les activités d'installation et de configuration en tant qu'administrateur sur le système cible.

  2. Le script de configuration pose des questions spécifiques à l'environnement. Vérifiez le Guide des conditions préalables et préparez les valeurs requises avant de commencer.

  3. Le mode Express est destiné aux scénarios d'évaluation. Pour le déploiement de production et la planification de la mise à niveau, utilisez les conseils personnalisés/de production.

Préparer les fichiers d'installation

  1. Téléchargez le kit de configuration de machine virtuelle unique et les kits AppScan requis depuis le portail MyHCLSoftware dans un répertoire unique. Par exemple, /home/username/AppScan360_singleVM.
    Conservez tous les fichiers du kit d'installation dans le même répertoire. Fichiers de kit types :
    • AppScan360_SingleVMsetup_v<version>.run
    • AppScan360_v<version>.run
    • AppScan360_ASRA_v<version>.run
    • AppScan360_DTCS_v<version>.run (obligatoire pour les fonctions de modèle DAST)
    • AppScan360_SCA_v<version>.run (Facultatif)
  2. Déplacez tous les kits dans un dossier de travail et rendez-les exécutables.
    mkdir -p ~/aio-setup
    mv *.run ~/aio-setup/
    cd ~/aio-setup
    chmod +x *.run

Placer des certificats (facultatif)

  1. Si vous utilisez des certificats personnalisés ou auto-signés pour des services tels que SSO (LDAP, OIDC) ou SMTP, créez d'abord un dossier de certificats.
    sudo ./AppScan360_SingleVMsetup_v<version>.run -- $PWD prepareCertsFolders
    La commande crée la structure de dossiers suivante :
    Dossier Fonction
    ~/aio-setup/certs/ Dossier de certificats principal
    ~/aio-setup/certs/docker/ Certificats de registre Docker (généralement non requis pour l'installation express/PoC)
    ~/aio-setup/certs/ldap/ Certificats LDAP (LDAPS)
    ~/aio-setup/certs/smtp/ Certificats SMTP (SMTPS)
    ~/aio-setup/certs/oidc/ Certificats OIDC
    ~/aio-setup/certs/otel/ Certificats Open Telemetry (utilisés lorsque le collecteur est signé par une autorité de certification privée)
    ~/aio-setup/certs/ingress/ Certificats d'accès/de domaine d'application (facultatifs ; les certificats auto-signés sont générés s'ils ne sont pas fournis)
  2. Une fois les dossiers créés, placez les fichiers de certificat dans les chemins appropriés.

Exécuter une installation

  1. Démarrer l'installation :
    cd ~/aio-setup
    sudo ./AppScan360_SingleVMsetup_v<version>.run -- $PWD
    Pour arrêter et nettoyer une installation interrompue :
    cd aioWorkspace
    ./disengageAS360-AIO.sh
    Les fichiers journaux d'installation sont écrits à l'emplacement ./aioWorkspace/logs.
  2. Sélectionnez Mode express (POC) lorsque vous y êtes invité :
    Please select your installation path:
    1. 🚀  Express Mode (POC)
    2. 🛠️  Custom Mode (Production)
    Enter 1 or 2 [Default: 1]:
  3. Remplissez le questionnaire Mode express (POC).

    Invites principales dans le Mode express (POC).

    • Section de l'analyse de la composition logicielle (SCA) en option :
      Do you want to install the optional SCA kit for this evaluation? (y/n) [Default: n]:
    • Domaine principal (utilisé pour générer l'URL d'accès final) :

      Please enter the primary domain name for this instance. This will be used to create the access URL.(e.g., appscan-test.local):
    • Domaines externes ou adresses IP nécessaires pour l'accès sortant (par exemple, SSO ou nœud finaux SMTP) :
      Provide the external domain(s) or IP address(es) this instance must access for external services (e.g., SSO, SMTP). Use commas to separate multiple values. If none, press Enter to skip:
    • Connectivité DNS locale :

      Is the VM connected to a local DNS server? (y/n) [Default: n]: 
    • Taille du stockage partagé (20 Go par défaut) :

      A small amount of storage is required for your evaluation. We will allocate a default of 20 GB to accommodate all chosen components. Press Enter to accept 20 GB or specify a different size:
    • Relais de messagerie SMTP (facultatif) :

      Do you want to configure an SMTP Mail Relay(SMR)? (y/n) [Default: n]:

      Si le SMTP est activé, les invites supplémentaires incluent :

      • Hôte SMR

      • Port SMR

      • Nom d'utilisateur SMR

      • Mode d'authentification :
        Select SMTP authentication mode:
        1. Password
        2. Client Secret
        Enter 1 or 2 [Default: 1]:

      Selon votre sélection, le programme d'installation demande soit le mot de passe SMR, soit le secret client SMR.

    • Transport sécurisé SMTP :
      Does the SMR operate over SSL/TLS. If yes, a certificate is required to be present in certs/smtp folder (y/n)?
  4. Confirmer et continuer :
    > Continue with installation? (y/n) [Default: y]:
    Après confirmation, le programme d'installation passe aux composants Express :
    • Cluster Kubernetes (K0S)
    • Registre privé Docker (DPR)
    • Instance du serveur SQL (MSSQL)
    • Plateforme centrale AppScan 360° (ASCP) et composants.
    • Conseils de résolution AppScan (ASRA)
    • Service de convertisseur de modèle DAST (DTCS)
    • Analyse de la composition logicielle (SCA), si sélectionnée
    Une fois l'opération terminée, le programme d'installation imprime :
    • l'entrée de fichier hosts à ajouter
    • URL finale d'accès à AppScan 360
  5. Ajoutez l'adresse IP générée et le mappage de nom d'hôte à votre fichier hôte.
    Système d'exploitation Chemin d'accès au fichier hôte
    Linux, macOS /etc/hosts
    Windows C:\Windows\System32\drivers\etc\hosts
    Exemple :
    192.168.1.100 appscan.appscan-test.local

Connexion et activation AppScan 360°

Pour vous connecter et activer AppScan 360° :
  1. Ouvrez l'URL imprimée à la fin de l'installation : https://<host>.<domain>.
  2. Connectez-vous avec les informations d'identification par défaut :
    • Nom d'utilisateur : Admin
    • Mot de passe : Admin12!
  3. Chargez votre fichier de licence AppScan 360° pour activer le déploiement.

Désinstallation

Pour supprimer une installation express de machine virtuelle unique d'AppScan 360° :
cd ~/aio-setup/aioWorkspace
sudo ./disengageAS360-AIO.sh
Cette opération supprime les composants installés et les ressources AppScan 360° créées par cette installation.

Modification de la méthode d'installation

Si vous souhaitez passer au-delà du mode Express :