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

Le mode personnalisé est destiné à la configuration complète d'une machine virtuelle unique et aux déploiements orientés production. Ce mode prend en charge plus de choix de déploiement que le mode express, y compris la configuration de la base de données externe, la sélection du registre Docker, les paramètres proxy facultatifs et l'intégration OpenTelemetry.

Remarque : Exécutez toutes les étapes d'installation et de configuration en tant qu'administrateur sur le système cible.

Avant de commencer

  1. Passez en revue la section Configuration d'un environnement à machine virtuelle unique et rassemblez les valeurs dont vous aurez besoin lors de la configuration.
  2. Téléchargez tous les kits requis à partir du portail MyHCLSoftware dans un seul répertoire. Par exemple, /home/username/AppScan360_singleVM.

    Conservez tous les kits d'installation dans le même dossier.

    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)
  3. Préparez le répertoire de travail et rendez les kits 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 LDAP, OIDC, SMTP, le registre Docker, l'accès ou l'approbation du collecteur OpenTelemetry, créez d'abord la structure de dossiers de certificats :
    sudo ./AppScan360_SingleVMsetup_v<version>.run -- "$PWD" prepareCertsFolders
    La commande crée les éléments suivants :
    Dossier Fonction
    ~/aio-setup/certs/ Dossier de certificats principal
    ~/aio-setup/certs/docker/ Certificats de registre Docker
    ~/aio-setup/certs/ldap/ Certificats LDAP (LDAPS)
    ~/aio-setup/certs/smtp/ Certificats SMTP (SMTPS)
    ~/aio-setup/certs/oidc/ Certificats OIDC (OIDCS)
    ~/aio-setup/certs/otel/ Certificats OpenTelemetry lorsque le collecteur utilise une autorité de certification privée
    ~/aio-setup/certs/ingress/ Certificats d'entrée (en option, 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 avant de démarrer l'installation.

Exécuter une installation

  1. Démarrez le programme d'installation :
    cd ~/aio-setup
sudo ./AppScan360_SingleVMsetup_v2.1.0.run -- $PWD

    Si vous devez arrêter et nettoyer une installation interrompue :

    cd aioWorkspace
./disengageAS360-AIO.sh
    Les fichiers journaux d'installation sont écrits à l'emplacement ./aioWorkspace/logs.
  2. Lorsque vous y êtes invité, sélectionnez Mode personnalisé (production).
    Please select your installation path:
1. 🚀  Express Mode (POC)
2. 🛠️  Custom Mode (Production)
Enter 1 or 2 [Default: 1]:

Remplir le questionnaire personnalisé

Le flux de production pose un ensemble de questions plus large que le mode Express.

Sélection de SCA

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

Si vous activez SCA, des invites de base de données et de registre supplémentaires s'affichent ultérieurement dans le flux.

Configuration de la base de données

Choisissez le type de base de données :

Please select the database type for this production deployment:
1. 🔷 Microsoft SQL Server (MSSQL)
2. 🐘 PostgreSQL
Enter 1 or 2 [Default: 1]:

Fournissez ensuite les détails de connexion à la base de données :

> 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 sélectionnez PostgreSQL, le port par défaut est 5432.

Configuration spécifique à SCA

Si SCA est activé, le programme d'installation demande également ce qui suit :

> Please provide a name for the new SCA database [Default: AppScan360_SCA_DB]:
> Please provide a name for the new SCA Aggregation database [Default: AppScan360_SCA_Aggregation_DB]:
> SCA Registry Address [Default: hclcr.io]:
> SCA Registry Path [Default: appscan360/as360-k8s-docker-images]:
> SCA Helm Repository Path [Default: appscan360/as360-k8s-helm-packages]:
> SCA Registry Username (typically your HCL ID):
> SCA Registry Password/Token:

Utilisez vos informations d'identification HCL si vous souhaitez activer les mises à jour de la base de données des vulnérabilités SCA.

Configuration réseau

Domaine principal :

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

Domaines externes ou adresses IP requis pour l'accès sortant :

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 this VM connected to a local DNS server? (y/n) [Default: n]:

Nœud final OpenTelemetry :

Provide the OpenTelemetry collector endpoint URL. If not applicable, press Enter to skip (recommended format: http://<opentelemetry-collector-host>:4317):

Taille du stockage partagé :

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

Relais de messagerie SMTP (facultatif)

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

Si ce relais est activé, le programme d'installation demande ce qui suit :

What is the SMR host?
What is the SMR port?
What is the SMR username?

Mode d'authentification :

Select SMTP authentication mode:
1. Password
2. Client Secret
Enter 1 or 2 [Default: 1]:

Il demande ensuite le mot de passe SMR ou le secret client SMR, suivi de :

Does the SMR operate over SSL/TLS. If yes, a certificate is required to be present in certs/smtp folder (y/n)?

Configuration du registre Docker

Le mode personnalisé prend en charge soit un registre privé Docker local géré par kit, soit un registre externe.

Indiquez si le kit doit installer et gérer DPR localement :

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

Si vous choisissez n, le programme d'installation demande les détails du registre externe :

What is the external Docker Private Registry (DPR) address (FQDN:PORT)?
What is the external Docker Private Registry (DPR) username?
What is the external Docker Private Registry (DPR) password?
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]:

Pour utiliser le chemin racine du registre au lieu d'un chemin contextuel, saisissez EMPTY pour l'invite contextuelle.

Si vous choisissez y, le kit prépare automatiquement un DPR local.

Service de proxy (facultatif)

Do you want to use a proxy service? (y/n) [Default: n]:

Si ce relais est activé, le programme d'installation demande ce qui suit :

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?:

Confirmation finale

Avant le démarrage de l'installation, le script affiche un récapitulatif de vos sélections et vous demande de confirmer :

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

Eléments configurés par le programme d'installation

Après confirmation, le programme d'installation configure les éléments suivants :
  • Cluster Kubernetes (K0S)
  • AppScan 360° plateforme centrale (ASCP) et composants de support
  • Conseils de résolution AppScan (ASRA)
  • Analyse de la composition logicielle (SCA), si sélectionnée
  • Connectivité de la base de données externe
  • Connectivité du registre Docker

Le délai d'installation dépend de la capacité du système et des performances du réseau.

Une fois l'opération terminée, le programme d'installation imprime :
  • L'entrée de fichier hosts à ajouter
  • L'URL d'accès AppScan 360° finale
Mettez à jour votre fichier hosts en utilisant l'adresse IP et le mappage de nom d'hôte générés.
Système d'exploitation Chemin du fichier hosts
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 produit.

Recommandation de sauvegarde

Sauvegardez régulièrement les éléments suivants :

  • Base de données
  • Fichiers de configuration dans le répertoire d'installation
  • Informations de licence

Modification de la méthode d'installation

Pour le déploiement distribué, voir Installation distribuée d'AppScan 360°.

Problèmes d'installation courants

Problème Solution
Echecs de connexion à la base de données Vérifier les informations d'identification de la base de données et la connectivité réseau
Espace disque insuffisant S'assurer que la machine virtuelle dispose de suffisamment de stockage pour la configuration sélectionnée
Erreurs de certificat Vérifier les formats de fichier de certificat, les noms de fichier et leur emplacement dans les dossiers certs
Connectivité du registre Docker Vérifier les informations d'identification du registre, l'adresse et la connectivité réseau
Tous les autres problèmes Guide de dépannage