rex 2.0.5 → 2.0.7

data/lib/rex/proto/kerberos/credential_cache.rb

@@ -0,0 +1,19 @@
+# -*- coding: binary -*-
+
+module Rex
+  module Proto
+    module Kerberos
+      module CredentialCache
+        VERSION = 0x0504
+        HEADER = "\x00\x08\xff\xff\xff\xff\x00\x00\x00\x00"
+      end
+    end
+  end
+end
+
+require 'rex/proto/kerberos/credential_cache/element'
+require 'rex/proto/kerberos/credential_cache/key_block'
+require 'rex/proto/kerberos/credential_cache/principal'
+require 'rex/proto/kerberos/credential_cache/time'
+require 'rex/proto/kerberos/credential_cache/credential'
+require 'rex/proto/kerberos/credential_cache/cache'

data/lib/rex/proto/kerberos/credential_cache/cache.rb

@@ -0,0 +1,81 @@
+# -*- coding: binary -*-
+
+module Rex
+  module Proto
+    module Kerberos
+      module CredentialCache
+        # This class provides a representation of a Kerberos Credential Cache.
+        class Cache < Element
+
+          # @!attribute version
+          #   @return [Fixnum] The file format version
+          attr_accessor :version
+          # @!attribute headers
+          #   @return [Array<String>] The header tags
+          attr_accessor :headers
+          # @!attribute primary_principal
+          #   @return [Rex::Proto::Kerberos::CredentialCache::Principal] The principal cache's owner
+          attr_accessor :primary_principal
+          # @!attribute credentials
+          #   @return [Array<Rex::Proto::Kerberos::CredentialCache::Credential>] The primary principal credentials
+          attr_accessor :credentials
+
+          # Encodes the Rex::Proto::Kerberos::CredentialCache::Cache into an String
+          #
+          # @return [String] encoded cache
+          def encode
+            encoded = ''
+            encoded << encode_version
+            encoded << encode_headers
+            encoded << encode_primary_principal
+            encoded << encode_credentials
+          end
+
+          private
+
+          # Encodes the version field
+          #
+          # @return [String]
+          def encode_version
+            [version].pack('n')
+          end
+
+          # Encodes the headers field
+          #
+          # @return [String]
+          def encode_headers
+            headers_encoded = ''
+            headers_encoded << [headers.length].pack('n')
+            headers.each do |h|
+              headers_encoded << h
+            end
+
+            encoded = ''
+            encoded << [headers_encoded.length].pack('n')
+            encoded << headers_encoded
+
+            encoded
+          end
+
+          # Encodes the primary_principal field
+          #
+          # @return [String]
+          def encode_primary_principal
+            primary_principal.encode
+          end
+
+          # Encodes the credentials field
+          #
+          # @return [String]
+          def encode_credentials
+            encoded = ''
+            credentials.each do |cred|
+              encoded << cred.encode
+            end
+            encoded
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rex/proto/kerberos/credential_cache/credential.rb

@@ -0,0 +1,151 @@
+# -*- coding: binary -*-
+
+module Rex
+  module Proto
+    module Kerberos
+      module CredentialCache
+        # This class provides a representation of a Credential stored in the Kerberos Credential Cache.
+        class Credential < Element
+          # @!attribute client
+          #   @return [Rex::Proto::Kerberos::CredentialCache::Principal]
+          attr_accessor :client
+          # @!attribute server
+          #   @return [Rex::Proto::Kerberos::CredentialCache::Principal]
+          attr_accessor :server
+          # @!attribute key
+          #   @return [Rex::Proto::Kerberos::CredentialCache::KeyBlock]
+          attr_accessor :key
+          # @!attribute time
+          #   @return [Rex::Proto::Kerberos::CredentialCache::Time]
+          attr_accessor :time
+          # @!attribute is_skey
+          #   @return [Fixnum]
+          attr_accessor :is_skey
+          # @!attribute tkt_flags
+          #   @return [Fixnum]
+          attr_accessor :tkt_flags
+          # @!attribute addrs
+          #   @return [Array]
+          attr_accessor :addrs
+          # @!attribute auth_data
+          #   @return [Array]
+          attr_accessor :auth_data
+          # @!attribute ticket
+          #   @return [String]
+          attr_accessor :ticket
+          # @!attribute second_ticket
+          #   @return [String]
+          attr_accessor :second_ticket
+
+          # Encodes the Rex::Proto::Kerberos::CredentialCache::Credential into an String
+          #
+          # @return [String] encoded credential
+          def encode
+            encoded = ''
+            encoded << encode_client
+            encoded << encode_server
+            encoded << encode_key
+            encoded << encode_time
+            encoded << encode_is_skey
+            encoded << encode_tkt_flags
+            encoded << encode_addrs
+            encoded << encode_auth_data
+            encoded << encode_ticket
+            encoded << encode_second_ticket
+          end
+
+          private
+
+          # Encodes the client field
+          #
+          # @return [String]
+          def encode_client
+            client.encode
+          end
+
+          # Encodes the server field
+          #
+          # @return [String]
+          def encode_server
+            server.encode
+          end
+
+          # Encodes the key field
+          #
+          # @return [String]
+          def encode_key
+            key.encode
+          end
+
+          # Encodes the time field
+          #
+          # @return [String]
+          def encode_time
+            time.encode
+          end
+
+          # Encodes the is_skey field
+          #
+          # @return [String]
+          def encode_is_skey
+            [is_skey].pack('C')
+          end
+
+          # Encodes the tkt_flags field
+          #
+          # @return [String]
+          def encode_tkt_flags
+            [tkt_flags].pack('N')
+          end
+
+          # Encodes the addrs field
+          #
+          # @return [String]
+          # @raise [NotImplementedError] if there are addresses to encode
+          def encode_addrs
+            encoded = ''
+            if addrs.length > 0
+              raise ::NotImplementedError, 'CredentialCache: Credential addresses encoding not supported'
+            end
+            encoded << [addrs.length].pack('N')
+            encoded
+          end
+
+          # Encodes the auth_data field
+          #
+          # @return [String]
+          def encode_auth_data
+            encoded = ''
+            if auth_data.length > 0
+              raise ::RuntimeError, 'CredentialCache: Credential auth_data encoding not supported'
+            end
+            encoded << [auth_data.length].pack('N')
+            encoded
+          end
+
+          # Encodes the ticket field
+          #
+          # @return [String]
+          def encode_ticket
+            encoded = ''
+            encoded << [ticket.length].pack('N')
+            encoded << ticket
+
+            encoded
+          end
+
+          # Encodes the second_ticket field
+          #
+          # @return [String]
+          def encode_second_ticket
+            encoded = ''
+            encoded << [second_ticket.length].pack('N')
+            encoded << second_ticket
+
+            encoded
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rex/proto/kerberos/credential_cache/element.rb

@@ -0,0 +1,49 @@
+# -*- coding: binary -*-
+
+module Rex
+  module Proto
+    module Kerberos
+      module CredentialCache
+        class Element
+
+          def self.attr_accessor(*vars)
+            @attributes ||= []
+            @attributes.concat vars
+            super(*vars)
+          end
+
+          # Retrieves the element class fields
+          #
+          # @return [Array]
+          def self.attributes
+            @attributes
+          end
+
+          def initialize(options = {})
+            self.class.attributes.each do |attr|
+              if options.has_key?(attr)
+                m = (attr.to_s + '=').to_sym
+                self.send(m, options[attr])
+              end
+            end
+          end
+
+          # Retrieves the element instance fields
+          #
+          # @return [Array]
+          def attributes
+            self.class.attributes
+          end
+
+          # Encodes the Rex::Proto::Kerberos::CredentialCache::Element into an String. This
+          # method has been designed to be overridden by subclasses.
+          #
+          # @raise [NoMethodError]
+          def encode
+            raise ::NoMethodError, 'Method designed to be overridden'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rex/proto/kerberos/credential_cache/key_block.rb

@@ -0,0 +1,62 @@
+# -*- coding: binary -*-
+
+module Rex
+  module Proto
+    module Kerberos
+      module CredentialCache
+
+        # This class provides a representation of a credential keys stored in the Kerberos Credential Cache.
+        class KeyBlock < Element
+          # @!attribute key_type
+          #   @return [Fixnum]
+          attr_accessor :key_type
+          # @!attribute e_type
+          #   @return [Fixnum]
+          attr_accessor :e_type
+          # @!attribute key_value
+          #   @return [String]
+          attr_accessor :key_value
+
+          # Encodes the Rex::Proto::Kerberos::CredentialCache::KeyBlock into an String
+          #
+          # @return [String] encoded key
+          def encode
+            encoded = ''
+            encoded << encode_key_type
+            encoded << encode_e_type
+            encoded << encode_key_value
+
+            encoded
+          end
+
+          private
+
+          # Encodes the key_type field
+          #
+          # @return [String]
+          def encode_key_type
+            [key_type].pack('n')
+          end
+
+          # Encodes the e_type field
+          #
+          # @return [String]
+          def encode_e_type
+            [e_type].pack('n')
+          end
+
+          # Encodes the key_value field
+          #
+          # @return [String]
+          def encode_key_value
+            encoded = ''
+            encoded << [key_value.length].pack('n')
+            encoded << key_value
+
+            encoded
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rex/proto/kerberos/credential_cache/principal.rb

@@ -0,0 +1,70 @@
+# -*- coding: binary -*-
+
+module Rex
+  module Proto
+    module Kerberos
+      module CredentialCache
+        # This class provides a representation of a Principal stored in the Kerberos Credential Cache.
+        class Principal < Element
+          # @!attribute name_type
+          #   @return [Fixnum]
+          attr_accessor :name_type
+          # @!attribute realm
+          #   @return [String]
+          attr_accessor :realm
+          # @!attribute components
+          #   @return [Array<String>]
+          attr_accessor :components
+
+          # Encodes the Rex::Proto::Kerberos::CredentialCache::Principal into an String
+          #
+          # @return [String] encoded principal
+          def encode
+            encoded = ''
+            encoded << encode_name_type
+            encoded << [components.length].pack('N')
+            encoded << encode_realm
+            encoded << encode_components
+
+            encoded
+          end
+
+          private
+
+          # Encodes the name_type field
+          #
+          # @return [String]
+          def encode_name_type
+            [name_type].pack('N')
+          end
+
+          # Encodes the realm field
+          #
+          # @return [String]
+          def encode_realm
+            encoded = ''
+            encoded << [realm.length].pack('N')
+            encoded << realm
+
+            encoded
+          end
+
+          # Encodes the components field
+          #
+          # @return [String]
+          def encode_components
+            encoded = ''
+
+            components.each do |c|
+              encoded << [c.length].pack('N')
+              encoded << c
+            end
+
+            encoded
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/rex/proto/kerberos/credential_cache/time.rb

@@ -0,0 +1,69 @@
+# -*- coding: binary -*-
+
+module Rex
+  module Proto
+    module Kerberos
+      module CredentialCache
+        # This class provides a representation of credential times stored in the Kerberos Credential Cache.
+        class Time < Element
+          # @!attribute auth_time
+          #   @return [Fixnum]
+          attr_accessor :auth_time
+          # @!attribute start_time
+          #   @return [Fixnum]
+          attr_accessor :start_time
+          # @!attribute end_time
+          #   @return [Fixnum]
+          attr_accessor :end_time
+          # @!attribute renew_till
+          #   @return [Fixnum]
+          attr_accessor :renew_till
+
+          # Encodes the Rex::Proto::Kerberos::CredentialCache::Time into an String
+          #
+          # @return [String] encoded time
+          def encode
+            encoded = ''
+            encoded << encode_auth_time
+            encoded << encode_start_time
+            encoded << encode_end_time
+            encoded << encode_renew_time
+
+            encoded
+          end
+
+          private
+
+          # Encodes the auth_time field
+          #
+          # @return [String]
+          def encode_auth_time
+            [auth_time].pack('N')
+          end
+
+          # Encodes the start_time field
+          #
+          # @return [String]
+          def encode_start_time
+            [start_time].pack('N')
+          end
+
+          # Encodes the end_time field
+          #
+          # @return [String]
+          def encode_end_time
+            [end_time].pack('N')
+          end
+
+          # Encodes the renew_time field
+          #
+          # @return [String]
+          def encode_renew_time
+            [renew_till].pack('N')
+          end
+
+        end
+      end
+    end
+  end
+end