Nessus6 0.1.1 → 0.1.2

data/lib/Nessus6/permissions/methods.rb

@@ -1,66 +0,0 @@
-require 'json'
-require 'Nessus6/errors/forbidden' # 403
-require 'Nessus6/errors/not_found' # 404
-require 'Nessus6/errors/unknown'
-
-module Nessus6
-  # The Editor class is for interacting with Nessus6 templates
-  class Permissions
-    def initialize(client)
-      @client = client
-    end
-
-    # Changes the permissions for an object.
-    #
-    # @param object_type [String] The type of object.
-    # @param object_id [String, Fixnum] The unique id of the object.
-    # @param permissions [String] An array of permission resources to apply
-    #   to the object.
-    # @return [Hash]
-    def change(object_type, object_id, permissions)
-      response = @client.put("permissions/#{object_type}/#{object_id}",
-                             body: permissions)
-      verify_change response
-    end
-
-    # Returns the current object's permissions.
-    #
-    # @param object_type [String] The type of object.
-    # @param object_id [String, Fixnum] The unique id of the object.
-    # @return [Hash]
-    def list(object_type, object_id)
-      response = @client.get("permissions/#{object_type}/#{object_id}")
-      verify_list response
-    end
-
-    private
-
-    def verify_change(response)
-      case response.status_code
-      when 200
-        return JSON.parse response.body
-      when 403
-        fail ForbiddenError, 'You do not have permission to edit the object'
-      when 404
-        fail NotFoundError, 'Object does not exist'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-
-    def verify_list(response)
-      case response.status_code
-      when 200
-        return JSON.parse response.body
-      when 403
-        fail ForbiddenError, 'You do not have permission to view the object'
-      when 404
-        fail NotFoundError, 'Object does not exist'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-  end
-end

data/lib/Nessus6/scans/methods.rb

@@ -1,106 +0,0 @@
-require 'json'
-require 'Nessus6/errors/forbidden' # 403
-require 'Nessus6/errors/not_found' # 404
-require 'Nessus6/errors/conflict' # 409
-require 'Nessus6/errors/internal_server_error' # 500
-require 'Nessus6/errors/unknown'
-
-module Nessus6
-  # The Editor class is for interacting with Nessus6 templates
-  class Scans
-    def initialize(client)
-      @client = client
-    end
-
-    # Launches a scan.
-    #
-    # @param scan_id [String, Fixnum] The id of the scan to launch.
-    # @param alt_targets [Array] If specified, these targets will be scanned
-    #   instead of the default. Value can be an array where each index is a
-    #   target, or an array with a single index of comma separated targets.
-    # @return [Hash] The scan UUID or throws an error
-    def launch(scan_id, alt_targets = nil)
-      if alt_targets.is_a? Array
-        response = @client.post "scans/#{scan_id}/launch",
-                                alt_targets: alt_targets
-      else
-        response = @client.post "scans/#{scan_id}/launch"
-      end
-
-      verify_launch response
-    end
-
-    # Returns the scan list.
-    #
-    # @return [Hash] Returns the scan list.
-    def list
-      response = @client.get 'scans'
-      JSON.parse response.body
-    end
-
-    # Pauses a scan.
-    #
-    # @param scan_id [String, Fixnum] The id of the scan to pause.
-    # @return [Hash] The scan UUID or throws an error
-    def pause(scan_id)
-      response = @client.post "scans/#{scan_id}/pause"
-      verify_pause response
-    end
-
-    # Stops a scan.
-    #
-    # @param scan_id [String, Fixnum] The id of the scan to stop.
-    # @return [Hash] The scan UUID or throws an error
-    def stop(scan_id)
-      response = @client.post "scans/#{scan_id}/stop"
-      verify_stop response
-    end
-
-    private
-
-    def verify_launch(response)
-      case response.status_code
-      when 200
-        return JSON.parse response.body
-      when 403
-        fail ForbiddenError, 'This scan is disabled.'
-      when 404
-        fail NotFoundError, 'Scan does not exist.'
-      when 500
-        fail InternalServerError, 'Failed to launch scan. This is usually due to the'\
-          ' scan already running.'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-
-    def verify_pause(response)
-      case response.status_code
-      when 200
-        return JSON.parse response.body
-      when 403
-        fail ForbiddenError, 'This scan is disabled.'
-      when 409
-        fail ConflictError, 'Scan is not active.'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-
-    def verify_stop(response)
-      case response.status_code
-      when 200
-        return JSON.parse response.body
-      when 404
-        fail NotFoundError, 'Scan does not exist.'
-      when 409
-        fail ConflictError, 'Scan is not active.'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-  end
-end

data/lib/Nessus6/session/methods.rb

@@ -1,142 +0,0 @@
-require 'json'
-require 'Nessus6/errors/bad_request'
-require 'Nessus6/errors/forbidden'
-require 'Nessus6/errors/internal_server_error'
-require 'Nessus6/errors/unauthorized'
-require 'Nessus6/errors/unknown'
-
-module Nessus6
-  class Session
-    attr_reader :token
-
-    def initialize(client)
-      @client = client
-    end
-
-    def create(username, password)
-      response = @client.post('session',
-                          username: username, password: password)
-      verified = verify_create response
-      @token = verified['token']
-    end
-
-    def destroy
-      response = @client.delete('session')
-
-      case response.status_code
-      when 200
-        @token = ''
-        return true
-      when 401
-        fail 'No session exists'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-
-    def edit(user)
-      if user[:name] && user[:email]
-        response = @client.put('session', name: user[:name],
-                                          email: user[:email])
-      elsif user[:name]
-        response = @client.put('session', name: user[:name])
-      elsif user[:email]
-        response = @client.put('session', email: user[:email])
-      else
-        fail "User's name or email was not provided in hash form."
-      end
-      verify_edit response
-    end
-
-    def get
-      verify_get @client.get('session')
-    end
-
-    def password(new_password)
-      response = @client.put('session/chpasswd', password: new_password)
-      verify_password response
-    end
-
-    def keys
-      response = @client.put('session/keys')
-      verify_keys response
-    end
-
-    private
-
-    def verify_create(response)
-      case response.status_code
-      when 200
-        return JSON.parse response.body
-      when 400
-        fail BadRequestError, 'Username format is not valid'
-      when 401
-        fail UnauthorizedError, 'Username or password is invalid'
-      when 500
-        fail InternalServerError, 'Too many users are connected'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-
-    def verify_edit(response)
-      case response.status_code
-      when 200
-        return JSON.parse response.body
-      when 403
-        fail ForbiddenError,
-             'You do not have permission to edit the session data'
-      when 500
-        fail InternalServerError, 'Server failed to edit the user'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-
-    def verify_get(response)
-      case response.status_code
-      when 200
-        return JSON.parse response.body
-      when 403
-        fail ForbiddenError,
-             'You do not have permission to view the session data'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-
-    def verify_password(response)
-      case response.status_code
-      when 200
-        return JSON.parse response.body
-      when 400
-        fail BadRequestError, 'Password is too short'
-      when 401
-        fail UnauthorizedError,
-             'You do not have permission to change this password'
-      when 500
-        fail InternalServerError, 'Server failed to change the password'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-
-    def verify_keys(response)
-      case response.status_code
-      when 200
-        return JSON.parse response.body
-      when 401
-        fail UnauthorizedError,
-             'You are not logged in / authenticated'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-  end
-end

data/lib/Nessus6/users/methods.rb

@@ -1,180 +0,0 @@
-require 'json'
-require 'Nessus6/errors/bad_request'
-require 'Nessus6/errors/conflict'
-require 'Nessus6/errors/forbidden'
-require 'Nessus6/errors/internal_server_error'
-require 'Nessus6/errors/not_found'
-require 'Nessus6/errors/unknown'
-
-module Nessus6
-  class Users
-    def initialize(client)
-      @client = client
-    end
-
-    def create(credentials, user_perm, user_info = {})
-      new_user = {}.tap do |user|
-        user[:username] = credentials[:username]
-        user[:password] = credentials[:password]
-        user[:permissions] = user_perm[:permissions]
-        user[:type] = user_perm[:type]
-        user[:name] = user_info[:name] if user_info.key?(:name)
-        user[:email] = user_info[:email] if user_info.key?(:email)
-      end
-
-      response = @client.post('users', new_user)
-
-      verify_create response
-    end
-
-    def delete(user_id)
-      response = @client.delete("users/#{user_id}")
-      verify_delete response
-    end
-
-    def edit(user_id, permissions, user_info = {})
-      edit_user = {}.tap do |user|
-        user[:permissions] = permissions
-        user[:name] = user_info[:name] if user_info.key?(:name)
-        user[:email] = user_info[:email] if user_info.key?(:email)
-      end
-      response = @client.post("users/#{user_id}", edit_user)
-      verify_edit response
-    end
-
-    def get(user_id)
-      response = @client.get("users/#{user_id}")
-      verify_get response
-    end
-
-    def list
-      response = @client.get('users')
-      verify_list response
-    end
-
-    def password(user_id, new_password)
-      response = @client.post("users/#{user_id}/chpasswd",
-                              password: new_password)
-      verify_password response
-    end
-
-    def keys(user_id)
-      response = @client.get("users/#{user_id}/keys")
-      verify_keys response
-    end
-
-    private
-
-    def verify_create(response)
-      case response.status_code
-      when 200
-        return JSON.parse response.body
-      when 400
-        fail BadRequestError, 'Field is invalid'
-      when 403
-        fail ForbiddenError, 'You do not have permission to create this user'
-      when 409
-        fail ConflictError, 'User already exists'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-
-    def verify_delete(response)
-      case response.status_code
-      when 200
-        return true
-      when 403
-        fail ForbiddenError, 'Not authorized to delete users'
-      when 404
-        fail NotFoundError, 'You do not have permission to delete this user'
-      when 409
-        fail ConflictError, 'Cannot delete your own account'
-      when 500
-        fail InternalServerError,
-             'Failed to delete the user due to an interal server error'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-
-    def verify_edit(response)
-      case response.status_code
-      when 200
-        return JSON.parse response.body
-      when 400
-        fail BadRequestError, 'Field is invalid'
-      when 403
-        fail ForbiddenError, 'You do not have permission to edit this user'
-      when 404
-        fail NotFoundError, 'User does not exist'
-      when 409
-        fail ConflictError, 'Cannot edit your own permissions'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-
-    def verify_get(response)
-      case response.status_code
-      when 200
-        return JSON.parse response.body
-      when 404
-        fail NotFoundError, 'User does not exist'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-
-    def verify_list(response)
-      case response.status_code
-      when 200
-        return JSON.parse response.body
-      when 403
-        fail ForbiddenError, 'You do not have permission to view the list'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-
-    def verify_password(response)
-      case response.status_code
-      when 200
-        return true
-      when 400
-        fail BadRequestError, 'Password is too short'
-      when 403
-        fail ForbiddenError,
-             'You do not have permission to change the users password'
-      when 404
-        fail NotFoundError, 'User does not exist'
-      when 500
-        fail InternalServerError, 'Server failed to change the password'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-
-    def verify_keys(response)
-      case response.status_code
-      when 200
-        return JSON.parse response.body
-      when 403
-        fail ForbiddenError, 'You do not have permission to generate API keys'
-      when 404
-        fail NotFoundError, 'User does not exist'
-      when 500
-        fail InternalServerError, 'Server failed to change the keys'
-      else
-        fail UnknownError, 'An unknown error occurred. Please consult Nessus' \
-                           'for further details.'
-      end
-    end
-  end
-end