Scheduling a Scan

There are two locations for scan scheduling in the WhiteHat Portal:

  • The Assets Tab

  • The Action Items Tab

From the Assets Tab

Setting a Schedule for a Single Site Asset

To schedule a scan for a site asset, perform the following steps:

  1. From the main WhiteHat Portal menu, select Assets.

    schedule scan 1

  2. Optionally, click the Filter button to set filters for the site assets with Scan Setup Issues.

  3. Select an asset from the Asset Management table.

  4. Click the Scan tab.

  5. Click Scan Schedule.

    schedule scan 2

  6. Click the Schedule dropdown and select an option from:

    • Not Scheduled / Stopped (not recommended)

    • Continuous (24/7 scanning: recommended)

    • Nights 8P-6A, and Weekends 24hrs (Nights from 8pm to 6am, and continuously from Friday evening to Monday morning)

    • Customize

      Custom schedules can only be set for single assets.
      schedule scan 3

  7. Click the Maximum Scan Speed dropdown and select an option from:

    • Very Fast: Unlimited requests/second

    • Fast: 8 requests/second

    • Medium: 4 requests/second

    • Slow: 2 requests/second

    • Very Slow: 1 request/second

      The Maximum Scan Speed value is required for Sites. This sets a limit on the number of requests per second that will be sent by Synopsys, ensuring that there is no noticeable impact to your network during a scan.

  8. Click Add to add this scan schedule to this asset. The scan will commence at the next scheduled time.

Setting a Schedule for a Single Application Asset

To schedule a scan for a application asset, perform the following steps:

  1. From the main WhiteHat Portal menu, select Assets.

    schedule scan app 1

  2. Optionally, click the Filter button to set filters for the applications with Scan Setup Issues.

  3. Select an asset from the Asset Management table.

  4. Click the Scan tab.

  5. Click Scan Schedule.

    schedule scan app 2

  6. Click the When to Scan Application dropdown and select an option from:

    • Never Scan (not recommended)

    • Scan Now (initiate a single scan immediately, note that a maximum of five scans may be queued for a given application)

    • Scan Daily (select a start time)

    • Scan Weekly (select a start day and time)

      schedule scan app 3

  7. Click the Weekday dropdown and select an option from:

    • Monday

    • Tuesday

    • Wednesday

    • Thursday

    • Friday

    • Saturday

    • Sunday

  8. Enter the hour and minute and select either AM or PM from the Start Scan at dropdown. This is the set time the daily or weekly scans will commence.

  9. Click the Time Zone dropdown and select a timezone to apply to the start scan time.

    The Time Zone is essential because it is based on this time zone that the schedule will be applied — that is, if a scan is set to begin at 8:00 p.m. and the time zone is set to GMT, but the computer on which the asset is to be found is running on Pacific time, the scan will nevertheless begin at 8:00 p.m. GMT.

  10. Click Add to add this scan schedule to this asset. The scan will commence at the next scheduled time.

Setting a Custom Schedule

No asset may be associated to more than one schedule, and changing the schedule for an asset will remove any previous association.

To set a custom schedule,

  1. Select Customize as the Schedule.

    schedule scan custom 1

  2. Click the Time Zone dropdown and select a timezone to apply to the start scan time.

  3. Click the Maximum Scan Speed dropdown and select an option from:

    • Very Fast: Unlimited requests/second

    • Fast: 8 requests/second

    • Medium: 4 requests/second

    • Slow: 2 requests/second

    • Very Slow: 1 request/second

  4. Type a schedule name in the Custom Schedule Name text field.

  5. The interface will now show you a schedule by day and hour. Click the days and hours during which you would like scans to run, you can click and drag to select multiple hours or days at once.

    Scans will run only during the highlighted time periods. If a scan is incomplete when the schedule ends, it will be suspended until the next permissible (highlighted) point in the scan schedule.

  6. Click Add to add this scan schedule to this asset. The scan will commence at the next scheduled time.

Setting a Schedule for Multiple Assets

From the Assets tab, you can set a schedule for a specific asset or for several assets at once.

To schedule a scan for multiple assets, perform the following steps:

  1. From the main WhiteHat Portal menu, select Assets.

    schedule scan bulk 1

  2. Optionally, click the Filter button to set filters for the assets with Scan Setup Issues.

  3. Select multiple assets from the Asset Management table by selecting the checkbox to the left of the asset name.

  4. Click the Bulk Actions button to display a list of possible actions you can take.

  5. Select Scan Schedule.

  6. Click the Schedule dropdown for sites and APIs and select an option from:

    • Never Scan (not recommended)

    • Continuous (24/7 scanning: recommended)

    • Nights 8P-6A, and Weekends 24hrs (Select a timezone)

      schedule scan bulk 2

  7. Click the Schedule dropdown for applications and select an option from:

    • Never Scan (not recommended)

    • Scan Now (initiate a single scan immediately, note that a maximum of five scans may be queued for a given application)

    • Scan Daily (select a start time)

    • Scan Weekly (select a start day and time)

  8. Click Save to add the scan schedules to the selected assets. The scan will commence at the next scheduled time.

    Mobile application scans cannot be scheduled. They are scanned as soon as the associated application file is uploaded, or by requesting a scan from the asset Scan tab.

From the Action Items Tab

To schedule a scan from the Action Items page, perform the following steps:

  1. From the Action Items page, click on Needs Schedule.

  2. The scheduling popup is displayed.

  3. From there, establish the schedule as described in Scheduling Sites or Scheduling Applications.