Home
Configuring
Learn how to configure the product.
Configuring applications and projects
Before you scan, you must configure applications and projects. This section explains the Application Discovery Assistant, New Application Wizard, and the New Project Wizard. You will learn how to configure attributes for AppScan® Source for Analysis. In addition, this section teaches you how to add existing applications and projects for scanning - and how to add files to projects.
Configuring applications
You can use the New Application Wizard or the Application Discovery Assistant to create applications. The Application Discovery Assistant automates application setup for you, whereas the New Application Wizard allows you to add applications, guiding you through the configuration process. The wizard helps you manually create a project or add existing projects to an application. This section describes these two methods for adding application and basic configuration tasks.
Adding an existing application
Existing applications can be added for scanning by dragging and dropping them into the Explorer view - or by using the Add Application action. In addition, WAR and EAR files can be added by dragging and dropping them into the Explorer view.
Adding an existing application with user interface actions

Welcome
Welcome to the documentation for HCL® AppScan® Source.
Introduction to HCL® AppScan® Source
HCL® AppScan® Source delivers maximum value to every user in your organization who plays a role in software security. Whether a security analyst, quality assurance professional, developer, or executive, the AppScan Source products deliver the functionality, flexibility, and power you need - right to your desktop.
What's New in AppScan® Source
Explore these new features that have been added to AppScan® Source - and note any features and capabilities that have been deprecated in this release.
Installing
Learn how to install the product.
Configuring
Learn how to configure the product.
- Configuring applications and projects
  Before you scan, you must configure applications and projects. This section explains the Application Discovery Assistant, New Application Wizard, and the New Project Wizard. You will learn how to configure attributes for AppScan® Source for Analysis. In addition, this section teaches you how to add existing applications and projects for scanning - and how to add files to projects.
  - AppScan® Source application and project files
    AppScan® Source applications and projects have corresponding files that maintain configuration information required for scanning, as well as triage customization. It is recommended that these files reside in the same directory as the source code, since configuration information (dependencies, compiler options, and so forth) required to build the projects is very similar to that required for AppScan Source to scan them successfully. Best practice includes managing these files with your source control system.
  - Configuring applications
    You can use the New Application Wizard or the Application Discovery Assistant to create applications. The Application Discovery Assistant automates application setup for you, whereas the New Application Wizard allows you to add applications, guiding you through the configuration process. The wizard helps you manually create a project or add existing projects to an application. This section describes these two methods for adding application and basic configuration tasks.
    - Creating a new application with the New Application Wizard
    - Using the Application Discovery Assistant to create applications and projects
      AppScan® Source includes a powerful Application Discovery Assistant which allows you to quickly create and configure applications and projects for Java™ source code and Microsoft™ Visual Studio solutions. The Application Discovery Assistant also allows you to locate Eclipse or Rational® Application Developer for WebSphere® Software (RAD) workspaces that contain Java projects. The Application Discovery Assistant allows you to point to your source, solution, or workspace directory - and then AppScan Source handles the rest.
    - Adding an existing application
      Existing applications can be added for scanning by dragging and dropping them into the Explorer view - or by using the Add Application action. In addition, WAR and EAR files can be added by dragging and dropping them into the Explorer view.
      - Adding an existing application with user interface actions
      - Adding an existing application with drag and drop
    - Adding multiple applications
      Rather than adding just one application at a time, when you first begin working with AppScan® Source for Analysis, you may want to import multiple applications. The Select Applications dialog box allows you to select a root directory from which to search for AppScan Source applications (.paf) or Visual Studio solution files (.sln). Multiple applications can also be added for scanning by dragging and dropping them into the Explorer view.
    - Importing existing Java™ applications from Apache Tomcat and WebSphere® Application Server Liberty profile application servers
      If you have existing Java™ applications that have been deployed to a supported application server, you can automatically import them to AppScan® Source.
    - Adding an Eclipse or Eclipse-based product workspace
      If you have an Eclipse or Rational® Application Developer for WebSphere® Software (RAD) workspace that contains Java™ and/or IBM® MobileFirst Platform projects, you can import it to AppScan® Source for Analysis.
  - Configuring your development environment for Eclipse and Rational® Application Developer for WebSphere® Software (RAD) projects
    Before you import an Eclipse or Rational® Application Developer for WebSphere® Software (RAD) project, you must properly configure the development environment. Although Eclipse is the basis for each project type, AppScan® Source distinguishes between the different versions.
  - Creating a new project for an application
    After you add an application, you add projects to it.
  - Creating containers using the Docker image
  - Copying projects
    AppScan® Source for Analysis allows you to copy all project types except .NET projects. Modifications to the project do not affect the duplicated project; after you copy a project, there is no connection between the original project and the copied project. When you copy an imported project, you create an AppScan Source project file (.ppf) with all configuration information.
  - Modifying application and project properties
    When you select an application or project in the Explorer view, the current properties appear in the Properties view, where you can make modifications.
  - Global attributes
    Global attributes must be defined before they can be associated with individual applications. Global attributes are defined in the Properties view by selecting All Applications in the Explorer view.
  - Application attributes
    Application attributes apply to the currently-selected application and depend on previously created global attributes.
  - Removing applications and projects
    You can remove applications and projects from AppScan® Source for Analysis if they are not registered.
  - Explorer view
    The Explorer view contains a Quick Start section at the top - and an explorer section at the bottom which contains one node, All Applications. The Quick Start section contains several useful links that launch common actions. The explorer section consists of a tree pane that provides a hierarchical view of your resources: applications, projects, directories, and project files, with All Applications as its root. You navigate these resources much like a file browser. As you navigate the view, the selection state of the tree determines the available tabs in the Properties view.
- Preferences
  Preferences are personal choices about the appearance and operation of AppScan® Source for Analysis.
Administering
Learn how to administer the product.
Developing
Learn how to develop by using the product.
Extending product function
Learn how to extend the product.
Reference
Review reference information for the product.
Troubleshooting and support
There are a number of self-help information resources and tools to help you troubleshoot problems.

Adding an existing application with user interface actions

Procedure

Complete one of these actions:
- Select File > Add Application > Open an existing application from the main workbench menu.
- In the Explorer view toolbar, click the Add Application Menu down-arrow button and select Open an existing application from the menu.
- In the Explorer view, right-click All Applications and then select Add Application > Open an existing application from the menu.
Select the directory that contains the saved application file (.paf, .sln, .dsw, or .ewf).

Note: To learn which versions of imported files are supported by AppScan® Source for Analysis, AppScan® Source for Automation, and the AppScan® Source command line interface, see System requirements and installation prerequisites. At this page, select the tab for the version of AppScan® Source that you are using - and then select the AppScan® Source component that you are using. If AppScan® Source supports opening and scanning files from other development environments, that support is listed in the Compilers and Languages section of the Supported Software tab.
Open the application file or directory.