Changing the Starting URL host

You can change the host, scheme, or port in the Starting URL of a configured scan, without re-recording the login, multi-step operations, or manual explore data.

About this task

If you have already recorded a login, multi-step operations, and/or a Manual Explore - and then the host, scheme or port of your Starting URL changes - requests and responses in these recordings must be updated and verified. Click Scan > Change Host/Scheme/Port to open a dialog box from which you can change the URL, and get AppScan to automatically update, verify and confirm the necessary changes.

The dialog box shows the steps being performed, and indicates when each step is successful. If the update process does not complete successfully, the dialog box indicates which step failed, and gives you the option to save the changes and proceed manually, or undo all changes.
Important: In some cases AppScan may update responses incorrectly, and part or all of the scan will fail. If that happens you will need to re-record the problematic procedures.
Note: Although Manual Explore data is updated, Automatic Explore data, and scan results, are deleted when you change the Starting URL.
Note: This option can be used to change only the host, scheme, or port of only the Starting URL. If you need to make other changes to the Starting URL, or change the host, scheme or port for one of the Additional Domains in the scan, you cannot use this option. Instead, save the scan as a template, and use that to create a new scan.

Procedure

  1. Open the scan (.scan) or scan template (.scant) file and then:
    • For a scan template: On the toolbar, click Scan Configuration > URL and Servers.
    • For a configured scan: On the menubar, click Scan > Change Host/Scheme/Port.
  2. Change the host, scheme or port of Starting URL as needed.

    AppScan attempts to connect to the server and a green check mark indicates that this succeeded.

  3. Click OK.

    AppScan attempts to update the configuration, and a green check mark indicates each step that completes successfully.

  4. If all steps succeed: Click OK to save the configuration changes.
    If one of the steps fails:
    • To save the configuration changes, complete the failed step manually, and try again, click OK.
    • To undo all changes and revert to the original Starting URL, click Cancel.
    Important: In some cases AppScan may update responses incorrectly, and part or all of the scan will fail. If that happens you will need to re-record the problematic procedures.