tenable-ruby 0.3.9 → 0.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad9396c3090a68e4d42a7ccdf2200955ed4d4e41d795fc2c2ae147a0b29b0d75
-  data.tar.gz: 9080fad783c03f4615be2d60df3631cbc563478d01563321ae5d9946dff01867
+  metadata.gz: 77917278fce3594ee5fce1156ba4309ef5ed2fdeeaace91d2b3c3626818acd67
+  data.tar.gz: 26b073b7ef3de954d470002eb035e3aa52d2bb30bde90b211680f6f2f0bb82b8
 SHA512:
-  metadata.gz: 20aed9477d92e9a88e84cf2243abb189b3aafd8378ce2c38342811078f04ca3902a47cddfb7d20ee287cb13d2046ebf7d1ee29e9912b136abbad27ab383b0eb3
-  data.tar.gz: 385554e3f46578fc8dcf8e3f9de4e97afca808dd39032da1f651005dc63ca9dbc6c5605deb143b280fdaa0c780a478c88d97010fb29ad4f7900cbe1aad61e5ce
+  metadata.gz: fa26c48c98bfea63c85c82402c9850c724de8fe77d81315b23d58c6ce45527f9fd2e6f9302b0ac466abedbffe8ec35caa5598275a5e420381be42d584901e18d
+  data.tar.gz: 933cbeb33c6c6027b18431edfa5347ffd7c00de1483360f8b067ef9d9ceab1b569861bbac4013567a78c9ecf5f7617535ac42cfea374ef3d04caa442140298fa

data/lib/tenable-ruby.rb

@@ -526,11 +526,11 @@ module TenableRuby
 
     # Performs scan with scan policy provided (uuid of policy or policy name).
     # Name is your scan name and opts is your scan configuration hash
-    # (foldername is optional - folder where to save the scan (if that folder exists))
+    # (scan_folder is optional - folder where to save the scan (if that folder exists))
     # (scanner_id is optional - ID of the scanner/cloud scanner you want to run this scan on)
     #
     # returns: JSON parsed object with scan info
-    def scan_quick_policy(policyname, name, opts = {}, foldername = nil, scanner_id = nil)
+    def scan_quick_policy(policyname, name, opts = {}, scan_folder = nil, scanner_id = nil)
       policies = list_policies['policies']
       if policies.nil?
         raise TenableRuby::Error::TenableError, "Tenable API request 'list_policies' responded with 'nil'"
@@ -548,16 +548,18 @@ module TenableRuby
       settings.merge!(opts)
       settings['name'] = name
       settings['policy_id'] = policy['id']
-      unless foldername.nil?
+      if scan_folder.is_a?(Integer)
+        settings['folder_id'] = scan_folder
+      elsif scan_folder.is_a?(String)
         folders = list_folders['folders']
         if folders.nil?
           raise TenableRuby::Error::TenableError, "Tenable API request 'list_folders' responded with 'nil'"
         end
-        selected_folders = folders.select do |folder|
-          folder['name'] == foldername
-        end
-        unless selected_folders.size == 0
-          settings['folder_id'] = selected_folders.first['id']
+        selected_folder = folders.find { |f| f['name'] == scan_folder }
+        if selected_folder
+          settings['folder_id'] = selected_folder['id']
+        else
+          raise TenableRuby::Error::TenableError, "Could not find folder with name #{scan_folder}"
         end
       end
       unless scanner_id.nil?
@@ -566,33 +568,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
 
@@ -715,6 +699,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: nil)
+      http_post(:uri => "/target-groups", :fields => header,
+        :data => {:name => name, :members => members, :acls => acls})
+    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,
+        :data => {: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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tenable-ruby
 version: !ruby/object:Gem::Version
-  version: 0.3.9
+  version: 0.4.4
 platform: ruby
 authors:
 - Patrick Craston
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-04-07 00:00:00.000000000 Z
+date: 2020-06-16 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
@@ -41,7 +41,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.0.3
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Ruby library for communicating with the tenable.io API
 test_files: []