SSH Integration

Complete the following steps to configure SSH credentialed network scans using BeyondTrust.

To integrate Tenable Nessus with BeyondTrust using Windows:

1. Log in to your Tenable user interface.

2. In the upper-left corner, click the button.

   The left navigation plane appears.

3. In the left navigation plane, click Scans.

   The Scans page appears.

4. In the upper-right corner of the page, click the Create a Scan button.

   The Select a Scan Template page appears.

5. Select a scan template.

   The scan configuration page appears.

6. In the Name box, type a name for the scan.

7. In the Targets box, type an IP address, hostname, or range of IP addresses.
8. (Optional) Add a description, folder location, scanner location, and specify target groups.

9. Click the Credentials tab.

   The Credentials pane appears.

10. In the Select a Credential menu, select the Host drop-down.

11. Select SSH.

    The Settings pane appears.

12. In the Auth Type drop-down box, click Nessus for BeyondTrust.

    The Nessus for BeyondTrust options appear.

13. Configure each option for the SSH authentication.

    Option	Description	Required
    Username	The username to log in to the hosts you want to scan.	yes
    BeyondTrust host	The BeyondTrust IP address or DNS address.	yes
    BeyondTrust port	The port on which BeyondTrust listens.	yes
    BeyondTrust API user	The API user provided by BeyondTrust.	yes
    BeyondTrust API key	The API key provided by BeyondTrust.	yes
    Checkout duration	The length of time, in minutes, that you want to keep credentials checked out in BeyondTrust. Configure the Checkout duration to exceed the typical duration of your Tenable Nessus scans. If a password from a previous scan is still checked out when a new scan begins, the new scan fails. Note: Configure the password change interval in BeyondTrust so that password changes do not disrupt your Tenable Nessus scans. If BeyondTrust changes a password during a scan, the scan fails.	yes
    Use SSL	When enabled, Tenable Nessus uses SSL through IIS for secure communications. You must configure SSL through IIS in BeyondTrust before enabling this option.	no
    Verify SSL certificate	When enabled, Tenable Nessus validates the SSL certificate. You must configure SSL through IIS in BeyondTrust before enabling this option.	no
    Use private key	When enabled, Tenable Nessus uses private key-based authentication for SSH connections instead of password authentication. If it fails, the password is requested.	no
    Use privilege escalation	When enabled, BeyondTrust uses the configured privilege escalation command. If it returns something, it will use it for the scan.	no
    Custom password prompt	The password prompt used by the target host. Only use this setting when an interactive SSH session fails due to Tenable Nessus receiving an unrecognized password prompt on the target host's interactive SSH shell.	no
    Targets to prioritize credentials	Specify IPs or CIDR blocks on which this credential is attempted before any other credential. To specify multiple IPs or CIDR blocks, use a comma or space-separated list. Using this setting can decrease scan times by prioritizing a credential that you know works against your selected targets. For example, if your scan specifies 100 credentials, and the successful credential is the 59th credential out of 100, the first 58 credentials have to fail before the 59th credential succeeds. If you use Targets To Prioritize Credentials, you configure the scan to use the successful credential first, which allows the scan to access the target faster.	no

14. Do one of the following:

    • If you want to save without launching the scan, click Save.

    • If you want to save and launch the scan immediately, click Save & Launch.

      Note: If you scheduled the scan to run at a later time, the Save & Launch option is not available.