Install Tenable Agent

Requirements

  • Hosts in the LCC database previously configured

  • Host with internet access via HTTPS protocol, port TCP/443

  • Nessus Agent Linking Key

Overview

  • This guide provides step-by-step instructions for using the Nessus Agent installation playbook available in the LCC 7 Library.

Objective

  • The purpose of the Install Tenable Agent playbook from the 7 Library is to facilitate the installation of the Nessus Agent, allowing mass installation on Linux hosts in an automated manner.

Linking Key for the Nessus Agent

  • The key is used during the Agent installation to associate the Host with an account in Tenable Cloud, so that the Scan result is directed to the correct location via the Web.

  1. Access the website https://cloud.tenable.com and log in with your environment credentials.

  2. Click the gear in the top right corner

  3. Click Sensors

  4. Click Nessus Agents

  5. Click ADD Nessus Agent

  6. Copy the Linking Key with the Copy button and save it in a text editor

  • To run the playbook, you need to get the correct download link for the Nessus Agent installation package.

  1. Go to the official Nessus Agent download link https://www.tenable.com/downloads/nessus-agents?loginAttempted=true and download the package compatible with the Linux host where the playbook will be run.

  2. Open the Download History page of your browser and right-click on the downloaded package.

  3. Click Copy Link Address

  4. Save the download address along with the Linking Key to make the next step easier.

Install Tenable Agent Playbook Configuration

  • With the Linking Key and download address in hand, follow the steps below;

  1. Click 7 Library in the LCC left menu

  2. Click Sync Feed to update the 7 Library feed

  3. Click on the Install Tenable Agent playbook

  4. Click Download and the playbook will be saved to the LCC and available on the Playbooks screen

  5. Click Playbooks in the LCC left menu and click on the Install Tenable Agent playbook

  6. Click Variables

  • Enter the values ​​of the variables; - URL: Enter the package download link copied in the previous step

  • PACKAGE_TYPE: Enter the package manager of the Linux distribution in which the playbook will be executed:

  • apt or rpm

  • LINKING_KEY: Linking Key obtained from Tenable Cloud

  • FLAGS: Default value:

  • --cloud

  • BIN_PATH: Default value:

  • /opt/nessus_agent/sbin/nessuscli

  • AGENT_GROUPS: Enter the name of the Tenable Cloud Assets group in which the Hosts will be inserted

  • /opt/nessus_agent/sbin/nessuscli

  1. Click Save

  2. Select the playbook and click Actions and then Run

  3. Choose the desired Host or Host Group and click Yes to run the playbook.

Installation Validation

  • To validate if the installation was completed successfully;

  1. Click Dashboard in the left side menu of the LCC and scroll down to the Host Actions log

  2. Success will appear when executed correctly and Error when an error occurs during the process.

  3. Click EXPAND to read the log details.

Last updated