idrac 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e41b7b9b93deb9e404e63931d7923fcbbbe93ab9fa800f75ae67f7c0e584fe3
-  data.tar.gz: d082799ca43c5d5f84b781e8b1ac2f89600f9c781b8cc3977645e0052d2e609d
+  metadata.gz: ea684775e5a6c176d4089ce5a88a0907170896a3818d715479ca53a58ee95d05
+  data.tar.gz: dbe078ef0f036c27ecefbaeb454f63357561ecb0a9c9ee0f618f870b4e12b812
 SHA512:
-  metadata.gz: 9a4d52657ed48583f0721dd84b3ef30e08184b613368b511dbabf61242811ef86cf3e3d37e3caf6e49db0ee63a963eac8f6ce692e566223851b9806f469817e8
-  data.tar.gz: 8bea1a7c91c8404b6292688410b9c01e0d894295b4ae44318d452498e01dff5f168b76605a3b40eb2c535b41b3a1e9d5f13c2b8af26bbfbfc61f4f1a31f0818a
+  metadata.gz: cfd4619dc968e53dd5ca1f773881c7c422b3b281ef423c6f626cae934ecce20368e2a4bccf9598a84a07e300c7540bf2c3bd0236f5ad2b3cb7c163f3f05a4357
+  data.tar.gz: b6ee7e98a9ff60ba6886e01f8aac2d8c0da2c792e26bdab28409e532577660bbd8727e3c307af8351efb3b19cb2defcc91d37235c6c8a43e712b355d53bb2a43

data/idrac.gemspec

@@ -32,7 +32,14 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   # Uncomment to register a new dependency of your gem
-  # spec.add_dependency "example-gem", "~> 1.0"
+  spec.add_dependency "httparty"
+  spec.add_dependency "nokogiri"
+
+  # Add dev dependencies:
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "debug"
 
   # For more information and examples about making a new gem, check out our
   # guide at: https://bundler.io/guides/creating_gem.html

data/lib/idrac/client.rb

@@ -0,0 +1,48 @@
+module Idrac
+  class Client
+    def initialize(url:)
+      @url = url
+      @cookies = nil
+    end
+
+    def login(user: 'root', password: 'calvin')
+      login_response = HTTParty.post(
+        "#{@url}/data/login",
+        body: { user: user, password: password },
+        headers: {
+          "User-Agent" => "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.114 Safari/537.36",
+          "Accept-Encoding" => "deflate, gzip"
+        },
+        verify: false
+      )
+      @cookies = login_response.headers['set-cookie']
+      xml_doc = Nokogiri::XML(login_response.body)
+
+      # Extract the forwardUrl from the XML
+      error_message = xml_doc.at_xpath('//errorMsg')&.text
+      # Error Message: The maximum number of user sessions has been reached!
+      if error_message && !error_message.empty?
+        raise "Error Message: #{error_message}"
+      end
+      forward_url = xml_doc.xpath('//forwardUrl').text
+    end
+
+    def logout
+      path = "data/logout"
+      res = get(path: path)
+      raise "Invalid login." unless res.code.between?(200, 299)
+    end
+      
+    def get(path:, headers: {})
+      response = HTTParty.get(
+        "#{@url}/#{path}",
+        headers: {
+          "User-Agent" => "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.114 Safari/537.36",
+          "Accept-Encoding" => "deflate, gzip",
+          "Cookie" => @cookies
+        }.merge(headers),
+        verify: false
+      )
+    end
+  end
+end

data/lib/idrac/screenshot.rb

@@ -0,0 +1,24 @@
+module Idrac
+  # Reverse engineered the screenshot functionality in iDRAC 2.X
+  # Emulates the manual screenshot functionality in the web UI.
+  class Client
+    def screenshot
+      forward_url = login
+      # Extract the key-value pairs from the forward URL
+      # index?ST1=ABC,ST2=DEF
+      tokens = forward_url.split("?").last.split(",").inject({}) { |acc,kv| k,v = kv.split("="); acc[k]=v; acc }
+      timestamp_ms = (Time.now.to_f * 1000).to_i
+      path = "data?get=consolepreview[manual%20#{timestamp_ms}]"
+      res = get(path: path, headers: tokens)
+      raise "Invalid login." unless res.code.between?(200, 299)
+      sleep 2
+      path = "capconsole/scapture0.png?#{timestamp_ms}"
+      res = get(path: path, headers: tokens)
+      raise "Invalid login." unless res.code.between?(200, 299)
+      filename = "#{timestamp_ms}.png"
+      File.write(filename, res.body)
+      logout
+      filename
+    end
+  end
+end

data/lib/idrac/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Idrac
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/lib/idrac.rb

@@ -1,8 +1,18 @@
 # frozen_string_literal: true
 
+require 'httparty'
+require 'nokogiri'
+# If dev, required debug
+require 'debug' if ENV['RUBY_ENV'] == 'development'
+
 require_relative "idrac/version"
+require_relative "idrac/client"
+require_relative "idrac/screenshot"
 
 module Idrac
   class Error < StandardError; end
   # Your code goes here...
+  def self.new(url:)
+    Client.new(url:)
+  end
 end

metadata

@@ -1,15 +1,99 @@
 --- !ruby/object:Gem::Specification
 name: idrac
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Jonathan Siegel
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-09-07 00:00:00.000000000 Z
-dependencies: []
+date: 2024-09-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A Ruby client for the Dell iDRAC API
 email:
 - "<248302+usiegj00@users.noreply.github.com>"
@@ -22,6 +106,8 @@ files:
 - Rakefile
 - idrac.gemspec
 - lib/idrac.rb
+- lib/idrac/client.rb
+- lib/idrac/screenshot.rb
 - lib/idrac/version.rb
 - sig/idrac.rbs
 homepage: http://github.com