Commandes d'analyse (Linux et macOS)

Les commandes d'analyse servent à envoyer des requêtes d'examen à des fins d'analyse, ou à utiliser des requêtes d'examen qui ont déjà été envoyées. Grâce aux commandes, vous pouvez également recevoir des informations à propos des examens. Ces informations peuvent s'avérer utiles pour les scripts d'automatisation.

Avant d'utiliser ces commandes, veillez à vous connecter au service d'analyse (voir Commandes d'authentification).

appscan.sh status

Syntaxe :

appscan.sh status -i <job_id>

Description :

renvoyer l'un des statuts suivants pour un travail d'analyse :

Pending
Starting
Running
FinishedRunning
FinishedRunningWithErrors
Ready
ReadyIncomplete
FailedToScan
ManuallyStopped
None
Initiating
MissingConfiguration
PossibleMissingConfiguration

Options requises :

  • -i : Spécifiez -i <job_id>, où <job_id> correspond à l'ID du travail d'analyse.
Conseil : pour toutes les commandes, les options peuvent être utilisées dans n'importe quel ordre.

Exemples :

pour afficher le statut de l'ID de travail 12345, indiquez ceci :

appscan.sh status -i 12345

Si le code retour est 0, cela signifie que le travail est en attente. Si le code retour est 1, cela signifie que le travail est en cours de démarrage, et ainsi de suite.

appscan.sh list

Syntaxe :

appscan.sh list

Description :

Description :

appscan.sh list_apps

Syntaxe :

appscan.sh list_apps

Description :

Cette commande vous permet de voir les applications AppScan 360° auxquelles vous avez accès. Pour utiliser la commande, vous devez être authentifié au service. Après avoir lancé la commande, une liste d'applications AppScan 360° s'affiche et indique les noms des applications suivis de leurs ID entre parenthèses. Utilisez les valeurs d'ID de cette liste lorsque vous utilisez l'option -a de la commande queue_analysis.

appscan.sh cancel

Syntaxe :

appscan.sh cancel -i <job_id>

Description :

Annuler un travail d'analyse qui est en cours d'exécution ou en file d'attente.

Options requises :

  • -i : Spécifiez -i <job_id>, où <job_id> correspond à l'ID du travail d'analyse.
Conseil : pour toutes les commandes, les options peuvent être utilisées dans n'importe quel ordre.

Exemples :

pour annuler l'ID de travail 12345, indiquez ceci :

appscan.sh cancel -i 12345

appscan.sh queue_analysis

Syntaxe :

appscan.sh queue_analysis -a <app_id> -f <file> -n <scan_name>

Description :

Soumettre un fichier pour analyse (archive IRX ou non-IRX). Lorsque l'examen est terminé, vous recevez une notification par e-mail (à l'adresse e-mail associée au compte utilisé pour se connecter au service d'analyse). L'e-mail contient un lien qui vous permet de vous connecter pour télécharger votre examen.

Remarque : Lorsque vous examinez du code ou générez un fichier IRX, vous pouvez recevoir un message relatif à la mise à jour vers l'Utilitaire de ligne de commande Static Analyzer le plus récent. Voir Support de l'utilitaire de ligne de commande (CLI).

Options requises :

  • -f : Spécifiez -f <file>, où <file> correspond au fichier IRX ou à l'archive non-IRX que vous souhaitez envoyer pour examen. Si le fichier ne se trouve pas dans le répertoire de travail, utilisez cette option pour spécifier le chemin et le nom du fichier.
    Remarque : Cette option est uniquement requise si l'une des deux affirmations suivantes est vraie :
    • Vous lancez la commande depuis un répertoire qui contient plusieurs fichiers cibles. Si le répertoire ne contient qu'un seul fichier cible, ce fichier est envoyé, à condition que l'option -f ne soit pas utilisée.
    • Vous lancez la commande depuis un répertoire qui ne contient pas de fichiers cibles. Dans ce cas, vous devez utiliser l'option -f pour spécifier le chemin d'accès et le nom du fichier à envoyer.
  • -a : Les fichiers que vous envoyez pour analyse (fichierIRX ou archive non-IRX) doivent être associés à une application AppScan 360° existante. Avec cette option, spécifiez -a <app_id>, où <app_id> correspond à l'ID de l'application à laquelle les fichiers doivent être associés. Pour déterminer l'ID, utilisez la commande list_apps.
Indicateurs/paramètres en option :
  • -n : Spécifiez -n <scan_name>, où <scan_name> correspond au nom de l'examen envoyé.
  • -nen : Désactivez la notification par e-mail à la fin de l'analyse. Si cet indicateur n'est pas spécifié, la notification par e-mail est effectuée par défaut.
    Remarque : L'indicateur -e, désormais obsolète, a été remplacé par -nen.
  • -ps : Exécutez l'examen en tant qu'examen personnel. Si cet indicateur n'est pas spécifié, un examen régulier se produit par défaut.
Conseil : pour toutes les commandes, les options peuvent être utilisées dans n'importe quel ordre.

Exemples :

Pour envoyer my_irx.irx, situé dans le répertoire actuel, à des fins d'examen, utilisez
appscan queue_analysis -f my_irx.irx -a 12345 -n my_scan
12345 correspond à l'ID de l'application à laquelle associer l'examen (il est possible de déterminer l'ID de l'application à l'aide de la commande list_apps). Si vous utilisez l'interface utilisateur ou la commande list pour afficher tous les examens en cours, my_scan figure dans la liste.

appscan.sh info

Syntaxe :

appscan.sh info -i <job_id>

Description :

afficher les informations pour un travail d'analyse spécifié.

Les informations fournies peuvent être utilisées pour les scripts d'automatisation.

Options requises :

  • -i : Spécifiez -i <job_id>, où <job_id> correspond à l'ID du travail d'analyse.
Conseil : pour toutes les commandes, les options peuvent être utilisées dans n'importe quel ordre.

Exemples :

pour recevoir des informations à propos de l'ID de travail 12345, indiquez ceci :

appscan.sh info -i 12345

Exemple d'informations renvoyées :

NLowIssues=0
ReadStatus=2
NHighIssues=0
Name=appscan.zip
ScanEndTime=2014-11-20T13:56:04.497Z
Progress=0
RemainingFreeRescanMinutes=0
ParentJobId=00000000-0000-0000-0000-000000000000
EnableMailNotifications=false
JobStatus=6
NInfoIssues=0
JobId=9b344fc7-bc70-e411-b922-005056924f9b
NIssuesFound=0
CreatedAt=2014-11-20T13:54:49.597Z
UserMessage=Scan completed successfully. The report is ready.
NMediumIssues=0
Result=1