Welcome
Administration
Define users, applications, policies, and configure DevOps integrations.
DevOps
Tools for incorporating AppScan 360° in your software development lifecycle.
REST API
The built-in REST API interface provides you with a way to visualize RESTful web services. The API documentation is built using Swagger, where you can test API operations and instantly view the results to help you scan your applications faster.

Getting started
Welcome to the documentation for HCL AppScan 360°, where you can find information about how to install, maintain, and use this service.
Installation
Learn about AppScan 360° architecture and how to install the product.
Navigation
This section describes the items on the main AppScan 360° menu bar, with links to more detailed information.
Administration
Define users, applications, policies, and configure DevOps integrations.
- Users
  User management allows you to control access to sensitive applications by assigning them to asset groups and then adding specific users to those groups.
- Applications
  An application is a collection of scans related to the same project. It can be a web site, a desktop app, a mobile app, a web service, or any component of an app. Applications enable you to asses risk, identify trends, and make sure that your project is compliant with industry and organization policies.
- Compliance policies
  You can apply the predefined compliance policies, as well as your own custom compliance policies, to show only data for the issues that are relevant for you.
- DevOps
  Tools for incorporating AppScan 360° in your software development lifecycle.
  - REST API
    The built-in REST API interface provides you with a way to visualize RESTful web services. The API documentation is built using Swagger, where you can test API operations and instantly view the results to help you scan your applications faster.
    - Generating API Keys
      Use a Key ID and Key Secret to access the AppScan 360° REST APIs and to log in from some of the AppScan 360° client tools (for example, from the Jenkins plug-in and from the Static Analyzer Command Line Utility and IDE plug-ins).
    - OData
      This section provides information and tips for using Open Data Protocol (OData) through the AppScan 360° API.
    - Export to CSV
      This section describes how to save response data as in CSV format.
  - Webhooks
    Webhooks can be used to receive notifications about events that occur in AppScan 360°.
  - Environment status API
    The environment status API provides a way to monitor environment health and resource availability. The API documentation is built using Swagger, where you can test API operations and instantly view the results to help you maintain the health of your AppScan 360° environment.
  - Integrations
- Personal scans
  A personal scan is a way of evaluating the relative security of an application in development without affecting overall application scan data (issues, for example), or compliance.
- Scan status
- Audit trail
  The audit trail (Organization > Audit trail) logs user activity.
Dynamic analysis
HCL AppScan 360° performs security scans for web-applications for production, staging and development environments.
Interactive monitoring
Using an agent installed on your application, AppScan 360° identifies security vulnerabilities in your application during runtime by monitoring all interactions, both legitimate and malicious. The process is "passive," in the sense that IAST does not send its own tests, and can therefore run indefinitely.
Software Composition Analysis
Use Software Composition Analysis (SCA) to scan for security vulnerabilities in open source and third-party packages used by your code. SCA includes Intelligent Finding Analytics (IFA) and Intelligent Code Analytics (ICA).
Static analysis
Use static analysis (SAST) to scan for security vulnerabilities in web and desktop applications. Static analysis includes Intelligent Finding Analytics (IFA) and Intelligent Code Analytics (ICA).
Results
The Scans and Sessions page lists the scans under the categories DAST, SAST, SCA, and IAST, where you can view your scan results, including scan statistics. To view, rescan, or download reports, select a scan.The Scans and Sessions page lists scans under the categories where you can view your scan results, including scan statistics. To view, rescan, or download reports, select a scan.
Reference
Some frequently asked questions, and information about integrating AppScan 360° into the product lifecycle (SDLC).

REST API

The built-in REST API interface provides you with a way to visualize RESTful web services. The API documentation is built using Swagger, where you can test API operations and instantly view the results to help you scan your applications faster.

About this task

Learn how to use the interactive framework by following this example to import an application inventory by using the /api/v4/Apps/ImportFile REST API.

Procedure

Select Tools > API.
Click the Swagger link on the right side of the page. You are automatically logged in to Swagger.
Create an asset group:
1. Expand the Asset Groups API and click POST /api/v4/AssetGroups.
2. Replace the "string" parameters with a name and description for the asset group. Keep the quotation marks.
3. Click Execute.
4. Make note of the ID in the Response Body section; you'll need to use that ID in the next API.
Import an application inventory file:
1. Expand the Applications API and click POST /api/v4/Apps/ImportFile.
  In the Implementation section, there is a sample file that you can download to get a sense of the types of attributes to include in your file.
2. Enter the assetGroupId from step 3d in the Value field of the Parameters section.
3. Click Browse in the uploadedFile section to locate your CSV file of applications to import.
4. Click Execute.
  A successful import appears as follows:

Example

Importing scan files, including the results using REST API

You can import a scan file, including the results, without running the scan in AppScan 360° by following these steps:

Make sure you are logged in to Swagger using the API: api/v4/Account/ApiKeyLogin.
Upload the scan file using the API: api/v4/FileUpload and save the FileId for later. For example,
"FileId": "274bd3a7-a231-41d0-80f6-d22d684af50d"
Expand the Scans API and click POST /api/v4/Scans/Dast. Update the following parameters to generate only the reports without running the scan.
1. ScanOrTemplateFileId:: Update the FileId you copied in step 2.
  "ScanOrTemplateFileId": "274bd3a7-a231-41d0-80f6-d22d684af50d"
2. TestOperation: Set this to ReportOnly
  "TestOperation": "ReportOnly"
Note: Make sure you have mapped the AppID, ScanName, and other required parameters to run the API POST /api/v4/Scans/Dast.