Class: OAuth::RequestProxy::Base

Inherits:
Object
  • Object
show all
Includes:
Helper
Defined in:
lib/oauth/request_proxy/base.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Helper

#_escape, #escape, #generate_key, #generate_timestamp, #normalize, #normalize_nested_query, #parse_header, #stringify_keys, #unescape

Constructor Details

#initialize(request, options = {}) ⇒ Base

Returns a new instance of Base.



14
15
16
17
18
# File 'lib/oauth/request_proxy/base.rb', line 14

def initialize(request, options = {})
  @request = request
  @unsigned_parameters = (options[:unsigned_parameters] || []).map {|param| param.to_s}
  @options = options
end

Instance Attribute Details

#optionsObject

Returns the value of attribute options.



12
13
14
# File 'lib/oauth/request_proxy/base.rb', line 12

def options
  @options
end

#requestObject

Returns the value of attribute request.



12
13
14
# File 'lib/oauth/request_proxy/base.rb', line 12

def request
  @request
end

#unsigned_parametersObject

Returns the value of attribute unsigned_parameters.



12
13
14
# File 'lib/oauth/request_proxy/base.rb', line 12

def unsigned_parameters
  @unsigned_parameters
end

Class Method Details

.proxies(klass) ⇒ Object



8
9
10
# File 'lib/oauth/request_proxy/base.rb', line 8

def self.proxies(klass)
  OAuth::RequestProxy.available_proxies[klass] = self
end

Instance Method Details

#non_oauth_parametersObject



86
87
88
# File 'lib/oauth/request_proxy/base.rb', line 86

def non_oauth_parameters
  parameters.reject { |k,v| OAuth::PARAMETERS.include?(k) }
end

#normalized_parametersObject

See 9.1.1. in specs Normalize Request Parameters



101
102
103
# File 'lib/oauth/request_proxy/base.rb', line 101

def normalized_parameters
  normalize(parameters_for_signature)
end

#normalized_uriObject

See 9.1.2 in specs



95
96
97
98
# File 'lib/oauth/request_proxy/base.rb', line 95

def normalized_uri
  u = URI.parse(uri)
  "#{u.scheme.downcase}://#{u.host.downcase}#{(u.scheme.downcase == 'http' && u.port != 80) || (u.scheme.downcase == 'https' && u.port != 443) ? ":#{u.port}" : ""}#{(u.path && u.path != '') ? u.path : '/'}"
end

#oauth_callbackObject

OAuth parameters



22
23
24
# File 'lib/oauth/request_proxy/base.rb', line 22

def oauth_callback
  parameters['oauth_callback']
end

#oauth_consumer_keyObject Also known as: consumer_key



26
27
28
# File 'lib/oauth/request_proxy/base.rb', line 26

def oauth_consumer_key
  parameters['oauth_consumer_key']
end

#oauth_header(options = {}) ⇒ Object

Authorization header for OAuth



142
143
144
145
146
147
# File 'lib/oauth/request_proxy/base.rb', line 142

def oauth_header(options = {})
  header_params_str = oauth_parameters.map { |k,v| "#{k}=\"#{escape(v)}\"" }.join(', ')

  realm = "realm=\"#{options[:realm]}\", " if options[:realm]
  "OAuth #{realm}#{header_params_str}"
end

#oauth_nonceObject Also known as: nonce



30
31
32
# File 'lib/oauth/request_proxy/base.rb', line 30

def oauth_nonce
  parameters['oauth_nonce']
end

#oauth_parametersObject



82
83
84
# File 'lib/oauth/request_proxy/base.rb', line 82

def oauth_parameters
  parameters.select { |k,v| OAuth::PARAMETERS.include?(k) }.reject { |k,v| v == "" }
end

#oauth_signatureObject Also known as: signature



34
35
36
37
# File 'lib/oauth/request_proxy/base.rb', line 34

def oauth_signature
  # TODO can this be nil?
  [parameters['oauth_signature']].flatten.first || ""
end

#oauth_signature_methodObject Also known as: signature_method



39
40
41
42
43
44
45
46
# File 'lib/oauth/request_proxy/base.rb', line 39

def oauth_signature_method
  case parameters['oauth_signature_method']
  when Array
    parameters['oauth_signature_method'].first
  else
    parameters['oauth_signature_method']
  end
end

#oauth_timestampObject Also known as: timestamp



48
49
50
# File 'lib/oauth/request_proxy/base.rb', line 48

def oauth_timestamp
  parameters['oauth_timestamp']
end

#oauth_tokenObject Also known as: token



52
53
54
# File 'lib/oauth/request_proxy/base.rb', line 52

def oauth_token
  parameters['oauth_token']
end

#oauth_verifierObject



56
57
58
# File 'lib/oauth/request_proxy/base.rb', line 56

def oauth_verifier
  parameters['oauth_verifier']
end

#oauth_versionObject



60
61
62
# File 'lib/oauth/request_proxy/base.rb', line 60

def oauth_version
  parameters["oauth_version"]
end

#parametersObject

Parameter accessors

Raises:

  • (NotImplementedError)


74
75
76
# File 'lib/oauth/request_proxy/base.rb', line 74

def parameters
  raise NotImplementedError, "Must be implemented by subclasses"
end

#parameters_for_signatureObject



78
79
80
# File 'lib/oauth/request_proxy/base.rb', line 78

def parameters_for_signature
  parameters.select { |k,v| not signature_and_unsigned_parameters.include?(k) }
end

#query_string_blank?Boolean

Returns:

  • (Boolean)


149
150
151
152
153
154
155
# File 'lib/oauth/request_proxy/base.rb', line 149

def query_string_blank?
  if uri = request.env['REQUEST_URI']
    uri.split('?', 2)[1].nil?
  else
    request.query_string.match(/\A\s*\z/)
  end
end

#sign(options = {}) ⇒ Object



105
106
107
# File 'lib/oauth/request_proxy/base.rb', line 105

def sign(options = {})
  OAuth::Signature.sign(self, options)
end

#sign!(options = {}) ⇒ Object



109
110
111
112
113
# File 'lib/oauth/request_proxy/base.rb', line 109

def sign!(options = {})
  parameters["oauth_signature"] = sign(options)
  @signed = true
  signature
end

#signature_and_unsigned_parametersObject



90
91
92
# File 'lib/oauth/request_proxy/base.rb', line 90

def signature_and_unsigned_parameters
  unsigned_parameters+["oauth_signature"]
end

#signature_base_stringObject

See 9.1 in specs



116
117
118
119
# File 'lib/oauth/request_proxy/base.rb', line 116

def signature_base_string
  base = [method, normalized_uri, normalized_parameters]
  base.map { |v| escape(v) }.join("&")
end

#signed?Boolean

Has this request been signed yet?

Returns:

  • (Boolean)


122
123
124
# File 'lib/oauth/request_proxy/base.rb', line 122

def signed?
  @signed
end

#signed_uri(with_oauth = true) ⇒ Object

URI, including OAuth parameters



127
128
129
130
131
132
133
134
135
136
137
138
139
# File 'lib/oauth/request_proxy/base.rb', line 127

def signed_uri(with_oauth = true)
  if signed?
    if with_oauth
      params = parameters
    else
      params = non_oauth_parameters
    end

    [uri, normalize(params)] * "?"
  else
    STDERR.puts "This request has not yet been signed!"
  end
end