Manage Agent Scans

Required Tenable Security Center User Role: Organizational user with appropriate permissions. For more information, see User Roles.

For more information about agent scans, see Agent Scans and Agent Scan Settings.

Add an Agent Scan

You can create agent scans in Tenable Security Center using the Advanced Agent Scan template. For more information, see Scan Policy Templates.

Note: If you are scanning a Linux machine with Tenable Security Center, the Linux machine's shell configuration file must have a PS1 variable of four or more characters (for example, PS1='\u@\h:~\$ '). Having a PS1 variable of less than four characters (for example, PS1='\$ ') can drastically increase the overall scan time.

Before you begin:

  • Confirm you understand the complete agent scanning configuration process, as described in Agent Scanning.

  • (Optional) Configure an Advanced Agent Scan policy template, as described in Manage Scan Policies.

To add an agent scan:

  1. Log in to Tenable Security Center via the user interface.

  2. In the left navigation, click Scans > Agent Scans.

    The Agent Scans page appears.

  3. At the top of the table, click Add.

    The Add Agent Scan page appears.

  4. Click General.

  5. Type a Name for the scan.

  6. (Optional) Type a Description for the scan.

  7. (Optional) To reference an Advanced Agent Scan policy in the scan:

    1. Click Custom Policy to enable the toggle.

    2. In the Policy drop-down menu, select the Advanced Agent Scan policy.

  8. Select an Agent Scanner.

  9. Select one or more Agent Groups.

  10. Select a Scan Window.

  11. (Optional) Select a Schedule for the scan.

  12. Click Settings.

  13. Select an Import Repository for the scan.

  14. (Optional) Click Post Scan.

    • If you want to configure automatic report generation, click Add Report. For more information, see Add a Report to a Scan.

  15. Click Submit.

    Tenable Security Center saves your configuration.

What to do next: 

View Agent Scans

To view your agent scans:

  1. Log in to Tenable Security Center via the user interface.

  2. Click Scans > Agent Scans.

    The Agent Scans page appears.

  3. To filter the scans that appear on the page, apply a filter as described in Apply a Filter.

  4. To view details for a scan:

    1. Right-click the row for the scan.

      The actions menu appears.

      -or-

      Select the check box for the scan.

      The available actions appear at the top of the table.

    2. Click View.

      The View Agent Scan page appears.

Start or Pause an Agent Scan

To start or pause an agent scan:

  1. Log in to Tenable Security Center via the user interface.

  2. Click Scans > Agent Scans.

    The Agent Scans page appears.

  3. To filter the scans that appear on the page, apply a filter as described in Apply a Filter.

  4. To start or pause an agent scan, see Start or Pause a Scan.

Edit an Agent Scan

To edit an agent scan:

  1. Log in to Tenable Security Center via the user interface.

  2. Click Scans > Agent Scans.

    The Agent Scans page appears.

  3. To filter the scans that appear on the page, apply a filter as described in Apply a Filter.
  4. Right-click the row for the scan.

    The actions menu appears.

    -or-

    Select the check box for the scan.

    The available actions appear at the top of the table.

  5. Click Edit.

    The Edit Agent Scan page appears.

  6. Modify the scan options. For more information, see Agent Scan Settings.

  7. Click Submit.

    Tenable Security Center saves your configuration.

Delete an Agent Scan

To delete an agent scan:

  1. Log in to Tenable Security Center via the user interface.

  2. Click Scans > Agent Scans.

    The Agent Scans page appears.

  3. To filter the scans that appear on the page, apply a filter as described in Apply a Filter.
  4. To delete a scan:

    1. Right-click the row for the scan.

      The actions menu appears.

      -or-

      Select the check box for the scan.

      The available actions appear at the top of the table.

    2. Click Delete.

      Tenable Security Center deletes the scan.

  5. To delete multiple scans:

    1. In the table, select the check box for each scan you want to delete.

      The available actions appear at the top of the table.

    2. At the top of the table, click Delete.

      A confirmation window appears.

    3. Click Delete.

      Tenable Security Center deletes the scans.