`ScanApplication`

Description

Examinez l'application spécifiée et effectuez d'autres actions liées à l'examen.

Syntaxe

ounceauto ScanApplication
-application <nom de l'application>|
  -application_file <chemin du fichier d'application>
[-name <nom de l'évaluation>]
[-scanconfig <scan_configuration_name>]
[-waitforlicense <wait_time>]
[-save <filename>]
[-caller <caller>]
[-publish]
[-classificationDefinitive]
[-classificationSuspect] 
[-classificationCoverage]
[-clearcache]
[-report <type de rapport> <format de sortie> <emplacement de sortie>]
[-export <type d'exportation> <emplacement de sortie>]
[-includeSrcBefore <n>]
[-includeSrcAfter <n>]
[-includeTraceDefinitive]
[-includeTraceSuspect]
[-includeTraceCoverage]
[-includeHowToFix]
[-appserver_type]
[-include_all_lib_jars] 
[-include_lib_jars] 
[-no_ear_project]
[-severityHigh]
[-severityMedium] 
[-severityLow] 
[-severityInfo]

-application <nom de l'application> ou -application_file <chemin du fichier d'application> : L'un des deux est requis.
- Si vous spécifiez -application <name of application>, indiquez le nom de l'application à examiner.
- Si vous spécifiez -application_file <path to application file>, indiquez le chemin d’accès et le nom de fichier complets de l’un de ces types de fichiers :
  - Fichiers d'application AppScan® Source (.paf).
  - Espaces de travail Eclipse (.ewf)
    Note: .ewf Les fichiers . ewf sont générés lorsque vous utilisez openapplication pour ouvrir un répertoire d'espace de travail (en spécifiant son chemin d'accès).
  - WAR Fichiers (.war)
  - EAR Fichiers (.ear)
  - Windows uniquement : Fichiers d'espace de travail Microsoft™ Visual C++ (.dsw)
  - Windows uniquement : Fichiers de solution Microsoft™ Visual Studio .NET (.sln)
  Note: Pour savoir quelles versions des fichiers importés sont prises en charge par AppScan® Source for Analysis, AppScan® Source for Automation et l'Interface de ligne de commande d’AppScan® Source, voir Configuration requise et composants prérequis pour l'installation. Dans cette page, sélectionnez l'onglet de la version d'AppScan® Source que vous utilisez, puis sélectionnez le composant AppScan® Source que vous utilisez. Si AppScan® Source prend en charge l'ouverture et l'examen de fichiers provenant d'autres environnements de développement, cette prise en charge est indiquée à la section Compilateurs et langues de l'onglet Logiciels pris en charge.
-name <nom de l'évaluation> : Facultatif. Un nom pour l'évaluation.
-scanconfig <scan_configuration_name> : Facultatif. Spécifiez le nom d'une configuration d'examen à utiliser pour l'examen. Si aucune configuration d'examen n'est indiquée, la configuration d'examen par défaut va être utilisée pour l'examen.
-waitforlicense <wait_time> : Facultatif. Spécifiez le temps d'attente en minutes pendant lequel un examen attend lorsqu'une licence AppScan® Source for Automation n'est pas disponible. Si aucun temps d'attente n'est indiqué à l'aide de -waitforlicense, une valeur par défaut est obtenue à partir de CLI.ozsettings. Le temps d'attente peut être désactivé en réglant la valeur sur 0.
-save <nom de fichier> : Facultatif. Enregistrer les résultats de l'évaluation dans ce fichier.
-caller <caller> : Facultatif. Permet d'affecter un appelant à l'opération. L'appelant peut être le nom d'un utilisateur réel, sans que cela soit obligatoire. Le nom de l'appelant est consigné dans le fichier journal ounceauto.
-publish : Facultatif. Publier l'évaluation après l'examen.
-clearcache : Facultatif. Cette commande supprime le cache d'analyse de vulnérabilité et les données de signature des règles personnalisées avant l'examen.
-report : Facultatif. Générer un rapport après l'examen.
- Options obligatoires de la commande -report :
  - <report type> : Type de rapport. Il peut s'agir de rapports sur les constatations, de rapports AppScan® Source et de rapports personnalisés. Reportez-vous aux options indiquées dans la rubrique GenerateReport.
  - <output format> : Spécifiez le format du rapport. Reportez-vous aux options indiquées dans la rubrique GenerateReport.
  - <output location> : Emplacement de sauvegarde du rapport.
- Options facultatives de la commande -report :
  - -classificationDefinitive : Filtrer les résultats définitifs.
  - -classificationSuspect : Filtrer les résultats suspects.
  - -classificationCoverage : Filtrer les résultats de couverture d'analyse.
  - -includeSrcBefore <n> : Nombre de lignes de code source à inclure avant chaque résultat.
  - -includeSrcAfter <n> : Nombre de lignes de code source à inclure après chaque résultat.
  - -includeTraceDefinitive : Inclure les informations de trace dans le rapport pour les résultats définitifs (voir Classifications pour en savoir plus sur les classifications des résultats).
  - -includeTraceSuspect : Inclure les informations de trace dans le rapport pour les résultats suspects.
  - -includeTraceCoverage : Inclure les informations de trace dans le rapport pour les résultats de couverture d'analyse.
  - -severityHigh : Filtrer les résultats de gravité élevée.
  - -severityMedium : Filtrer les résultats de gravité moyenne.
  - -severityLow : Filtrer les résultats de gravité faible.
  - -severityInfo : Filtrer les résultats de gravité informationnelle.
-export : Facultatif. Exportez les constatations d'examen dans un fichier CSV ou SARIF. Si cette commande est utilisée, les options de commande suivantes sont requises.
- <export type> : Format du rapport exporté, CSV ou SARIF.
- <output location> : Chemin et nom du fichier dans lequel enregistrer le rapport.
-includeHowToFix : Inclure des informations de conseil sur la manière de traiter et de corriger les résultats.
-appserver_type : Facultatif. Si l'application en cours d'ouverture inclut JavaServer Pages (par exemple, un fichier WAR ou EAR), utilisez ce paramètre pour indiquer le serveur d'application à utiliser pour la compilation de JSP. Indiquez l'un de ceux-ci entre guillemets :
- Tomcat 8
- Tomcat 9
- WebSphere 7.0
- WebSphere 8.0
- WebSphere 8.5
- WebLogic 11g
- WebLogic 12c
Note:
- Avant de spécifier un serveur d'application, vérifiez qu'il a été configuré correctement dans les préférences AppScan® Source for Analysis.
- Si -appserver_type n'est pas utilisé, le compilateur JSP par défaut défini actuellement dans AppScan® Source for Analysis sera utilisé pour la compilation JSP. Prêt à l'emploi, Tomcat 9 est le compilateur JSP par défaut.
Pour les fichiers :WAR
- -include_all_lib_jars : utilisez ce paramètre pour prendre en compte toutes les bibliothèques du fichier WAR lors de l'examen.
- -include_lib_jars : utilisez ce paramètre pour préciser les bibliothèques du fichier WAR à prendre en compte lors de l'examen. Lorsque vous utilisez ce paramètre, n'incluez pas d'informations sur le chemin d'accès à la bibliothèque et séparez les différentes bibliothèques par des virgules.
-no_ear_project : lors de l'importation d'un fichier EAR, un projet destiné au stockage des bibliothèques partagées est créé automatiquement. En l'absence de bibliothèques partagées, le projet est créé, mais reste vide. Ce paramètre permet de ne pas créer de projet pour le fichier EAR.

Valeur de retour

L'ID de la demande en cas de réussite, ou -1 si la soumission de la demande n'a pas abouti.

Exemples

Examinez l'application WebGoat, publiez-la et annotez le journal en indiquant que John Smith est l'appelant :
```
ounceauto scanapplication -application_file C:\WebGoat\WebGoat.paf
-publish -caller JohnSmith
```
Examinez l'application WebGoat et créez un rapport Constatations sous le répertoire C:\WebGoat. Dans le rapport, incluez les informations de trace pour les constatations définitives :
```
ounceauto scanapplication -application WebGoat
-report Findings html C:\WebGoat\MyReport.html
-includeTraceDefinitive
```

Examinez un fichier WAR en ne prenant en compte que certaines bibliothèques :

ounceauto scanapplication -application_file c:\mywar.war 
-include_lib_jars lib1.jar,lib2.jar