tenable-ruby-sdk 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6020ebd94aaa44a36cf4eeebeca87d7ceaf6730f3ff15dbe377b3d332cf8a90e
-  data.tar.gz: 5debd6afde04c5f130fb3c1e867f68b0fbbdfbe160c2fffac20bb0ad4fa488dd
+  metadata.gz: 86b71cea395f4634ebeee10f3a73541f012ecb41604c19cd4f8441d64a317ece
+  data.tar.gz: 1dd6a81da536e32ebfdcbb6b908d0eeb502ac471ae2f9d7ba713f87c4d76b93b
 SHA512:
-  metadata.gz: bc1dc472bbe24ee07fa0447d3c87a60e09451cad4f31714d667e5bba43c1d098e5b1d82006b01a431cfc2a8401e760a007a95507123358e54e6c7282cfaf9758
-  data.tar.gz: 3f0ce6c911b2a72ed66b9e805541e6e4ae4864b3948c1f9e89807c4b58b9005d3747192f8fdbbdd550765ea6d6b8f97b63cfdd8d6bdc4515a3d7853458d2ca80
+  metadata.gz: c83641303c4468e92e859611131006158aaa963e55d3c0c08ae687911748477a0c7327f98a2394bca6e40174b1ac37a5074c07545df7be0fb1fbd0e29a9c4f2d
+  data.tar.gz: e4caa53b483ceef74f7279384d3a3da94c34350cbd92623c3365c220ff3e24b535f677d785d1b061df0060f622ff5657b223b4ef11f323dee03a2d6c4119b05e

data/lib/tenable/resources/asset_exports.rb

@@ -23,7 +23,7 @@ module Tenable
       # @param body [Hash] export request parameters (e.g., +chunk_size+, +filters+)
       # @return [Hash] response containing the export UUID
       def export(body = {})
-        post('/assets/export', body)
+        post('/assets/v2/export', body)
       end
 
       # Retrieves the status of an asset export.

data/lib/tenable/resources/scans.rb

@@ -127,13 +127,13 @@ module Tenable
         put("/scans/#{scan_id}/schedule", params)
       end
 
-      # Retrieves the scan history.
+      # Retrieves the scan history from the scan details endpoint.
       #
       # @param scan_id [Integer, String] the scan ID
-      # @return [Hash] history data including an array of history records
+      # @return [Array<Hash>] array of history records
       def history(scan_id)
-        validate_path_segment!(scan_id, name: 'scan_id')
-        get("/scans/#{scan_id}/history")
+        data = details(scan_id)
+        data['history'] || []
       end
 
       # Retrieves details for a specific host within a scan.

data/lib/tenable/resources/web_app_scans.rb

@@ -7,7 +7,7 @@ module Tenable
       TERMINAL_STATUSES = %w[completed failed cancelled error].freeze
 
       # Supported scan export formats.
-      SUPPORTED_EXPORT_FORMATS = %w[pdf csv nessus].freeze
+      SUPPORTED_EXPORT_FORMATS = %w[json csv xml html pdf].freeze
 
       # @return [Integer] default seconds between status polls
       DEFAULT_POLL_INTERVAL = 2
@@ -90,17 +90,17 @@ module Tenable
         get("/was/v2/configs/#{config_id}/scans/#{scan_id}")
       end
 
-      # Retrieves findings for a scan configuration.
+      # Searches vulnerabilities for a specific scan.
       #
-      # @param config_id [String] the scan configuration ID
-      # @param params [Hash] optional query parameters for filtering
-      # @return [Hash] findings data
+      # @param scan_id [String] the scan ID
+      # @param params [Hash] search parameters
+      # @return [Hash] search results with vulnerabilities and pagination
       #
       # @example
-      #   client.web_app_scans.findings(config_id, severity: "high")
-      def findings(config_id, **params)
-        validate_path_segment!(config_id, name: 'config_id')
-        get("/was/v2/configs/#{config_id}/findings", params)
+      #   client.web_app_scans.search_scan_vulnerabilities(scan_id, severity: "high")
+      def search_scan_vulnerabilities(scan_id, **params)
+        validate_path_segment!(scan_id, name: 'scan_id')
+        post("/was/v2/scans/#{scan_id}/vulnerabilities/search", params)
       end
 
       # Polls until the scan reaches a terminal status.
@@ -135,7 +135,7 @@ module Tenable
       # @return [Hash] the updated scan status
       def stop_scan(scan_id)
         validate_path_segment!(scan_id, name: 'scan_id')
-        patch("/was/v2/scans/#{scan_id}/status", { 'status' => 'stopped' })
+        patch("/was/v2/scans/#{scan_id}", { 'requested_action' => 'stop' })
       end
 
       # Deletes a WAS scan.
@@ -147,12 +147,14 @@ module Tenable
         delete("/was/v2/scans/#{scan_id}")
       end
 
-      # Searches WAS scans.
+      # Searches scans for a specific configuration.
       #
+      # @param config_id [String] the scan configuration ID
       # @param params [Hash] search parameters
       # @return [Hash] search results with items and pagination
-      def search_scans(**params)
-        post('/was/v2/scans/search', params)
+      def search_scans(config_id, **params)
+        validate_path_segment!(config_id, name: 'config_id')
+        post("/was/v2/configs/#{config_id}/scans/search", params)
       end
 
       # Searches WAS vulnerabilities.
@@ -169,13 +171,13 @@ module Tenable
       # @return [Hash] vulnerability details
       def vulnerability_details(vuln_id)
         validate_path_segment!(vuln_id, name: 'vuln_id')
-        get("/was/v2/vulns/#{vuln_id}")
+        get("/was/v2/vulnerabilities/#{vuln_id}")
       end
 
-      # Initiates an export for a specific WAS scan.
+      # Initiates a report export for a specific WAS scan.
       #
       # @param scan_id [String] the scan ID
-      # @param format [String] export format — one of "pdf", "csv", or "nessus"
+      # @param format [String] export format — one of "json", "csv", "xml", "html", or "pdf"
       # @param body [Hash] additional export parameters
       # @return [Hash] export initiation response
       # @raise [ArgumentError] if the format is not supported
@@ -185,16 +187,25 @@ module Tenable
           raise ArgumentError, "Unsupported format '#{format}'. Must be one of: #{SUPPORTED_EXPORT_FORMATS.join(', ')}"
         end
 
-        put("/was/v2/scans/#{scan_id}/export", body.merge('format' => format))
+        put("/was/v2/scans/#{scan_id}/report", body.merge('format' => format))
       end
 
-      # Retrieves the status of a WAS scan export.
+      # Checks the status of a WAS scan report by attempting to fetch it.
+      #
+      # The WAS report API has no separate status endpoint. A 404 response
+      # indicates the report is still being generated.
       #
       # @param scan_id [String] the scan ID
       # @return [Hash] status data with +"status"+ key ("ready" or "loading")
       def export_scan_status(scan_id)
         validate_path_segment!(scan_id, name: 'scan_id')
-        get("/was/v2/scans/#{scan_id}/export/status")
+        response = @connection.faraday.get("/was/v2/scans/#{scan_id}/report")
+        if response.status == 404
+          { 'status' => 'loading' }
+        else
+          raise_for_status(response)
+          { 'status' => 'ready' }
+        end
       end
 
       # Downloads a completed WAS scan export as raw binary data.
@@ -203,7 +214,7 @@ module Tenable
       # @return [String] raw binary content of the export
       def download_scan_export(scan_id)
         validate_path_segment!(scan_id, name: 'scan_id')
-        get_raw("/was/v2/scans/#{scan_id}/export/download")
+        get_raw("/was/v2/scans/#{scan_id}/report")
       end
 
       # Polls until a WAS scan export is ready for download.

data/lib/tenable/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tenable
-  VERSION = '0.1.0'
+  VERSION = '0.2.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tenable-ruby-sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - vudx00
@@ -37,6 +37,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -186,7 +200,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Ruby SDK for the Tenable API
 test_files: []