tenable-ruby 0.3.7 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90bf72ec8733ce3471adcd53f81588c7348ecb76c10fe0da8a856cc8972187db
-  data.tar.gz: cd326db62ee9cd954721e2b1cbc4d11f64fb23aedf9a46e2d96cb568e638dd97
+  metadata.gz: a307cd9672be72bc72d8aeee16cf07083250883bd6bb26c38a7e2a6344162b66
+  data.tar.gz: b415f2321cc7d6e14bb1ec621b33093424c05050fcb8da747beb10f554f236bd
 SHA512:
-  metadata.gz: 1402475f0de219ab2d654570a8de243bacb2040817baa9e36f21a24d0f8268703dc23df63d011c3db6aee1cf812a990d3f444362ff526431c9b0249837abdb94
-  data.tar.gz: 3cd169742abb76e759107f33d2511396ecd9dd05c934062b1519e75108e56332aa87e656213139e8bd1455464280a1e9ccd83dfc813b80d0911b8f923dfedd43
+  metadata.gz: 6ef0ab799275410df467d988583b0dcb8d777aaf018806dd46eac988f0e93b0e1151f9fb18e2c313cf3617b0fb4bc656949c26c572a72aab6b36d87444798881
+  data.tar.gz: a5f78981f65993467351de830a3e1c76b85477e3efa049746078e78405c06b40c65dd15d7a804340ca0f1dd6d2a5c8b544ce87ad796cce3c688818703b2fcaca

data/lib/error/tenable_error.rb

@@ -1,6 +1,12 @@
 module TenableRuby
   module Error
     class TenableError < StandardError
+      attr_reader :response
+
+      def initialize(message=nil, response: nil)
+        @response = response
+        super(message)
+      end
     end
   end
 end

data/lib/tenable-ruby.rb

@@ -307,6 +307,14 @@ module TenableRuby
       http_put(options)
     end
 
+    # Returns details of the specified asset.
+    #
+    # Reference:
+    # https://developer.tenable.com/reference#assets-asset-info
+    def asset_info(asset_uuid)
+      http_get(:uri => "/assets/#{asset_uuid}", :fields => header)
+    end
+
     # Creates a scan
     #
     # Reference:
@@ -410,6 +418,15 @@ module TenableRuby
       http_get(:uri => uri, :fields => header)
     end
 
+    # Returns the output for a specified plugin.
+    #
+    # Reference:
+    # https://developer.tenable.com/reference#scans-plugin-output
+    def scans_plugin_output(scan_id, host_id, plugin_id)
+      uri = "/scans/#{scan_id}/hosts/#{host_id}/plugins/#{plugin_id}"
+      http_get(:uri => uri, :fields => header)
+    end
+
     # Download an exported scan
     #
     # Reference:
@@ -549,33 +566,15 @@ module TenableRuby
       scan_create(template_uuid, settings)
     end
 
-    # Returns scan status by performing a 'scan_details' API call
+    # Returns the latest status for a scan.
+    #
+    # Reference: https://developer.tenable.com/reference#scans-get-latest-status
     def scan_status(scan_id)
-      details = scan_details(scan_id)
-      if details.nil?
-        raise TenableRuby::Error::TenableError, "Get scan_details returned nil"
-      end
-      if not details['error'].nil?
-        raise TenableRuby::Error::TenableError, "Get scan_details returned the following error: #{details['error']}"
-      end
-      details['info']['status']
-    end
-
-    # Returns the status of the latest history object of a scan by performing a 'scan_details' API call.
-    # Note this is currently updated more frequently than the scan status in the tenable.io API
-    def scan_latest_history_status(scan_id)
-      details = scan_details(scan_id)
-      if details.nil?
-        raise TenableRuby::Error::TenableError, "Get scan_details returned nil"
-      end
-      if not details['error'].nil?
-        raise TenableRuby::Error::TenableError, "Get scan_details returned the following error: #{details['error']}"
-      end
-      history = details['history']
-      if history.nil? or history.length == 0
-        raise TenableRuby::Error::TenableError, "Get scan_details returned empty history object"
+      response = http_get(:uri => "/scans/#{scan_id}/latest-status", :fields => header)
+      if response.is_a?(Hash) and response.has_key?('status')
+        response['status']
       else
-        details['history'].last['status']
+        raise TenableRuby::Error::TenableError, "Tenable.io did not return a valid status response"
       end
     end
 
@@ -698,6 +697,48 @@ module TenableRuby
       http_get(:uri => "/container-security/api/v1/reports/by_image_digest?image_digest=#{image_digest}", :fields => header)
     end
 
+    # Creates a new target group for the current user.
+    #
+    # Reference:
+    # https://developer.tenable.com/reference#target-groups-create
+    def create_target_group(name, members, acls: [])
+      http_post(:uri => "/target-groups", :fields => header,
+        :body => {:name => name, :members => members, :acls => alcs})
+    end
+
+    # Returns the current target groups.
+    #
+    # Reference:
+    # https://developer.tenable.com/reference#target-groups-list
+    def list_target_groups
+      http_get(:uri => "/target-groups", :fields => header)
+    end
+
+    # Returns details for the specified target group.
+    #
+    # Reference:
+    # https://developer.tenable.com/reference#target-groups-details
+    def get_target_group(group_id)
+      http_get(:uri => "/target-groups/#{group_id}", :fields => header)
+    end
+
+    # Updates a target group.
+    #
+    # Reference:
+    # https://developer.tenable.com/reference#target-groups-edit
+    def update_target_group(group_id:, name:, members:, acls: nil)
+      http_put(:uri => "/target-groups/#{group_id}", :fields => header,
+        :body => {:name => name, :members => members, :acls => acls})
+    end
+
+    # Deletes a target group.
+    #
+    # Reference:
+    # https://developer.tenable.com/reference#target-groups-delete
+    def delete_target_group(group_id)
+      http_delete(:uri => "/target-groups/#{group_id}", :fields => header)
+    end
+
     private
 
     # Perform HTTP put method with uri, data and fields
@@ -886,7 +927,7 @@ module TenableRuby
       end
 
       if response.code.to_s != "200"
-        raise TenableRuby::Error::TenableError,
+        raise TenableRuby::Error::TenableError.new(response: response),
           "Tenable API request '#{opts[:uri]}' responded with response code #{response.code}"
       end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tenable-ruby
 version: !ruby/object:Gem::Version
-  version: 0.3.7
+  version: 0.4.2
 platform: ruby
 authors:
 - Patrick Craston
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-08-15 00:00:00.000000000 Z
+date: 2020-06-09 00:00:00.000000000 Z
 dependencies: []
 description: |-
   Ruby library for communicating with the tenable.io API.
@@ -25,7 +25,7 @@ homepage: https://gitlab.com/intruder/tenable-ruby
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -40,8 +40,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.4
-signing_key: 
+rubygems_version: 3.0.3
+signing_key:
 specification_version: 4
 summary: Ruby library for communicating with the tenable.io API
 test_files: []