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.
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.
classes et méthodes de l'API d'accès aux données
Factory
com.ouncelabs.sdk.Factory fournit des méthodes pour l'initialisation, la connexion et l'ouverture d'évaluations. Cette classe est le point d'entrée vers l'API d'accès aux données.
Factory.login

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 version.
Installation
Apprenez à installer, mettre à niveau et activer HCL® AppScan® Source.
Configuration
Découvrez comment configurer des applications, des dossiers 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é et 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 rapport
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.
- AppScan® Source command line interface (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.
  - Modèle d'objet d'API d'accès aux données
  - Utilisation de l'API d'accès aux données.
    Des exemples complets pour les scénarios API d'accès aux données figurent dans les fichiers SamplePublished.java et SampleSdk.java inclus dans <install_dir>\sdk\sample\com\ouncelabs\sdk\sample(où <install_dir> est l'emplacement de votre installation AppScan® Source).
  - classes et méthodes de l'API d'accès aux données
    - AssessedFile
      La classe com.ouncelabs.sdk.assessment.AssessedFile représente une évaluation d'un fichier individuel. Elle permet l'accès aux données d'évaluation concernant un fichier, par exemple ses constatations et statistiques.
    - Assessment
      La classe com.ouncelabs.sdk.assessment.Assessment représente une évaluation d'une application ou d'un projet.
    - AssessmentDiff
      La classe com.ouncelabs.sdk.assessment.AssessmentDiff contient la différence entre deux évaluations, en fournissant l'écart entre les deux.
    - AssessmentFilter
      Utilisez la classe com.ouncelabs.sdk.assessment.AssessmentFilter pour spécifier des critères de filtrage lors de l'extraction d'évaluations publiées.
    - AssessmentResults
      La classe com.ouncelabs.sdk.assessment.AssessmentResults représente l'évaluation complète.
    - Call
      La classe com.ouncelabs.sdk.assessment.Call représente un nœud dans une trace AppScan® Source trace.
    - ClassificationType
      La classe com.ouncelabs.sdk.assessment.ClassificationType représente la classification d'une constatation.
    - DateProximityUnit
      Lorsque com.ouncelabs.sdk.assessment.DateProximityUnit est couplé avec dateProximityDuration, indique l'unité (jours, semaines, etc.) d'après laquelle effectuer le comptage. Requis lorsque dateProximityDuration est spécifié. Les unités valides sont décrites dans cette section.
    - Factory
      com.ouncelabs.sdk.Factory fournit des méthodes pour l'initialisation, la connexion et l'ouverture d'évaluations. Cette classe est le point d'entrée vers l'API d'accès aux données.
    - Finding
      La classe com.ouncelabs.sdk.assessment.Finding représente une constatation individuelle au sein d'une évaluation. Elle permet d'accéder à toutes les données associées à une constatation, comme sa classification et sa gravité.
  - Plug-in Ounce/Maven
    Cette section décrit le plug-in Ounce/Maven, qui utilise l'outil de génération Maven d'Apache pour intégrer AppScan® Source dans le flux de travaux Maven.
  - AppScan® Source for Automation
    Automation Server (ounceautod) vous permet d'automatiser des aspects clés du flux de travaux AppScan® Source et d'intégrer la sécurité aux environnements de génération lors du cycle de vie de développement de logiciels. Automation Server vous permet de placer en file d'attente des requêtes d'examen et de publication d'évaluations, et de générer des rapports sur la sécurité du code d'application.
  - API de gestion de Framework for Frameworks
    AppScan® Source fournit un ensemble d'API Java™ qui permettent d'ajouter le support des frameworks (infrastructures) utilisés dans vos applications. Les classes et méthodes proposées dans ces API vous permettent de représenter les cadres pour lesquels la prise en charge intégrée n'est pas fournie.
  - Messages d'erreur du composant client AppScan® Source
  - Exemples de l'AppScan® Source for Analysis
    AppScan® Source for Analysis comporte un exemple d'applicationdes exemples d'application que vous pouvez utiliser pour vous familiariser avec le produit.
  - Environnement de travail AppScan® Source for Analysis
    Afin d'exploiter pleinement les capacités de AppScan® Source, vous devez avoir une bonne connaissance des concepts fondamentaux de l'environnement de travail AppScan Source for Analysis et savoir comment utiliser les options correspondant le mieux à votre flux de travaux.
  - Vues et fenêtres
    Les vues et fenêtres de AppScan® Source for Development fournissent des présentations alternatives des constatations, permettent l'édition du code et la navigation entre les informations dans votre plan de travail. Une vue peut figurer seule ou être juxtaposée à d'autres dans un bloc-notes à onglets. Vous pouvez modifier l'agencement d'une perspective ou d'une fenêtre en ouvrant et en fermant des vues, et en les ancrant dans des positions différentes dans la fenêtre du plan de travail.
  - Prise en charge de CWE
    La liste CWE (Common Weakness Enumeration) est une liste de normes de l'industrie fournissant des noms usuels pour les faiblesses logicielles publiquement connues. Cette rubrique répertorie les ID CWE pris en charge dans la version actuelle de AppScan® Source.
- 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.

`Factory.login`

Signature

public void login(String user name, String password, String host name[int :port])

Description

Ouvre une session sur le serveur AppScan® Enterprise Server s'exécutant à l'URL spécifiée ou sur l'hôte dont le nom est indiqué. Vous devez vous connecter pour pouvoir publier les évaluations dans la AppScan® Source Database.

Paramètres

username : nom de l'utilisateur qui se connecte.
password : mot de passe de l'utilisateur qui se connecte.
hostname : URL ou nom d'hôte du AppScan® Enterprise Server auquel vous souhaitez vous connecter. hostname peut être une adresse IP ou un nom de domaine.

En cas de besoin, vous pouvez spécifier le numéro de port AppScan® Enterprise Server en ajoutant la mention :<port>. Par exemple, public void login("hwall", "shhh2008", "MyHost:2880").

Exception générée

OunceException, en cas d'échec de la connexion.