tenable-ruby 0.2.9 → 0.2.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e3ffc535c0804bfd2ec0c8ed49901f5071bd5ecb
-  data.tar.gz: 802afef027172f267dc908d5c203a0846aec68f5
+  metadata.gz: 3e7f7d3f313d0e1025fb6542b1bfc78aaca7ac22
+  data.tar.gz: 61e4725f204991d399ef950785506193f9c213b5
 SHA512:
-  metadata.gz: 1792020ee77d3775f358673764d10594b7ba4662013a102f59cd82c7e2a1d09e19904d7bb7a3bc8c8d242c6bc3791c5247a4e795ae5cfa7afaa2e0885855e99c
-  data.tar.gz: 72753b4e0962e754b837817735d2722d3665e5ffd93ad3df8eb6a55cb1e9bdebed8885ce514a689427e028457e5e3ad0be324770fcae0a71746893419b1fa30a
+  metadata.gz: 587367f6991108a0fb14e8b91f156bc080d2a18288f8baadb068c9283ec68af934b0781936aaed13f01968e6621bd65b5f92b7af5e216a9d85effa4c7030d2a3
+  data.tar.gz: ec6665e7e0b64bccffa1cac5b3b4c7f72cfbf0f2df1e36c2e34eb12926abc8c549e3bb3c5e7c1ff3b5136a72e46b7005b2890b90c341695262831b2842e0d44d

data/lib/tenable-ruby.rb

@@ -478,11 +478,11 @@ module TenableRuby
     # Returns scan status by performing a 'scan_details' API call
     def scan_status(scan_id)
       details = scan_details(scan_id)
-      unless details['error'].nil?
-        return 'error'
-      end
       if details.nil?
-        return 'error'
+        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
@@ -491,15 +491,15 @@ module TenableRuby
     # 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)
-      unless details['error'].nil?
-        return 'error'
-      end
       if details.nil?
-        return 'error'
+        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
-        'error'
+        raise TenableRuby::Error::TenableError, "Get scan_details returned empty history object"
       else
         details['history'].last['status']
       end
@@ -536,6 +536,93 @@ module TenableRuby
       end
     end
 
+    # Returns a list of all containers.
+    #
+    # Reference:
+    # https://cloud.tenable.com/api#/resources/container-security-containers/list-containers
+    def list_containers()
+      http_get(:uri => "/container-security/api/v1/container/list", :fields => header)
+    end
+
+    # Returns an inventory of an image by ID.
+    #
+    # Reference:
+    # https://cloud.tenable.com/api#/resources/container-security-containers/image-inventory
+    def image_inventory(image_id)
+      http_get(:uri => "/container-security/api/v1/container/#{policy_id}/status", :fields => header)
+    end
+
+    # Returns the status of a job that you specify by ID to determine if the job is still queued, in progress, or has completed.
+    #
+    # Reference:
+    # https://cloud.tenable.com/api#/resources/container-security-jobs/job-status
+    def job_status(job_id)
+      http_get(:uri => "/container-security/api/v1/jobs/status?job_id=#{job_id}", :fields => header)
+    end
+
+    # Returns the status of a job by specifying an image ID to determine if the job is still queued, in progress, or has completed.
+    #
+    # Reference:
+    # https://cloud.tenable.com/api#/resources/container-security-jobs/job-status-by-image-id
+    def image_status(image_id)
+      http_get(:uri => "/container-security/api/v1/jobs/image_status?image_id=#{image_id}", :fields => header)
+    end
+
+    # Returns the status of a job by specifying an image digest to determine if the job is still queued, in progress, or has completed.
+    #
+    # Reference:
+    # https://cloud.tenable.com/api#/resources/container-security-jobs/job-status-by-image-digest
+    def image_status_digest(image_digest)
+      http_get(:uri => "/container-security/api/v1/jobs/image_status_digest?image_digest=#{image_digest}", :fields => header)
+    end
+
+    # Returns a list of active Container Security jobs
+    #
+    # Reference:
+    # https://cloud.tenable.com/api#/resources/container-security-jobs/list-jobs
+    def list_jobs()
+      http_get(:uri => "/container-security/api/v1/jobs/list", :fields => header)
+    end
+
+    # Checks the compliance of an image that you specify by ID against your policies.
+    #
+    # Reference: 
+    # https://cloud.tenable.com/api#/resources/container-security-policy/policy-compliance-by-id
+    def policy_compliance_by_id(image_id)
+      http_get(:uri => "/container-security/api/v1/policycompliance?image_id=#{image_id}", :fields => header)
+    end
+
+    # Checks the compliance of an image that you specify by name against your policies.
+    #
+    # Reference: 
+    # https://cloud.tenable.com/api#/resources/container-security-policy/policy-compliance-by-name
+    def policy_compliance_by_name(image)
+      http_get(:uri => "/container-security/api/v1/compliancebyname?image=#{image}", :fields => header)
+    end
+
+    # Returns a report in JSON format for a container that you specify by ID. Note: If you do not have the container_id, you can call the list-containers endpoint.
+    #
+    # Reference:
+    # https://cloud.tenable.com/api#/resources/container-security-reports/report-by-container-id
+    def report_by_container_id(container_id)
+      http_get(:uri => "/container-security/api/v1/reports/show?container_id=#{container_id}", :fields => header)
+    end
+
+    # Returns a report in JSON format for an image that you specify by ID. Note: If you do not have the image_id, you can call the list-images endpoint.
+    #
+    # Reference:
+    # https://cloud.tenable.com/api#/resources/container-security-reports/report-by-image-id
+    def report_by_image_id(image_id)
+      http_get(:uri => "/container-security/api/v1/reports/by_image?image_id=#{image_id}", :fields => header)
+    end
+
+    # Returns a report in JSON format for an image digest.
+    #
+    # Reference:
+    # https://cloud.tenable.com/api#/resources/container-security-reports/report-by-image-digest
+    def report_by_image_digest(image_digest)
+      http_get(:uri => "/container-security/api/v1/reports/by_image_digest?image_digest=#{image_digest}", :fields => header)
+    end
 
     private
 

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tenable-ruby
 version: !ruby/object:Gem::Version
-  version: 0.2.9
+  version: 0.2.10
 platform: ruby
 authors:
-- Vlatko Kosturjak
 - Patrick Craston
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-02-07 00:00:00.000000000 Z
+date: 2019-02-19 00:00:00.000000000 Z
 dependencies: []
 description: |-
   Ruby library for communicating with the tenable.io API.