> For the complete documentation index, see [llms.txt](https://docs.linuxcontrolcenter.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.linuxcontrolcenter.com.br/7-library/install-tenable-agent.md).

# Playbook Install Tenable Agent

## Requisitos

* Hosts na base de dados do LCC previamente configurados
* Host com acesso à internet pelo protocolo HTTPS porta TCP/443
* Linking Key do Nessus Agent

## Overview

* Este guia possui o passo a passo para utilizar o playbook de instalação do Nessus Agent disponível na 7 Library do LCC.

## Objetivo

* O objetivo do playbook Install Tenable Agent da 7 Library é facilitar a instalação do Nessus Agent, permitindo a instalação em massa em hosts Linux de forma automatizada.

## Linkinkg Key para o Nessus Agent

* A chave é utilizada durante a instalação do Agent para associar o Host a uma conta no Tenable Cloud, para que o resultado do Scan seja direcionado para o lugar correto via Web.

1. Acesse o site <https://cloud.tenable.com> e faça login com as credenciais do seu ambiente.
2. Clique na engrenagem no canto superior direito

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-c876578db96c43011f7ef00233616be772dbb0f1%2Fcloud_homepage.png?alt=media)
3. Clique em **Sensors**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-185fbdbe2bbf2bf390a0ff3cc3c2dc9376c6c85b%2Fsensors.png?alt=media)
4. Clique em **Nessus Agents**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-d731f95381e81be4682ad94c24eef3213666f987%2Fnessus_install.png?alt=media)
5. Clique em **ADD Nessus Agent**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-32ee669b75082381d86bb3e10957d5260eb81065%2Fadd_nessus_agent.png?alt=media)
6. Copie a **Linking Key** com o botão **Copy** e salve em um editor de texto

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-e313fe1f29f85b8a7045ace01e0ca98a5acc3857%2Fadd_nessus_agent2.png?alt=media)

## Link de Download do binário Nessus Agent

* Para executar o playbook, é necessário obter o link de download correto do pacote de instalação do Nessus Agent.

1. Acesse o link oficial de download do Nessus Agent <https://www.tenable.com/downloads/nessus-agents?loginAttempted=true> e baixe o pacote compatível com o host Linux onde o playbook será executado.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-494a5f1b917b4cf0f3805a922d224ff8836c06c7%2Fdownload_oficial_agent_page.png?alt=media)
2. Abra a página de Histórico de Download do seu navegador e clique no pacote baixado com o botão direito do mouse.
3. Clique em **Copiar endereço do link**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-4a8f9cb8a6a062b3db09e120cbc5cfb23cb926c2%2Flink_download.png?alt=media)
4. Salve o endereço de download juntamente com a **Linking Key** para facilitar o próximo passo.

## Configuração do Playbook Install Tenable Agent

* Com a Linking Key e o endereço de download em mãos, siga o passo a passo abaixo;

1. Clique em **7 Library** no menu esquerdo do LCC

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-dbcd9b63fc9b8b4081e61966768263cfd24b93c3%2F7_library.png?alt=media)
2. Clique em **Sync Feed** para atualizar o feed do 7 Library
3. Clique no playbook **Install Tenable Agent**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-18046faca6e1e833b8d5d9478a2f9a7cb87a5bcf%2Fnessus_agent.png?alt=media)
4. Clicando em **Download** o playbook será salvo no LCC e estará disponível na tela **Playbooks**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-eb7ae0135ceb7a9a601c05f6431d8addc1c7778e%2Fdownload_playbook.png?alt=media)
5. Clique em **Playbooks** no menu esquerdo do LCC e clique no playbook **Install Tenable Agent**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-896798b88997ce4db2e4260626ee4271125aa22b%2Fplaybooks_page.png?alt=media)
6. Clique em **Variables**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-7c33f550b18b21a15c655bbda2d0f25ccbcad3f9%2Fvariables_nessusagent_install.png?alt=media)

* Insira os valores das variáveis;
  * **URL**: Insira o link de download do pacote copiado no passo anterior
  * **PACKAGE\_TYPE**: Insira o gerenciador de pacotes da distribuição Linux em que o playbook será executado:
    * `apt` ou `rpm`
  * **LINKING\_KEY**: Linking Key obtida no Tenable Cloud
  * **FLAGS**: Valor padrão:
    * `--cloud`
  * **BIN\_PATH**: Valor padrão:
    * `/opt/nessus_agent/sbin/nessuscli`
  * **AGENT\_GROUPS**: Insira o nome do grupo de Assets do Tenable Cloud em que os Hosts serão inseridos
    * `/opt/nessus_agent/sbin/nessuscli`

1. Clique em **Save**
2. Selecione o playbook e clique em **Actions** e depois em **Run**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-9b8c0b545e2e1346273e8f192c1642f65a537168%2Factions_playbook.png?alt=media)
3. Escolha o **Host** ou **Grupo de Host** desejado e clique em **Yes** para executar o playbook.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-8605c69aefeb5ce85609c69e3dae05add080936d%2Fconfirm_actions.png?alt=media)

## Validação da Instalação

* Para validar se a instalação foi concluída com sucesso;

1. Clique em **Dashboard** no menu lateral esqurdo do LCC e desça até o log **Host Actions**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-8ddef1e3de0a2866a307fc1cab1a486c0bf6b4b0%2Fdashboard_lcc.png?alt=media)
2. Aparecerá **Success** quando executado corretamente e **Error** quando ocorrer algum erro durante o processo.
3. Clique em **EXPAND** para ler os detalhes do log.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-9aaed8e9f9235d0d1db293f4d03ed60f958abbdf%2Flog_playbook.png?alt=media)
