Accueil
Référence
Consultez les informations de référence pour HCL®AppScan® Source, y compris l'utilisation d'utilitaires, de plug-ins et d'API.
L'utilitaire de génération Ounce/Make
Ounce/Make est un outil automatisant l'importation d'informations de configuration dans AppScan® Source à partir d'environnements de génération utilisant un fichier makefile. Ounce/Make vous évite d'avoir à importer manuellement ces informations des fichiers makefiles. C'est la méthode recommandée pour configurer ces projets.
Exemples
Cette section décrit trois façons d'utiliser Ounce/Make.

Bienvenue
Bienvenue dans la documentation relative à HCL®AppScan® Source.
Nouveautés
Découvrez les nouvelles fonctions qui ont été ajoutées à AppScan® Source et notez les fonctions et fonctionnalités devenues obsolètes dans cette édition.
Installation
Apprenez à installer, mettre à niveau et activer HCL®AppScan® Source.
Configuration
Découvrez comment configurer des applications et des projets, et définir des attributs et des propriétés dans HCL®AppScan® Source.
Administration
Apprenez à administrer les comptes utilisateur et les droits, auditer l'activité des utilisateurs d'audit et à gérer les intégrations dans HCL®AppScan® Source.
Examen
Cette section explique comment examiner votre code source et gérer les évaluations dans HCL®AppScan® Source.
Triage et analyse
Le regroupement de constatations similaires permet aux analystes de la sécurité ou aux auditeurs du service informatique d'effectuer une segmentation et un triage des problèmes affectant le code source. Cette section explique comment procéder au triage des évaluations AppScan® Source et à l'analyse des résultats.
Génération de rapports
Les analystes de la sécurité et les gestionnaires des risques peuvent accéder à des rapports sur des constatations spécifiques ou à une série de rapports d'audit évaluant la conformité avec les pratiques optimales en matière de sécurité et les exigences réglementaires. Cette section décrit comment créer des rapports sur les données de constatations agrégées.
Extension des fonctionnalités du produit
Apprenez à étendre le produit pour répondre à des exigences de développement spécifiques.
Référence
Consultez les informations de référence pour HCL®AppScan® Source, y compris l'utilisation d'utilitaires, de plug-ins et d'API.
- L'utilitaire de génération Ounce/Make
  Ounce/Make est un outil automatisant l'importation d'informations de configuration dans AppScan® Source à partir d'environnements de génération utilisant un fichier makefile. Ounce/Make vous évite d'avoir à importer manuellement ces informations des fichiers makefiles. C'est la méthode recommandée pour configurer ces projets.
  - Configuration requise
    Pour créer correctement des fichiers de projet AppScan® Source, vous devez exécuter Ounce/Make dans un environnement adapté. La liste suivante répertorie les exigences pour une exécution correcte d'Ounce/Make. Si toutes ces exigences ne sont pas remplies, l'exécution Ounce/Make échouera.
  - Eléments pris en charge par Ounce/Make
    Ounce/Make prend en charge plusieurs plateformes d'ordinateur, compilateurs et versions de make.
  - Opération
    Ounce/Make fonctionne avec votre commande Make afin d'extraire de vos fichiers makefile les informations de configuration nécessaires et de créer les fichiers de projet AppScan® Source appropriés (ppf). Pour ce faire, Ounce/Make requiert que vous fournissiez certaines informations sur l'environnement de génération, comme la version de la commande make utilisée.
  - Options make et syntaxe de commande Ounce/Make
    Ounce/Make prend en charge de nombreuses options pouvant modifier son comportement lors de son exécution.
  - Fichier de propriétés Ounce/Make
    Le fichier de propriétés Ounce/Make (ouncemake_properties.xml) est un fichier au format XML contenant des informations sur l'environnement de génération. Lors de son exécution, Ounce/Make localise ce fichier d'après le chemin de recherche ou l'option -p. Le fichier de propriétés doit indiquer le compilateur utilisé dans l'environnement de génération, l'éditeur de liens et les éléments make.
  - Exemples
    Cette section décrit trois façons d'utiliser Ounce/Make.
    - Exemple 1 : Ounce/Make sans options
      Cet exemple illustre une utilisation non récursive d'Ounce/Make. Sous ce mode, Ounce/Make n'examine que le fichier makefile dans le répertoire depuis lequel il est appelé. Si le fichier makefile original comporte des appels à d'autres fichiers makefiles, Ounce/Make les ignore.
    - Exemple 2 : Ounce/Make avec option de récursivité
      Avec l'option -r, Ounce/Make opère en mode récursif (en suivant les appels à d'autres fichiers makefile depuis un fichier makefile). Etant donné que le mode de fichier à plusieurs projets est celui par défaut, lorsqu'il est utilisé avec l'option -r, Ounce/Make crée un fichier de projet AppScan® Source pour chaque fichier makefile rencontré compilant le code source.
    - Exemple 3 : Ounce/Make avec projet unique et option de récursivité
      L'exemple 3 illustre une utilisation récursive d'Ounce/Make en mode de projet unique. Ounce/Make génère un seul fichier de projet AppScan® Source combinant le code source compilé par tous les fichiers makefile rencontrés.
- AppScan® Source - Interface de ligne de commande (CLI)
  L'interface CLI est une interface de la fonctionnalité de base AppScan® Source.
- L'outil de génération Ounce/Ant
  Cette section décrit comment utiliser Ounce/Ant, qui est un utilitaire de génération AppScan® Source intégrant AppScan Source et Apache Ant. L’intégration d’Ounce/Ant avec votre environnement Ant vous aide à automatiser les générations et les évaluations de code.
- API d'accès aux données AppScan® Source
  L'API d'accès aux données fournit l'accès aux résultats d'évaluation générés par AppScan® Source, y compris aux constatations et aux détails des constatations. Elle donne également accès aux métriques d'évaluation telles que la date et l'heure de l'analyse, le nombre de lignes de code, la densité V et le nombre de constatations.
- Glossaire
  Apprenez la terminologie courante du produit
Traitement des incidents et support
Informations, ressources et outils d'auto-assistance pour vous aider à résoudre les problèmes lors de l'utilisation de HCL®AppScan® Source.

Exemples

Cette section décrit trois façons d'utiliser Ounce/Make.

L'Exemple 1 : Ounce/Make sans options illustre l'utilisation d'Ounce/Make sans options, en créant un fichier de projet AppScan® Source basé uniquement sur le fichier makefile dans le répertoire depuis lequel Ounce/Make est appelé.

L'Exemple 2 : Ounce/Make avec option de récursivité utilise Ounce/Make avec l'option de récursivité -r, laquelle indique à Ounce/Make d'opérer récursivement et de suivre tous les appels à d'autres fichiers makefile.

Dans l'Exemple 3 : Ounce/Make avec projet unique et option de récursivité, Ounce/Make utilise à la fois l'option -r (récursivité) et -s (projet unique) afin de créer un fichier de projet AppScan® Source unique basé sur un traitement récursif de tous les fichiers makefile rencontrés par Ounce/Make.

Structure de répertoire et de fichiers

Ces trois exemples utilisent la même structure de répertoires et de fichiers :

Avant l'exécution d'ouncemake

Ce diagramme présente un répertoire racine (/usr/source) contenant un fichier makefile et des fichiers source. Le répertoire /usr/source contient deux sous-répertoires, /usr/source/database et /usr/source/server. Le répertoire /usr/source/database contient un fichier makefile et des fichiers SQL. Le répertoire /usr/source/server contient un fichier makefile et des fichiers source.

Cet exemple repose sur les hypothèses suivantes concernant les trois fichiers makefile :

Le fichier makefile dans /usr/source génère les fichiers source dans /usr/source et appelle les fichiers makefile dans /usr/source/database et /usr/source/server.
Le fichier makefile dans /usr/source/database importe les fichiers SQL dans une base de données.
Le fichier makefile dans /usr/source/server génère les fichiers source dans /usr/source/server.