ruby-hmac 0.3.1

data/History.txt

@@ -0,0 +1,4 @@
+== 0.3.1 / 2007-08-13
+
+* Converted to gem by Geoffrey Grosenbach
+* Tests converted to Test::Unit

data/Manifest.txt

@@ -0,0 +1,12 @@
+History.txt
+lib
+lib/hmac-md5.rb
+lib/hmac-rmd160.rb
+lib/hmac-sha1.rb
+lib/hmac-sha2.rb
+lib/hmac.rb
+Manifest.txt
+Rakefile
+README.txt
+test/
+test/test_hmac.rb

data/README.txt

@@ -0,0 +1,35 @@
+ruby-hmac
+    by Daiki Ueno
+    http://ruby-hmac.rubyforge.org
+
+== DESCRIPTION:
+  
+This module provides common interface to HMAC functionality. HMAC is a kind of "Message Authentication Code" (MAC) algorithm whose standard is documented in RFC2104. Namely, a MAC provides a way to check the integrity of information transmitted over or stored in an unreliable medium, based on a secret key.
+
+Originally written by Daiki Ueno. Converted to a RubyGem by Geoffrey Grosenbach
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2007 Daiki Ueno
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/Rakefile

@@ -0,0 +1,15 @@
+require 'rubygems'
+require 'hoe'
+$:.unshift(File.dirname(__FILE__) + "/lib")
+require 'hmac'
+
+Hoe.new('ruby-hmac', HMAC::VERSION) do |p|
+  p.name = "ruby-hmac"
+  p.author = ["Daiki Ueno", "Geoffrey Grosenbach"]
+  p.email = 'boss@topfunky.com'
+  p.summary = "An implementation of the HMAC authentication code in Ruby."
+  p.description = "A MAC provides a way to check the integrity of information transmitted over or stored in an unreliable medium, based on a secret key."
+  p.url = "http://ruby-hmac.rubyforge.org"
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+  p.remote_rdoc_dir = '' # Release to root
+end

data/lib/hmac-md5.rb

@@ -0,0 +1,11 @@
+require 'hmac'
+require 'digest/md5'
+
+module HMAC
+  class MD5 < Base
+    def initialize(key = nil)
+      super(Digest::MD5, 64, 16, key)
+    end
+    public_class_method :new, :digest, :hexdigest
+  end
+end

data/lib/hmac-rmd160.rb

@@ -0,0 +1,11 @@
+require 'hmac'
+require 'digest/rmd160'
+
+module HMAC
+  class RMD160 < Base
+    def initialize(key = nil)
+      super(Digest::RMD160, 64, 20, key)
+    end
+    public_class_method :new, :digest, :hexdigest
+  end
+end

data/lib/hmac-sha1.rb

@@ -0,0 +1,11 @@
+require 'hmac'
+require 'digest/sha1'
+
+module HMAC
+  class SHA1 < Base
+    def initialize(key = nil)
+      super(Digest::SHA1, 64, 20, key)
+    end
+    public_class_method :new, :digest, :hexdigest
+  end
+end

data/lib/hmac-sha2.rb

@@ -0,0 +1,25 @@
+require 'hmac'
+require 'digest/sha2'
+
+module HMAC
+  class SHA256 < Base
+    def initialize(key = nil)
+      super(Digest::SHA256, 64, 32, key)
+    end
+    public_class_method :new, :digest, :hexdigest
+  end
+
+  class SHA384 < Base
+    def initialize(key = nil)
+      super(Digest::SHA384, 128, 48, key)
+    end
+    public_class_method :new, :digest, :hexdigest
+  end
+
+  class SHA512 < Base
+    def initialize(key = nil)
+      super(Digest::SHA512, 128, 64, key)
+    end
+    public_class_method :new, :digest, :hexdigest
+  end
+end

data/lib/hmac.rb

@@ -0,0 +1,115 @@
+# Copyright (C) 2001  Daiki Ueno <ueno@unixuser.org>
+# This library is distributed under the terms of the Ruby license.
+
+# This module provides common interface to HMAC engines.
+# HMAC standard is documented in RFC 2104:
+#
+#   H. Krawczyk et al., "HMAC: Keyed-Hashing for Message Authentication",
+#   RFC 2104, February 1997
+#
+# These APIs are inspired by JCE 1.2's javax.crypto.Mac interface.
+#
+#   <URL:http://java.sun.com/security/JCE1.2/spec/apidoc/javax/crypto/Mac.html>
+
+module HMAC
+  
+  VERSION = '0.3.1'
+  
+  class Base
+    def initialize(algorithm, block_size, output_length, key)
+      @algorithm = algorithm
+      @block_size = block_size
+      @output_length = output_length
+      @status = STATUS_UNDEFINED
+      @key_xor_ipad = ''
+      @key_xor_opad = ''
+      set_key(key) unless key.nil?
+    end
+
+    private
+    def check_status
+      unless @status == STATUS_INITIALIZED
+	raise RuntimeError,
+	  "The underlying hash algorithm has not yet been initialized."
+      end
+    end
+
+    public
+    def set_key(key)
+      # If key is longer than the block size, apply hash function
+      # to key and use the result as a real key.
+      key = @algorithm.digest(key) if key.size > @block_size
+      key_xor_ipad = "\x36" * @block_size
+      key_xor_opad = "\x5C" * @block_size
+      for i in 0 .. key.size - 1
+	key_xor_ipad[i] ^= key[i]
+	key_xor_opad[i] ^= key[i]
+      end
+      @key_xor_ipad = key_xor_ipad
+      @key_xor_opad = key_xor_opad
+      @md = @algorithm.new
+      @status = STATUS_INITIALIZED
+    end
+
+    def reset_key
+      @key_xor_ipad.gsub!(/./, '?')
+      @key_xor_opad.gsub!(/./, '?')
+      @key_xor_ipad[0..-1] = ''
+      @key_xor_opad[0..-1] = ''
+      @status = STATUS_UNDEFINED
+    end
+
+    def update(text)
+      check_status
+      # perform inner H
+      md = @algorithm.new
+      md.update(@key_xor_ipad)
+      md.update(text)
+      str = md.digest
+      # perform outer H
+      md = @algorithm.new
+      md.update(@key_xor_opad)
+      md.update(str)
+      @md = md
+    end
+    alias << update
+
+    def digest
+      check_status
+      @md.digest
+    end
+
+    def hexdigest
+      check_status
+      @md.hexdigest
+    end
+    alias to_s hexdigest
+
+    # These two class methods below are safer than using above
+    # instance methods combinatorially because an instance will have
+    # held a key even if it's no longer in use.
+    def Base.digest(key, text)
+      begin
+	hmac = self.new(key)
+	hmac.update(text)
+	hmac.digest
+      ensure
+	hmac.reset_key
+      end
+    end
+
+    def Base.hexdigest(key, text)
+      begin
+	hmac = self.new(key)
+	hmac.update(text)
+	hmac.hexdigest
+      ensure
+	hmac.reset_key
+      end
+    end
+
+    private_class_method :new, :digest, :hexdigest
+  end
+
+  STATUS_UNDEFINED, STATUS_INITIALIZED = 0, 1
+end

data/test/test_hmac.rb

@@ -0,0 +1,92 @@
+#!/usr/bin/env ruby
+
+require 'test/unit'
+
+require 'hmac-md5'
+require 'hmac-sha1'
+
+class TestHMAC < Test::Unit::TestCase
+
+  def test_s_digest
+    key = "\x0b" * 16
+    text = "Hi There"
+
+    hmac = HMAC::MD5.new(key)
+    hmac.update(text)
+    
+    assert_equal(hmac.digest, HMAC::MD5.digest(key, text))
+  end
+
+  def test_s_hexdigest
+    key = "\x0b" * 16
+    text = "Hi There"
+
+    hmac = HMAC::MD5.new(key)
+    hmac.update(text)
+    
+    assert_equal(hmac.hexdigest, HMAC::MD5.hexdigest(key, text))
+  end
+
+  def test_hmac_md5_1
+    assert_equal(HMAC::MD5.hexdigest("\x0b" * 16, "Hi There"),
+		 "9294727a3638bb1c13f48ef8158bfc9d")
+  end
+
+  def test_hmac_md5_2
+    assert_equal(HMAC::MD5.hexdigest("Jefe", "what do ya want for nothing?"),
+		 "750c783e6ab0b503eaa86e310a5db738")
+  end
+
+  def test_hmac_md5_3
+    assert_equal(HMAC::MD5.hexdigest("\xaa" * 16, "\xdd" * 50),
+		 "56be34521d144c88dbb8c733f0e8b3f6")
+  end
+
+  def test_hmac_md5_4
+    assert_equal(HMAC::MD5.hexdigest(["0102030405060708090a0b0c0d0e0f10111213141516171819"].pack("H*"), "\xcd" * 50),
+		 "697eaf0aca3a3aea3a75164746ffaa79")
+  end
+
+  def test_hmac_md5_5
+    assert_equal(HMAC::MD5.hexdigest("\x0c" * 16, "Test With Truncation"),
+		 "56461ef2342edc00f9bab995690efd4c")
+  end
+
+#  def test_hmac_md5_6
+#    assert_equal(HMAC::MD5.hexdigest("\x0c" * 16, "Test With Truncation"),
+#		 "56461ef2342edc00f9bab995")
+#  end
+
+  def test_hmac_md5_7
+    assert_equal(HMAC::MD5.hexdigest("\xaa" * 80, "Test Using Larger Than Block-Size Key - Hash Key First"),
+		 "6b1ab7fe4bd7bf8f0b62e6ce61b9d0cd")
+  end
+
+  def test_hmac_md5_8
+    assert_equal(HMAC::MD5.hexdigest("\xaa" * 80, "Test Using Larger Than Block-Size Key and Larger Than One Block-Size Data"),
+		 "6f630fad67cda0ee1fb1f562db3aa53e")
+  end
+
+  def test_reset_key
+    hmac = HMAC::MD5.new("key")
+    assert_nothing_raised {
+      hmac.reset_key
+    }
+    assert_raise(RuntimeError) {
+      hmac.update("foo")
+    }
+  end
+
+  def test_set_key
+    hmac = HMAC::MD5.new
+    assert_raise(RuntimeError) {
+      hmac.update("foo")
+    }
+    assert_nothing_raised {
+      hmac.reset_key
+    }
+    assert_raise(RuntimeError) {
+      hmac.update("foo")
+    }
+  end
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.0
+specification_version: 1
+name: ruby-hmac
+version: !ruby/object:Gem::Version 
+  version: 0.3.1
+date: 2007-08-13 00:00:00 -07:00
+summary: An implementation of the HMAC authentication code in Ruby.
+require_paths: 
+- lib
+email: boss@topfunky.com
+homepage: http://ruby-hmac.rubyforge.org
+rubyforge_project: ruby-hmac
+description: A MAC provides a way to check the integrity of information transmitted over or stored in an unreliable medium, based on a secret key.
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Daiki Ueno
+- Geoffrey Grosenbach
+files: 
+- History.txt
+- lib
+- lib/hmac-md5.rb
+- lib/hmac-rmd160.rb
+- lib/hmac-sha1.rb
+- lib/hmac-sha2.rb
+- lib/hmac.rb
+- Manifest.txt
+- Rakefile
+- README.txt
+- test/
+- test/test_hmac.rb
+test_files: 
+- test/test_hmac.rb
+rdoc_options: 
+- --main
+- README.txt
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.2
+    version: