net-tns 1.0.0

data/lib/net/tti/messages/function_calls/authentication_x64.rb

@@ -0,0 +1,42 @@
+require_relative "authentication"
+
+module Net
+  module TTI
+    class AuthenticationX64 < Authentication
+      uint32le  :unknown2,         :initial_value => 0x00001201
+      uint8     :unknown3,         :initial_value => 0x00
+      uint32le  :logon_mode,       :initial_value => :_logon_mode
+      uint8     :unknown4,         :initial_value => 0x01
+      uint32le  :parameter_count,  :value => lambda {parameters.count}
+      uint16le  :unknown5,         :initial_value => 0x0101
+      # username_length and username might be a chunked string, but we
+      # don't need to worry about chunking since Oracle usernames can't
+      # be longer than 30 characters.
+      uint8     :username_length,  :value => lambda { username.length }
+      string    :username
+      array     :parameters, :type => :key_value_pair, :read_until => lambda {index == parameter_count-1}
+
+      def _function_code
+        return FUNCTION_CODE_AUTH
+      end
+      private :_function_code
+
+      def _logon_mode
+        return Authentication::LOGON_MODE_AUTH
+      end
+      private :_logon_mode
+    end
+
+    class PreAuthenticationX64 < AuthenticationX64
+      def _function_code
+        return FUNCTION_CODE_PRE_AUTH
+      end
+      private :_function_code
+
+      def _logon_mode
+        return Authentication::LOGON_MODE_PRE_AUTH
+      end
+      private :_logon_mode
+    end
+  end
+end

data/lib/net/tti/messages/function_calls/authentication_x86.rb

@@ -0,0 +1,53 @@
+require_relative "authentication"
+
+module Net
+  module TTI
+    class AuthenticationX86 < Authentication
+      # Clients seem to change this without any effect on the server. It looks
+      # like it's probably 4 8-bit values, but if we're ignoring them all, we
+      # can ignore them as one structure
+      uint32le  :unknown2,         :initial_value => 0xFFFFFFFE
+      # Some Oracle clients instead send username.length*3 here to 11g servers,
+      # but it doesn't seem to matter
+      uint32le  :unknown3,         :value => lambda { username.length }
+      # 0x1 => preauth, 0x101 => auth
+      uint32le  :logon_mode,       :initial_value => :_logon_mode
+      # Ditto for unknown2. Oracle clients put the same value into the upper
+      # 16 bits of unknown4, unknown5 and unknown6 in each request, but I can't
+      # figure out its meaning
+      uint32le  :unknown4,         :initial_value => 0xFFFFFFFE
+      uint32le  :parameter_count,  :value => lambda {parameters.count}
+                # See unknown4
+      uint32le  :unknown5,         :initial_value => 0xFFFFFFFE
+      uint32le  :unknown6,         :initial_value => 0xFFFFFFFE
+      # username_length and username might be a chunked string, but we
+      # don't need to worry about chunking since Oracle usernames can't
+      # be longer than 30 characters
+      uint8     :username_length,  :value => lambda { username.length }
+      string    :username
+      array     :parameters, :type => :key_value_pair, :read_until => lambda {index == parameter_count-1}
+
+      def _function_code
+        return FUNCTION_CODE_AUTH
+      end
+      private :_function_code
+
+      def _logon_mode
+        return Authentication::LOGON_MODE_AUTH
+      end
+      private :_logon_mode
+    end
+
+    class PreAuthenticationX86 < AuthenticationX86
+      def _function_code
+        return FUNCTION_CODE_PRE_AUTH
+      end
+      private :_function_code
+
+      def _logon_mode
+        return Authentication::LOGON_MODE_PRE_AUTH
+      end
+      private :_logon_mode
+    end
+  end
+end

data/lib/net/tti/messages/function_calls/pre_authentication_response.rb

@@ -0,0 +1,32 @@
+require "net/tti/data_types"
+
+module Net
+  module TTI
+    class PreAuthenticationResponse < Message
+      uint16le  :parameter_count
+      array     :parameters, :type => :key_value_pair, :read_until => lambda {index == parameter_count-1}
+
+      def _ttc_code
+        return TTC_CODE_OK
+      end
+      private :_ttc_code
+
+      def auth_sesskey
+        param = find_param("AUTH_SESSKEY", true)
+        return param.kvp_value.tns_unhexify
+      end
+
+      def auth_vfr_data
+        param = find_param("AUTH_VFR_DATA", true)
+        return param.kvp_value.tns_unhexify
+      end
+
+      def find_param(key, raise_if_not_found=false)
+        param = self.parameters.find {|p| p.kvp_key == key}
+        raise "No #{key} parameter found" if param.nil? && raise_if_not_found
+        return param
+      end
+      private :find_param
+    end
+  end
+end

data/lib/net/tti/messages/protocol_negotiation_request.rb

@@ -0,0 +1,29 @@
+module Net
+  module TTI
+    class ProtocolNegotiationRequest < Message
+      # BinData fields
+      # In the request, this will be the version(s) the client supports; in the
+      # response, this will be the version the server chooses. These are a
+      # concatenated string of version numbers (e.g. 060504).
+      stringz   :client_versions_string
+      stringz   :protocol_handler
+
+      def _ttc_code
+        TTC_CODE_PROTOCOL_NEGOTIATION
+      end
+      private :_ttc_code
+
+      def self.create_request(client_versions=[6], protocol_handler="IBMPC/WIN_NT-8.1.0")
+        request = self.new
+        request.client_versions = client_versions
+        request.protocol_handler = protocol_handler
+
+        return request
+      end
+
+      def client_versions=(versions)
+        self.client_versions_string = versions.pack("C*")
+      end
+    end
+  end
+end

data/lib/net/tti/messages/protocol_negotiation_response.rb

@@ -0,0 +1,44 @@
+module Net
+  module TTI
+    class ProtocolNegotiationResponse < Message
+      handles_response_for_ttc_code TTC_CODE_PROTOCOL_NEGOTIATION
+
+      # BinData fields
+      stringz   :versions_string  # The protocol (TTC?) version negotiated
+      stringz   :protocol_handler
+      uint16le  :character_set
+
+      uint8     :unknown1
+      uint16le  :unknown2_length
+      string    :unknown2,  :read_length => lambda {unknown2_length * 5}
+      uint16be  :unknown3_length
+      string    :unknown3,  :read_length => :unknown3_length
+      uint8     :unknown4_length
+      string    :unknown4,  :read_length => :unknown4_length
+      uint8     :unknown5_length
+      string    :unknown5,  :read_length => :unknown5_length
+
+      def version
+        self.versions_string[0,1].unpack("C").first
+      end
+
+      def populate_connection_parameters( conn_params )
+        conn_params.ttc_version = self.version
+
+        case self.protocol_handler
+        when "IBMPC/WIN_NT-8.1.0"
+          conn_params.architecture = :x86
+          conn_params.platform = :windows
+        when "Linuxi386/Linux-2.0.34-8.1.0"
+          conn_params.architecture = :x86
+          conn_params.platform = :linux
+        when "x86_64/Linux 2.4.xx"
+          conn_params.architecture = :x64
+          conn_params.platform = :linux
+        else
+          raise Net::TTI::Exceptions::UnsupportedPlatform.new( self.protocol_handler )
+        end
+      end
+    end
+  end
+end

data/lib/net/tti.rb

@@ -0,0 +1,18 @@
+require "net/tns/helpers/string_helpers"
+
+module Net
+  module TTI
+    require "pathname"
+    Dir.glob("#{Pathname.new(__FILE__).dirname}/tti/*.rb") { |file| require file }
+
+    def self.logger
+      unless defined?(@@logger)
+        require "logger"
+        @@logger = Logger.new(STDERR)
+        @@logger.progname = "Net::TTI"
+        @@logger.sev_threshold = 6 unless $DEBUG
+      end
+      return @@logger
+    end
+  end
+end

metadata

@@ -0,0 +1,128 @@
+--- !ruby/object:Gem::Specification
+name: net-tns
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Chris Woodbury
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-11-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bindata
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-its
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: A pure Ruby (partial) implementation of the Oracle TNS protocol
+email: woodbusy@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- bin/tns_oradb_version.rb
+- bin/tns_sid_enumeration.rb
+- bin/tns_sid_list.rb
+- lib/net/tns.rb
+- lib/net/tns/client.rb
+- lib/net/tns/connection.rb
+- lib/net/tns/exceptions.rb
+- lib/net/tns/gem_version.rb
+- lib/net/tns/helpers/string_helpers.rb
+- lib/net/tns/packet.rb
+- lib/net/tns/packets/abort_packet.rb
+- lib/net/tns/packets/accept_packet.rb
+- lib/net/tns/packets/ack_packet.rb
+- lib/net/tns/packets/attention_packet.rb
+- lib/net/tns/packets/connect_packet.rb
+- lib/net/tns/packets/control_packet.rb
+- lib/net/tns/packets/data_packet.rb
+- lib/net/tns/packets/marker_packet.rb
+- lib/net/tns/packets/null_packet.rb
+- lib/net/tns/packets/redirect_packet.rb
+- lib/net/tns/packets/refuse_packet.rb
+- lib/net/tns/packets/resend_packet.rb
+- lib/net/tns/version.rb
+- lib/net/tti.rb
+- lib/net/tti/client.rb
+- lib/net/tti/connection.rb
+- lib/net/tti/crypto.rb
+- lib/net/tti/data_types.rb
+- lib/net/tti/data_types/chunked_string.rb
+- lib/net/tti/data_types/key_value_pair.rb
+- lib/net/tti/exceptions.rb
+- lib/net/tti/message.rb
+- lib/net/tti/messages/data_type_negotiation_request.rb
+- lib/net/tti/messages/data_type_negotiation_response.rb
+- lib/net/tti/messages/error_message.rb
+- lib/net/tti/messages/function_call.rb
+- lib/net/tti/messages/function_calls/authentication.rb
+- lib/net/tti/messages/function_calls/authentication_x64.rb
+- lib/net/tti/messages/function_calls/authentication_x86.rb
+- lib/net/tti/messages/function_calls/pre_authentication_response.rb
+- lib/net/tti/messages/protocol_negotiation_request.rb
+- lib/net/tti/messages/protocol_negotiation_response.rb
+homepage: https://github.com/SpiderLabs/net-tns
+licenses:
+- Apache-2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Ruby implementation of the Oracle TNS protocol
+test_files: []