Getting started on Windows

Install Ruby

NOTE: Ruby requirements will change with nexpose-client version 1.0.0

1. Visit http://rubyinstaller.org/downloads/
2. Download an appropriate installer

• The Nexpose gem requires at least Ruby 1.9.3
• The Nexpose gem is known to work on Ruby 2.0.0
• 64-bit is required for scripts that use large data sets

3. Install Ruby with the downloaded installer

• Be sure to check the box to add Ruby to the path. This will make it easier to execute Ruby scripts.

Install the Nexpose gem

1. Open a command prompt or PowerShell prompt
2. Enter the following command: gem install nexpose --no-ri --no-rdoc

• The no-ri and no-rdoc options reduce download size for the Rex dependencies

3. Check the Nexpose gem version installed: gem list | findstr nexpose

Log in to Nexpose using irb

1. In your command prompt or PowerShell prompt, run irb to launch the Ruby interpreter
2. Enter the following lines to load the Nexpose gem and setup a connection to a Nexpose Security Console

require 'nexpose'

nsc = Nexpose::Connection.new('localhost', 'nxadmin', 'nxpassword')

Note: Be sure to set the correct hostname or IP address, username, and password for your Nexpose Security Console.

Enter the following lines to log in to Nexpose and list all sites

nsc.login

nsc.list_sites

When you're finished interacting with a Nexpose session, you should log out to ensure the session is freed up

nsc.logout

exit