0.06
No commit activity in last 3 years
No release in over 3 years
Ruby library for Nessus (version 6+) JSON/REST interface. This library is used for communication with Nessus over REST interface. You can start, stop, pause and resume scan. Watch progress and status of scan, download report, etc.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 1.1
>= 0
>= 0
>= 0
 Project Readme

Build Status Coverage Status

nessus_rest

Communicate with Nessus Scanner (version 6+) over REST/JSON interface

Usage

require 'nessus_rest'

n=NessusREST::Client.new ({
	:url=>'https://localhost:8834', 
	:username=>'user',
	:password=> 'password' })
qs=n.scan_quick_template('basic','name-of-scan','localhost')
scanid=qs['scan']['id']
n.scan_wait4finish(scanid)
n.report_download_file(scanid,'csv','myscanreport.csv')

Installation

Add this line to your application's Gemfile:

gem 'nessus_rest'

And then execute:

$ bundle

Or install it yourself as:

$ gem install nessus_rest

Requirements

Requirements are quite standard Ruby libraries for HTTPS and JSON parsing:

require 'uri'
require 'net/https'
require 'json'

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Todo

  • Provide more examples

Copyright

Copyright (c) 2016 Vlatko Kosturjak. See LICENSE.txt for further details.

Credits

Vlatko Kosturjak made initial Nessus XMLRPC library. Averagesecurityguy made initial JSON REST patches. Vlatko did bugfixes, gemification and few features.