Dépannage des analyses statiques

A partir de Plateforme centrale AppScan, accédez à la page d'examen relative à l'échec de l'examen. Exécutez l'une des opérations suivantes :

• Sélectionnez Applications > (application) > Afficher tous les examens > (nom de l'examen), ou,
• Sélectionnez Examens > (nom de l'examen)

Consultez les messages d'erreur affichés sur la page d'examen. Les cas d'erreur courants sont évoqués ci-dessous.

Les erreurs les plus courantes sont :

• Open Source
• Aucun IPVA/IRX corrompu
• Erreur inconnue

Erreur : L'examen a échoué. Votre abonnement ne permet pas les examens Open Source. 
Veuillez contacter votre représentant commercial pour obtenir des informations sur l'activation du balayage « Open Source ». 
Si vous avez besoin d'une aide supplémentaire, veuillez contacter notre équipe d'assistance technique

Si vous avez chargé un fichier IRX :

1. Réexécutez appscan prepare, en confirmant que les fichiers cibles ne sont pas des fichiers Open Source et que le paramètre openSourceOnly n'est pas utilisé.
   Remarque : Consultez les paramètres pris en charge pour appscan prepare ici.
2. Si le problème persiste, téléchargez les journaux d'examen et transmettez-les à un administrateur.

Erreur : Impossible d'effectuer l'examen correctement. L'examen a échoué car l'IRX n'a pas été créé correctement. 
Cela peut être dû à une configuration incorrecte ou à des dépendances manquantes. 
Si vous avez besoin d'une aide supplémentaire, veuillez contacter notre équipe d'assistance technique.

Erreur. Une erreur inconnue s'est produite.

Pour télécharger le journal d'examen :

• A partir de l'interface utilisateur ASCP :
  1. Sur la page d'examen (Applications > Application > Afficher tous les examens > (nom de l'examen) ou Examens > (nom de l'examen)), copiez l'ID d'exécution répertorié sous Détails de l'examen.
  2. Dans le coin supérieur droit de la page d'examen, sélectionnez Gérer l'examen > Télécharger le journal.

     AppScan 360° télécharge un fichier ZIP sur votre système local. Notez l'emplacement du téléchargement.

  3. Extrayez le contenu du fichier ZIP.
• A partir d'une ligne de commande :

  Téléchargez le contenu du répertoire associé à l'examen depuis <fileStorageRoot>/SaaSWorkingDirectory/SaaSStorage/Scans/<scanID>/<ExecutionID}/.

• Accéder aux journaux d'examen
• Examinez une IRX avec une erreur d'absence d'IPVA/d'IRX corrompue
• Examen d'une IRX avec une erreur open source
• Enquêter sur d'autres cas d'erreur

1. Téléchargez le contenu du répertoire associé à l'examen depuis <fileStorageRoot>/SaaSWorkingDirectory/SaaSStorage/Scans/<scanID>/<ExecutionID}/.
2. Extrayez et recherchez les erreurs dans les journaux.
3. Résolvez les erreurs et essayez d'exécuter à nouveau l'examen.

Si l'examen a échoué avec l'erreur Votre abonnement ne permet pas les examens Open Source et que vous avez téléchargé un fichier IRX pour le balayage, vérifiez les erreurs dans le fichier IRX :

• Erreur de type de fichier Open Source
• Erreur aucun type de fichier connu
• Erreur aucun fichier examinable

Problèmes détectés au cours de la validation. 
L'opération de préparation n'a trouvé que des types de fichiers Open Source. Pour exécuter opensource uniquement, utilisez l'indicateur -oso. 
Pour exécuter security et opensource, incluez des types de fichiers pris en charge supplémentaires.

Vérifiez la configuration des examens :

• Vérifiez que vous n'utilisez pas un paramètre non pris en charge dans la commande appscan prepare. Si openSourceOnly="true" ou -oso est répertorié, supprimez ce paramètre.

  AppScan 360° ne prend pas en charge le paramètre openSourceOnly ou -oso dans appscan prepare.

• Si vous avez téléchargé un fichier IRX et que vous avez l'intention d'exécuter un examen sur un emplacement contenant uniquement des bibliothèques tierces, activez le balayage tiers. Exécutez l'une des opérations suivantes :

  1. Ajoutez l'indicateur tiers à appscan prepare pour récupérer les bibliothèques tierces et essayez d'exécuter à nouveau l'examen.

     La commande doit ressembler à : appscan prepare -tp.

  2. Ajoutez thirdParty="true" à appscan-config.xml et essayez d'exécuter à nouveau l'examen.

     Vous trouverez un exemple à la section Configuration de la génération de fichiers IRX avec l'interface de ligne de commande

• Si vous avez téléchargé un fichier ZIP et que vous avez l'intention d'exécuter un examen sur un emplacement contenant uniquement des bibliothèques tierces, activez le balayage tiers :
  • Si vous souhaitez examiner un code tiers, ajoutez thirdParty="true" à appscan-config.xml et essayez d'exécuter à nouveau l'examen.

Aucun type de fichier d'examen connu n'a été trouvé au cours de la reconnaissance.  
Indiquez un emplacement contenant des fichiers .class, .jar, .war, .ear, .dll, .exe, PHP, Ruby, des packages NPM ou des fichiers JavaScript.

Problèmes détectés au cours de la validation. 
Aucun fichier examinable n'a été trouvé. Si vous essayez d'examiner un code tiers, générez le fichier IRX à l'aide de l'option --thirdParty. Si vous essayez d'effectuer un examen Open Source, générez le fichier IRX à l'aide de l'option -oso. Pour obtenir la liste des types de fichiers pris en charge, reportez-vous à la page https://help.hcl-software.com/appscan/ASoC/src_language_support.html#src_language_support__table_ylp_rn5_jw.

• Si vous avez l'intention d'exécuter un examen sur un emplacement contenant uniquement des bibliothèques tierces, vous devez activer le balayage tiers. Exécutez l'une des opérations suivantes :
  1. Ajoutez l'indicateur tiers à appscan prepare pour récupérer les bibliothèques tierces et essayez d'exécuter à nouveau l'examen.

     La commande doit ressembler à : appscan prepare -tp.

  2. Ajoutez thirdParty="true" à appscan-config.xml et essayez d'exécuter à nouveau l'examen.

     Vous trouverez un exemple à la section Configuration de la génération de fichiers IRX avec l'interface de ligne de commande

• Si vous avez l'intention d'exécuter un examen de flux de données, vérifiez que l'emplacement d'examen cible contient les types de fichiers compilés appropriés pour Java, .NET ou C/C++ puis essayez d'exécuter à nouveau l'examen.

• Si vous avez l'intention d'exécuter un examen du code source uniquement, vérifiez que l'emplacement cible contient les types de fichiers de code source corrects, puis essayez d'exécuter à nouveau l'examen.
• Si vous n'aviez pas l'intention d'exécuter un examen du code source uniquement, supprimez l'indicateur –sco de la commande appscan prepare ou de appscan-config.xml, et essayez d'exécuter à nouveau l'examen.

Si, après avoir appliqué les conseils de dépannage présentés ici, vous n'êtes toujours pas sûr de la cause de l'échec de l'examen, contactez le support client HCL pour obtenir une aide supplémentaire. Soyez prêt à fournir au support les informations suivantes :

• ID d'exécution
• ID d'examen
• ID de pod du preparer, le cas échéant
• ID de pod de l'analyseur, le cas échéant
• Toute erreur signalée sur la page d'examen dans AppScan 360° ou dans service.log.
• Fichier ZIP du journal.
• Détails sur l'application/le projet en cours d'examen.
• Détails sur les mesures prises pour dépanner et/ou résoudre le problème.