SSH Integration

Tenable provides full SSH support for QiAnXin integrations. Complete the following steps to configure SSH credentials for scans with QiAnXin.

For more information on Tenable scans, see the Nessus User Guide, the Tenable Vulnerability Management User Guide, or the Tenable Security Center User Guide.

  1. Log in to your Tenable user interface.

  2. In the upper-left corner, click the Menu 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 QiAnXin.

    The QiAnXin options appear.

  13. Configure each option for the SSH authentication.

    Option Description Required

    QiAnXin Host

    The IP address or url for the QiAnXin host.

    yes

    QiAnXin Port

    The port on which the QiAnXin API communicates. By default, Tenable uses 443.

    yes

    QiAnXin API Client ID

    The Client ID for the embedded account application created in QiAnXin PAM.

    yes

    QiAnXin API Secret ID

    QiAnXin API Client Secret

    		 The Secret ID for the embedded account application created in QiAnXin PAM.

    yes

    QiAnXin Username

    		 The username to log in to the hosts you want to scan. yes

    Host IP

    QiAnXin Asset Address

    		 Specify the host IP of the asset containing the account to use. If not specified, the scan target IP is used. no

    QiAnXin Asset Platform

    Specify the platform (based on asset type) of the asset containing the account to use. If not specified, a default target is used based on credential type (for example, for Windows credentials, the default is WINDOWS). Possible values:

    • ACTIVE_DIRECTORY — Windows Domain Account

    • WINDOWS — Windows Local Account

    • LINUX — Linux Account

    • SQL_SERVER — SQL Server Database

    • ORACLE — Oracle Database

    • MYSQL — MySQL Database

    • DB2 — DB2 Database

    • HP_UNIX — HP Unix

    • SOLARIS — Solaris

    • OPENLDAP — OpenLDAP

    • POSTGRESQL — PostgreSQL

    		 no

    QiAnXin Region ID

    		 Specify the region ID of the asset containing the account to use. Only if using multiple regions
    Escalate Privileges with

    Use the drop-down menu to select the privilege elevation method, or select “Nothing” to skip privilege elevation.

    Note: Tenable supports multiple options for privilege escalation, including su, su+sudo and sudo. For example, if you select sudo, more fields for sudo user, Escalation Account Name, and Location of su and sudo (directory) are provided and can be completed to support authentication and privilege escalation through QiAnXin. The Escalation Account Name field is only required if the escalation password differs from the normal login password.

    Note: For more information about supported privilege escalation types and their accompanying fields, see the Nessus User Guide or the Tenable Vulnerability Management User Guide.

    		Required if you wish to escalate privileges.
    Escalation Account Username If the escalation account has a different username or password from the least privileged user, enter the credential ID or identifier for the escalation account credential here. no
    Use SSL When enabled, Tenable uses SSL for secure communication. This is enabled by default.

    no

    Verify SSL Certificate

    When enabled, Tenable verifies that the SSL Certificate on the server is signed by a trusted CA.

    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
    Privilege Escalation The privilege escalation method you want to use to increase users' privileges after initial authentication. Your Privilege Escalation selection determines the specific options you must configure. For more information, see Privilege Escalation. 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.

  1. Log in to Tenable Security Center.

  2. Click Scanning > Credentials (administrator users) or Scans > Credentials (organizational users).

    The Credentials page appears.

  3. Click Add.

    The Credential Templates page appears.

  4. In the Miscellaneous, API Gateway, Database, SNMP, SSH, or Windows, or Web Authentication sections, click the tile for the specific method you want to configure.

    The Add Credentials configuration page appears.

  5. In the Name box, type a name for the credentials.
  6. In the Description box, type a description for the credentials.
  7. (Optional) Type or select a Tag. For more information, see Tags in the Tenable Security Center User Guide.

  8. Configure each option for the SSH authentication.

    Option Description Required

    QiAnXin Host

    The IP address or url for the QiAnXin host.

    yes

    QiAnXin Port

    The port on which the QiAnXin API communicates. By default, Tenable uses 443.

    yes

    QiAnXin API Client ID

    The Client ID for the embedded account application created in QiAnXin PAM.

    yes

    QiAnXin API Secret ID

    QiAnXin API Client Secret

    		 The Secret ID for the embedded account application created in QiAnXin PAM.

    yes

    QiAnXin Username

    		 The username to log in to the hosts you want to scan. yes

    Host IP

    QiAnXin Asset Address

    		 Specify the host IP of the asset containing the account to use. If not specified, the scan target IP is used. no

    QiAnXin Asset Platform

    Specify the platform (based on asset type) of the asset containing the account to use. If not specified, a default target is used based on credential type (for example, for Windows credentials, the default is WINDOWS). Possible values:

    • ACTIVE_DIRECTORY — Windows Domain Account

    • WINDOWS — Windows Local Account

    • LINUX — Linux Account

    • SQL_SERVER — SQL Server Database

    • ORACLE — Oracle Database

    • MYSQL — MySQL Database

    • DB2 — DB2 Database

    • HP_UNIX — HP Unix

    • SOLARIS — Solaris

    • OPENLDAP — OpenLDAP

    • POSTGRESQL — PostgreSQL

    		 no

    QiAnXin Region ID

    		 Specify the region ID of the asset containing the account to use. Only if using multiple regions
    Escalate Privileges with

    Use the drop-down menu to select the privilege elevation method, or select “Nothing” to skip privilege elevation.

    Note: Tenable supports multiple options for privilege escalation, including su, su+sudo and sudo. For example, if you select sudo, more fields for sudo user, Escalation Account Name, and Location of su and sudo (directory) are provided and can be completed to support authentication and privilege escalation through QiAnXin. The Escalation Account Name field is only required if the escalation password differs from the normal login password.

    Note: For more information about supported privilege escalation types and their accompanying fields, see the Nessus User Guide or the Tenable Vulnerability Management User Guide.

    		Required if you wish to escalate privileges.
    Escalation Account Username If the escalation account has a different username or password from the least privileged user, enter the credential ID or identifier for the escalation account credential here. no
    Use SSL When enabled, Tenable uses SSL for secure communication. This is enabled by default.

    no

    Verify SSL Certificate

    When enabled, Tenable verifies that the SSL Certificate on the server is signed by a trusted CA.

    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
    Privilege Escalation The privilege escalation method you want to use to increase users' privileges after initial authentication. Your Privilege Escalation selection determines the specific options you must configure. For more information, see Privilege Escalation. no

  9. Click Submit.

    Tenable Security Center saves your configuration.