# 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 and log in with your environment credentials. 2. Click the gear in the top right corner ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-c876578db96c43011f7ef00233616be772dbb0f1%2Fcloud_homepage.png?alt=media) 3. Click **Sensors** ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-185fbdbe2bbf2bf390a0ff3cc3c2dc9376c6c85b%2Fsensors.png?alt=media) 4. Click **Nessus Agents** ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-d731f95381e81be4682ad94c24eef3213666f987%2Fnessus_install.png?alt=media) 5. Click **ADD Nessus Agent** ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-32ee669b75082381d86bb3e10957d5260eb81065%2Fadd_nessus_agent.png?alt=media) 6. Copy the **Linking Key** with the **Copy** button and save it in a text editor ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-e313fe1f29f85b8a7045ace01e0ca98a5acc3857%2Fadd_nessus_agent2.png?alt=media) ## Nessus Binary Download Link Agent * 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 and download the package compatible with the Linux host where the playbook will be run. ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-494a5f1b917b4cf0f3805a922d224ff8836c06c7%2Fdownload_oficial_agent_page.png?alt=media) 2. Open the Download History page of your browser and right-click on the downloaded package. 3. Click **Copy Link Address** ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-4a8f9cb8a6a062b3db09e120cbc5cfb23cb926c2%2Flink_download.png?alt=media) 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 ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-dbcd9b63fc9b8b4081e61966768263cfd24b93c3%2F7_library.png?alt=media) 2. Click **Sync Feed** to update the 7 Library feed 3. Click on the **Install Tenable Agent** playbook ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-18046faca6e1e833b8d5d9478a2f9a7cb87a5bcf%2Fnessus_agent.png?alt=media) 4. Click **Download** and the playbook will be saved to the LCC and available on the **Playbooks** screen ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-eb7ae0135ceb7a9a601c05f6431d8addc1c7778e%2Fdownload_playbook.png?alt=media) 5. Click **Playbooks** in the LCC left menu and click on the **Install Tenable Agent** playbook ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-896798b88997ce4db2e4260626ee4271125aa22b%2Fplaybooks_page.png?alt=media) 6. Click **Variables** ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-7c33f550b18b21a15c655bbda2d0f25ccbcad3f9%2Fvariables_nessusagent_install.png?alt=media) * 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** ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-9b8c0b545e2e1346273e8f192c1642f65a537168%2Factions_playbook.png?alt=media) 3. Choose the desired **Host** or **Host Group** and click **Yes** to run the playbook. ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-8605c69aefeb5ce85609c69e3dae05add080936d%2Fconfirm_actions.png?alt=media) ## 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 ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-8ddef1e3de0a2866a307fc1cab1a486c0bf6b4b0%2Fdashboard_lcc.png?alt=media) 2. **Success** will appear when executed correctly and **Error** when an error occurs during the process. 3. Click **EXPAND** to read the log details. ![](https://1620115297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtZm19HsLxuDm2GumYKEz%2Fuploads%2Fgit-blob-9aaed8e9f9235d0d1db293f4d03ed60f958abbdf%2Flog_playbook.png?alt=media) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.linuxcontrolcenter.com.br/en/7-library/install-tenable-agent.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.