Dépannage des analyses statiques

A partir du 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

Error: Scan failed. Your subscription does not allow for Open Source scans. 
Please contact your sales representative for information regarding activating “Open Source” scanning. 
If you need further assistance, please reach out to our Technical Support team

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 : Passez en revue 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.

Error: We are unable to complete the scan successfully. The scan failed since the IRX was not created properly. 
It could possibly be due to an incorrect configuration or missing dependencies. 
If you need additional assistance, please reach out to our Technical Support team.

Error. An unknown error occurred.

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'analyse 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'analyse 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 Your subscription does not allow for Open Source scans. et que vous avez téléchargé un IRX pour l'examen, 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

Problems found during validation. 
The prepare operation found only open source files types. To run opensource only, use the -oso flag. 
To run security and opensource, include additional supported file types.

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 du code tiers, add thirdParty="true" sur appscan-config.xml et essayez de réexécuter l'examen.

No known scan file types were found during discovery. 
Please specify a location that contains .class, .jar, .war, .ear, .dll, .exe, PHP, Ruby, NPM packages, or JavaScript files.

Problems found during validation. 
No scannable files found. If you are trying to scan third party code, generate the IRX file using the --thirdParty option. If you are trying to scan for open source, generate the IRX using the -oso option. For a list of supported file types, refer to https://help.hcltechsw.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 devrait 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
• Examen de l'ID
• 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.