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.

To configure QiAnXin SSH for Tenable Vulnerability Management or Tenable Nessus:

Log in to your Tenable user interface.
In the upper-left corner, click the button.

The left navigation plane appears.
In the left navigation plane, click Scans.

The Scans page appears.
In the upper-right corner of the page, click the Create a Scan button.

The Select a Scan Template page appears.
Select a scan template.

The scan configuration page appears.
In the Name box, type a name for the scan.
In the Targets box, type an IP address, hostname, or range of IP addresses.
(Optional) Add a description, folder location, scanner location, and specify target groups.
Click the Credentials tab.

The Credentials pane appears.
In the Select a Credential menu, select the Host drop-down.
Select SSH.

The Settings pane appears.
In the Auth Type drop-down box, click QiAnXin.

The QiAnXin options appear.

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
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

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.

To configure QiAnXin SSH for Tenable Security Center:

Log in to Tenable Security Center.
Click Scanning > Credentials (administrator users) or Scans > Credentials (organizational users).

The Credentials page appears.
Click Add.

The Credential Templates page appears.
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.
In the Name box, type a name for the credentials.
In the Description box, type a description for the credentials.
(Optional) Type or select a Tag. For more information, see Tags in the Tenable Security Center User Guide.

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
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

Click Submit.

Tenable Security Center saves your configuration.