module AWS::Core::Signature::Version4

Public Class Methods

included(base) click to toggle source
# File lib/aws/core/signature/version_4.rb, line 23
def self.included base
  base.send(:include, Signer)
end

Public Instance Methods

add_authorization!(credentials) click to toggle source
# File lib/aws/core/signature/version_4.rb, line 27
def add_authorization! credentials
  datetime = Time.now.utc.strftime("%Y%m%dT%H%M%SZ")
  headers['content-type'] ||= 'application/x-www-form-urlencoded'
  headers['host'] = host
  headers['x-amz-date'] = datetime
  headers['x-amz-security-token'] = credentials.session_token if
    credentials.session_token
  headers['authorization'] = authorization(credentials, datetime)
end

Protected Instance Methods

authorization(credentials, datetime) click to toggle source
# File lib/aws/core/signature/version_4.rb, line 39
def authorization credentials, datetime
  parts = []
  parts << "AWS4-HMAC-SHA256 Credential=#{credentials.access_key_id}/#{credential_string(datetime)}"
  parts << "SignedHeaders=#{signed_headers}"
  parts << "Signature=#{hex16(signature(credentials, datetime))}"
  parts.join(', ')
end
canonical_header_values(values) click to toggle source
# File lib/aws/core/signature/version_4.rb, line 105
def canonical_header_values values
  values = [values] unless values.is_a?(Array)
  values.map(&:to_s).map(&:strip).join(',')
end
canonical_headers() click to toggle source
# File lib/aws/core/signature/version_4.rb, line 96
def canonical_headers
  headers = []
  self.headers.each_pair do |k,v|
    headers << [k,v] unless k == 'authorization'
  end
  headers = headers.sort_by(&:first)
  headers.map{|k,v| "#{k}:#{canonical_header_values(v)}" }.join("\n")
end
canonical_request() click to toggle source
# File lib/aws/core/signature/version_4.rb, line 74
def canonical_request
  parts = []
  parts << http_method
  parts << path
  parts << querystring
  parts << canonical_headers + "\n"
  parts << signed_headers
  parts << hex16(hash(body || ''))
  parts.join("\n")
end
credential_string(datetime) click to toggle source
# File lib/aws/core/signature/version_4.rb, line 65
def credential_string datetime
  parts = []
  parts << datetime[0,8]
  parts << region
  parts << service
  parts << 'aws4_request'
  parts.join("/")
end
hash(string) click to toggle source
# File lib/aws/core/signature/version_4.rb, line 114
def hash string
  Digest::SHA256.digest(string)
end
hex16(string) click to toggle source
# File lib/aws/core/signature/version_4.rb, line 110
def hex16 string
  string.unpack('H*').first
end
service() click to toggle source
# File lib/aws/core/signature/version_4.rb, line 85
def service
  # this method is implemented in the request class for each service
  raise NotImplementedError
end
signature(credentials, datetime) click to toggle source
# File lib/aws/core/signature/version_4.rb, line 47
def signature credentials, datetime
  k_secret = credentials.secret_access_key
  k_date = hmac("AWS4" + k_secret, datetime[0,8])
  k_region = hmac(k_date, region)
  k_service = hmac(k_region, service)
  k_credentials = hmac(k_service, 'aws4_request')
  hmac(k_credentials, string_to_sign(datetime))
end
signed_headers() click to toggle source
# File lib/aws/core/signature/version_4.rb, line 90
def signed_headers
  to_sign = headers.keys.map{|k| k.to_s.downcase }
  to_sign.delete('authorization')
  to_sign.sort.join(";")
end
string_to_sign(datetime) click to toggle source
# File lib/aws/core/signature/version_4.rb, line 56
def string_to_sign datetime
  parts = []
  parts << 'AWS4-HMAC-SHA256'
  parts << datetime
  parts << credential_string(datetime)
  parts << hex16(hash(canonical_request))
  parts.join("\n")
end