Home
Administering
Learn how to administer user accounts and permissions, audit user activity, and manage integrations in HCL® AppScan® Source.
Administering AppScan® Source
This section explains user management, permissions, application and project registration, and port configuration.
Creating AppScan® Source users
Typically, administrators will have users log in to AppScan® Source products with their AppScan Enterprise Server credentials. However, if there is cause for having AppScan Source users that do not exist in the AppScan Enterprise Server, administrators can create local AppScan Source users, according to the instructions in this topic.
Configuring automatic login of AppScan® Enterprise Server users
By default, AppScan® Enterprise Server users can log in to AppScan Source and automatically be added to the AppScan Source Database (these users will be listed as AppScan Enterprise Server users). This feature can be configured in the AppScan Source for Analysis user interface according to the instructions in this topic.

Welcome
Welcome to the documentation for HCL® AppScan® Source.
What's New
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, upgrade, and activate HCL® AppScan® Source.
Configuring
Learn how to configure applications and projects, and set attributes and properties in HCL® AppScan® Source.
Administering
Learn how to administer user accounts and permissions, audit user activity, and manage integrations in HCL® AppScan® Source.
- Administering AppScan® Source
  This section explains user management, permissions, application and project registration, and port configuration.
  - User accounts and permissions
    Before AppScan® Source users can begin to scan or triage results, an administrator must create user accounts and assign permissions to the accounts.
  - Using AppScan® Source for Analysis in standalone mode
    You can use AppScan® Source for Analysis while not connected to an AppScan Enterprise or the AppScan Database Service. However, you will be unable to share scans or assessments with other AppScan Source clients.
  - Creating AppScan® Source users
    Typically, administrators will have users log in to AppScan® Source products with their AppScan Enterprise Server credentials. However, if there is cause for having AppScan Source users that do not exist in the AppScan Enterprise Server, administrators can create local AppScan Source users, according to the instructions in this topic.
    - AppScan® Enterprise Server authentication: Migration considerations for replacement of the IBM® Rational® Jazz™ user authentication component with IBM® WebSphere® Liberty
      This topic describes user management-related migration considerations that you may need to consider if you are upgrading from a previous version of AppScan® Enterprise Server.
    - Configuring automatic login of AppScan® Enterprise Server users
      By default, AppScan® Enterprise Server users can log in to AppScan Source and automatically be added to the AppScan Source Database (these users will be listed as AppScan Enterprise Server users). This feature can be configured in the AppScan Source for Analysis user interface according to the instructions in this topic.
    - Creating local product administrator users in AppScan® Enterprise Server Liberty
      As of AppScan® Enterprise Server Version 9.0.1, you have the ability to create a local product administrator user in AppScan Enterprise Server Liberty in order to administer AppScan Source. After the user is created, the AppScan Source Database must be registered with AppScan Enterprise Server using the administrator credentials.
    - Creating a user account for the Automation Server
      A user account is required for Automation Server use. This user account must be registered with the Automation Server during installation or by command line post-installation. A corresponding AppScan® Source user account must also then be created manually post-installation with AppScan Source for Analysis or the AppScan Source command line interface (CLI). This topic describes creating this account using AppScan Source for Analysis.
- Auditing user activity
  AppScan® Source offers a convenient location for auditing user activity. The Audit view logs events such as authentication to the AppScan Enterprise Server, the creation of new users, and the creation of new rules in the database.
- Logging in to AppScan® Enterprise Server from AppScan® Source products
  Most AppScan® Source products and components require a connection to an AppScan Enterprise Server. The server provides centralized user management capabilities and a mechanism for sharing assessments. All user management occurs in AppScan Enterprise.
- LDAP integration
  To add an AppScan® Source user that will be authenticated via LDAP, you must have configured the AppScan Enterprise Server user repository to use an LDAP repository.
- Registering applications and projects for publishing to AppScan® Source
- 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.
- Port configuration
Scanning
This section explains how to scan your source code and manage assessments in HCL® AppScan® Source.
Triage and analysis
Grouping similar findings allows security analysts or IT auditors to segment and triage source code problems. This section explains how to triage AppScan® Source assessments and analyze results.
Reporting
Security analysts and risk managers can access reports of select findings or a series of audit reports that measure compliance with software security best practices and regulatory requirements. This section explains how to create reports of aggregate finding data.
Extending product function
Learn how to extend the product to meet specific development requirements.
Reference
Review reference information for HCL® AppScan® Source, including using utilities, plug-ins, and APIs.
Troubleshooting and support
Self-help information, resources, and tools to help you troubleshoot issues while using HCL® AppScan® Source.

Configuring automatic login of AppScan® Enterprise Server users

By default, AppScan® Enterprise Server users can log in to AppScan® Source and automatically be added to the AppScan® Source Database (these users will be listed as AppScan® Enterprise Server users). This feature can be configured in the AppScan® Source for Analysis user interface according to the instructions in this topic.

Procedure

From the AppScan® Source for Analysis Admin menu, click Manage Users.
In the Manage Users dialog box, click the Configure login for AppScan Enterprise Server users link.
The Configure AppScan® Enterprise Server User Login dialog box allows you to enable this feature - and set initial permissions for AppScan® Enterprise Server users:
- By default, AppScan® Enterprise Server users can log in to AppScan® Source. To disable this feature, deselect the Permit login by AppScan Enterprise Server users check box.
- By default, AppScan® Enterprise Server users have these permissions when logging in to AppScan® Source:
  - Register
  - Scan
  - View Registered
  - Manage Attributes
  - Apply Attributes
  - Save Assessments
  Expand the Permissions tree and select the check boxes that identify the appropriate initial settings for AppScan® Enterprise Server users. See User accounts and permissions for a list of all available permissions.
Click OK to close the Configure AppScan® Enterprise Server User Login dialog box - and then Close the Manage Users dialog box.

Results

The first time an AppScan® Enterprise Server user logs in to AppScan® Source, an AppScan® Source user account will be created with the same authentication credentials that are used for logging in to the AppScan® Enterprise Server. After the account is created, you can modify it (for example, modify its permissions).

If you disable this feature, AppScan® Enterprise Server users will need to be created manually by following the instructions in Creating AppScan Source users.