ansible-role-nessus-agent

Ansible role for installing and setting up the Nessus Agent.

Check it out on Ansible Galaxy

Role Variables

• nessus_agent_key: This is the key needed to connect with the Nessus host (required).

• nessus_agent_group: The group this agent will belong to when linking with the Nessus host (required).

• nessus_agent_host: The Nessus host to connect to (default: cloud.tenable.com).

• nessus_agent_port: The port for the Nessus host (default: 443).

• nessus_agent_package: This can be a package from a repository, a file path, or a URL (default: NessusAgent).

  Example package configurations:

  nessus_agent_package: nessus-agent
  nessus_agent_package: /tmp/nessus-agent_6.8.1_amd64.deb
  

Example Playbook

- hosts: all
  become: yes
  roles:
    - role: ansible-role-nessus-agent
      nessus_agent_key: xxxxxxxxx
      tags: nessus-agent

Testing Locally

1. Make sure you have access to a running Nessus Manager or tenable.io account and an agent key.

2. Install the required tools:

   • Ansible
   • Docker
   • Ruby

3. Install Test Kitchen and its dependencies.

   bundle
   

4. Download Nessus Agent packages for CentOS 6, CentOS 7, and Ubuntu 14.04/16.04. Place them in test/integration/default/files/.

5. Create a credentials file.

   cp test/integration/default/group_vars/all/secrets.yml.example test/integration/default/group_vars/all/secrets.yml
   

6. Edit tests/group_vars/all/secrets.yml to fill in your information.

7. Run the integration test.

   kitchen create
   kitchen converge
   
   # When finished, run:
   kitchen destroy
   

Author Information

SinglePlatform Engineering

License

BSD 3-Clause License