HCL AppScan Enterprise License setup

AppScan products supports HCL licenses. As of this version, all new licenses issued will be HCL licenses.

This document describes how to set up HCL AppScan Enterprise licenses. The following are the types of HCL product licenses:

  • HCL AppScan Enterprise Dynamic Analysis Users Per Floating User Single Install
  • HCL AppScan Enterprise Reporting Only User FU Single Install
  • HCL AppScan Enterprise Dynamic Analysis Users Per Authorized User Single Install
  • HCL AppScan Enterprise Reporting Only User AU Single Install
  • HCL AppScan Enterprise Dynamic Analysis Scanner Per Install
  • HCL AppScan Enterprise Server Basic Per Install
  • HCL AppScan Enterprise Server Per Install
Note: In HCL Licensing, the scanners licenses are provided by AppScan Enterprise server hence the Agents need to contact the AppScan Enterprise server via HTTP. The port 9443 is configured as the default port during AppScan Enterprise Server installation and should be accessible from the Scanner machine.

Setup Cloud License Server for AppScan Enterprise

Note: For using cloud license server, AppScan must have access to domain - hclsoftware.compliance.flexnetoperations.com.

Forms are submitted as in the following table when 1 and either 2 or 3 of the following statements are true:

  1. Login to the Flexnet End-User Portal using the email address that appears in your invitation. If this is your first login, reset your password. The License & Delivery Portal page is displayed.
  2. On the Activation & Entitlements menu, click List Entitlements to view available licenses.
  3. Create Cloud license server:
    1. On the Devices menu, click Devices. The Devices page is displayed.
    2. Click Create Device. The New Device dialog box is displayed.
    3. In the Name* box, type a device name for your reference.
    4. Select the Runs license server? check box.
    5. In the Server deployment option, click Cloud.
    6. Leave the Site name: blank.
    7. Click Save to save and close the dialog box. The new server's View Server page is displayed.
  4. Set the password required to access the new server in the View Server page.
    1. From the Actions drop-down list, click Set Password.
    2. Set the password that is required to access server from AppScan, and click Set Password.

      The AppScan users use this password to access the cloud license server.

      Note: Copy and save the License Server ID displayed on this page to use while configuring the cloud server in AppScan Enterprise.
  5. Mapping licenses to the server on the View Server page:
    1. From the Actions drop-down list, click Map Entitlements. The Map Entitlements page is displayed. All the available licenses you can assign for the new server are listed on this page.

      Map%20Entitlement

    2. In the Qty to add column, enter the number of license you want assign to the new server in a cell corresponding to product license type.
    3. Click Save to save the mapping entitlement.

    After you complete the Cloud server setup, you must configure this new server in AppScan Enterprise.

  6. Configure cloud license server in AppScan Enterprise:
    1. Launch the configuration wizard.
    2. Open the license dialog box.
    3. Click HCL License > HCL Cloud License.
    4. Select Cloud License Server. The Server Configuration Wizard dialog box is displayed.

      Server%20Configuration%20Wizard

    5. Enter the License Server ID you had noted during server creation.
    6. Enter the password you have set for this server.
    7. Click Add Proxy, if proxy support is required to connect to the license server.

      Add%20Proxy

    8. To use proxy from Internet Explorer (IE) browser:
      1. Click Use proxy from IE Browser to retrieve proxy details from the IE browser.
      2. Enter authentication details, if required.
      3. Complete the proxy setup.
    9. To manually setup proxy:
      1. Click Manually enter proxy details.
      2. Enter the authentication details manually.
      3. Complete the proxy setup.

Setup Local License Server for AppScan Enterprise

  1. Obtain the Local Host ID for the machine where local license server has been configured:
    1. Run ipconfig /all.
    2. Get values of Physical Address from “Ethernet adapter Ethernet. For example: 54-E1-AD-30-57-7C.
    3. Remove all “-“.

      The ID is saved to your clipboard.

  2. Refer to the Local_License_Server document to configure local license server.
  3. Login to the Flexnet End-User Portal using the email address that appears in your invitation. If this is your first login, reset your password. The License & Delivery Portal page is displayed.
  4. On the Activation & Entitlements menu, click List entitlements to view available licenses.
  5. Create node-locked device:
    1. On the Devices menu, click Devices. The Devices page is displayed.
    2. Click Create Device. The New Device dialog box is displayed.
    3. In the Name* box, type a device name for your reference.
    4. Select the Runs license server? check box.
    5. In the Server Deployment options, click Local.
    6. For ID type, select ETHERNET.
    7. In the ID field, paste the Local Host ID from the clipboard you had copied.
    8. Leave the Site name: blank.
    9. Click Save to save and close the dialog box. The new server's View Server page is displayed.
  6. Mapping licenses to the server on the View Server page:
    1. From the Actions drop-down list, click Map Entitlements. The Map Entitlements page is displayed. All the available licenses you can assign for the new server are listed on this page.
    2. In the Qty to add column, enter the number of license you want assign to this new server in the cell corresponding to a product license type.
      Note: It is recommended to utilize and assign only required number of product licenses, as the license is valid for only one machine. Assigning more than required number of licenses may make the license numbers unavailable for next usage.
    3. Click Save to save the mapping entitlement.

    After you complete the local server setup, you must configure this new server in AppScan Enterprise.

  7. Configure the local license server in AppScan Enterprise:
    1. Launch the configuration wizard.
    2. Open the license dialog box.
    3. Click HCL License > HCL Local License.
    4. Select Local License Server. The Server Configuration Wizard dialog box is displayed.

      Server%20Configuration%20Wizard

    5. Enter the License Server IP and Port you had noted during server creation.
    6. Enter the password set for this server.
    7. Click Add Proxy, if proxy support is required to connect to the license server.

      Add%20Proxy

    8. To use proxy from Internet Explorer (IE) browser:
      1. Click Use proxy from IE Browser to retrieve proxy details from the IE browser.
      2. Enter authentication details, if required.
      3. Complete the proxy setup.
    9. To manually setup proxy:
      1. Click Manually enter proxy details.
      2. Enter the authentication details manually.
      3. Complete the proxy setup.

Migrating AppScan Enterprise Licenses from IBM License to HCL License

Existing customers using IBM/Rational licenses must upgrade licenses from IBM/Rational to HCL licenses. For more information on upgrading scenarios of IBM License to HCL License, see HCL License support scenarios for AppScan Enterprise V10.0.3 installation and upgrade.

Note:
  • Hybrid configuration for licenses is NOT supported, hence it is recommended to run the configuration wizard for every component of AppScan Enterprise (Server and DAST Scanners).
  • In HCL Licensing, the scanners licenses are provided by AppScan Enterprise server hence the Agents need to contact the AppScan Enterprise server via HTTP. The port 9443 is configured as the default port during AppScan Enterprise Server installation and should be accessible from the Scanner machine.