ec2-signature 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/*
+*.gem
+.bundle

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in ec2-signature.gemspec
+gemspec

data/README

@@ -0,0 +1,31 @@
+Code borrowed from fog (https://github.com/geemus/fog).
+
+This gem will simply generate the AWS EC2 signature so that you can use your own HTTP methods and libraries to POST to your choice of AWS/EC2 compatible API servers such as Eucalyptus, OpenNebula, OpenAuth.  Apparently, most of the AWS/EC2 API gems out there are not compatible with the aforementioned cloud frameworks, due to running on a custom port they do not account for that when generating the signature.  Fog had implemented a compatible signature method, however, I did not want to use the EXCON http library implemented in it so I extracted the signature method only for use with my own choice of HTTP library.
+
+##############################
+####  OpenStack Example 1 ####
+##############################
+
+require 'ec2-signature'
+# pass a hash containing your aws auth params to new obj
+mysig = EC2Signature.new( {
+            :access_id => ,
+            :secret_key => ,
+            :ec2_url => 'http://myec2server:8773/services/Cloud'
+          } )
+# generate the signature provided the query action you want to issue to your ec2 provider
+signature = mysig.sign( {'Action' => 'DescribeImages'} )
+# use the example net/http post method to post your signature to the ec2_url specified above
+mysig.post signature
+
+
+##############################
+####  OpenStack Example 2 ####
+##############################
+mysig.path = '/services/Admin'
+# opennebula's aws/ec2 api implementation has a diff path for admin cmds
+signature = mysig.sign( {
+                'Action' => 'DescribeUser', 
+                'Name' => 'jsmith',
+              } )
+mysig.post signature

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/ec2-signature.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "ec2-signature/version"
+
+Gem::Specification.new do |s|
+  s.name        = "ec2-signature"
+  s.version     = Ec2::Signature::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["John Tran"]
+  s.email       = ["jtran@attinteractive.com"]
+  s.homepage    = "http://rubygems.org/gems/ec2-signature"
+  s.summary     = %q{generate a signature to be posted to any EC2 compatible API}
+  s.description = %q{AWS EC2 API generates signatures to authenticate.  This will generate one that is compatible even with Eucalyptus, OpenNebula & OpenStack.}
+
+  s.rubyforge_project = "ec2-signature"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/ec2-signature.rb

@@ -0,0 +1,58 @@
+require 'uri'
+require 'openssl'
+require 'base64'
+require 'cgi'
+
+class Ec2Signature
+
+  attr_accessor :accessid, :secretkey, :ec2url, :host, :port, :path, :scheme
+
+  def initialize creds
+    raise "Need a hash of AWS/EC2 credential info" unless creds.kind_of? Hash
+    [:accessid, :secretkey, :ec2url].each do |a| 
+      raise "Credential hash requires :accessid, :secretkey & :ec2url" unless creds[a]
+    end
+    self.accessid = creds[:accessid]
+    self.secretkey = creds[:secretkey]
+    self.ec2url = creds[:ec2url]
+    uri = URI.parse creds[:ec2url]
+    self.host = uri.host
+    self.scheme = uri.scheme
+    self.path = uri.path
+    self.port = uri.port
+  end
+
+  def sign actionparams={'Action'=>'DescribeInstances'}
+    raise "hash of AWS EC2 web params action required" unless actionparams.kind_of? Hash
+    raise "hash missing 'Action' key/value"  unless actionparams['Action']
+
+    actionparams.merge!({
+      'AWSAccessKeyId'    => accessid,
+      'SignatureMethod'   => 'HmacSHA256',
+      'SignatureVersion'  => '2',
+      'Timestamp'         => Time.now.utc.strftime("%Y-%m-%dT%H:%M:%SZ"),
+      'Version'           => '2010-08-31'
+    })
+
+    body = ''
+    for key in actionparams.keys.sort
+      unless (value = actionparams[key]).nil?
+        body << "#{key}=#{CGI.escape(value.to_s).gsub(/\+/, '%20')}&"
+      end
+    end
+    string_to_sign = "POST\n#{host}:#{port}\n#{path}\n" << body.chop
+    digest = OpenSSL::Digest::Digest.new('sha256')
+    signed_string = OpenSSL::HMAC.digest(digest, secretkey, string_to_sign)
+    body << "Signature=#{CGI.escape(Base64.encode64(signed_string).chomp!).gsub(/\+/, '%20')}"
+
+    body
+  end
+
+  def post signature=sign
+    require 'net/http'
+    http = Net::HTTP.new host, port
+    resp = http.post path, signature
+    resp.body
+  end
+
+end

data/lib/ec2-signature/version.rb

@@ -0,0 +1,5 @@
+module Ec2
+  module Signature
+    VERSION = "0.0.1"
+  end
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification 
+name: ec2-signature
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- John Tran
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-10 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: AWS EC2 API generates signatures to authenticate.  This will generate one that is compatible even with Eucalyptus, OpenNebula & OpenStack.
+email: 
+- jtran@attinteractive.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README
+- Rakefile
+- ec2-signature.gemspec
+- lib/ec2-signature.rb
+- lib/ec2-signature/version.rb
+has_rdoc: true
+homepage: http://rubygems.org/gems/ec2-signature
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: ec2-signature
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: generate a signature to be posted to any EC2 compatible API
+test_files: []
+