Class: HTTPClient::BasicAuth

Inherits:
Object
  • Object
show all
Includes:
Util
Defined in:
lib/httpclient/auth.rb

Overview

Authentication filter for handling BasicAuth negotiation. Used in WWWAuth and ProxyAuth.

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Util

#force_binary, hash_find_value, #https?, #keyword_argument, uri_dirname, uri_part_of, #urify

Constructor Details

#initializeBasicAuth

Creates new BasicAuth filter.



220
221
222
223
224
225
# File 'lib/httpclient/auth.rb', line 220

def initialize
  @cred = nil
  @auth = {}
  @challengeable = {}
  @scheme = "Basic"
end

Instance Attribute Details

#schemeObject (readonly)

Authentication scheme.



217
218
219
# File 'lib/httpclient/auth.rb', line 217

def scheme
  @scheme
end

Instance Method Details

#challenge(uri, param_str = nil) ⇒ Object

Challenge handler: remember URL for response.



260
261
262
263
# File 'lib/httpclient/auth.rb', line 260

def challenge(uri, param_str = nil)
  @challengeable[urify(uri)] = true
  true
end

#get(req) ⇒ Object

Response handler: returns credential. It sends cred only when a given uri is;

  • child page of challengeable(got *Authenticate before) uri and,

  • child page of defined credential



248
249
250
251
252
253
254
255
256
257
# File 'lib/httpclient/auth.rb', line 248

def get(req)
  target_uri = req.header.request_uri
  return nil unless @challengeable.find { |uri, ok|
    Util.uri_part_of(target_uri, uri) and ok
  }
  return @cred if @cred
  Util.hash_find_value(@auth) { |uri, cred|
    Util.uri_part_of(target_uri, uri)
  }
end

#reset_challengeObject

Resets challenge state. Do not send ‘*Authorization’ header until the server sends ‘*Authentication’ again.



229
230
231
# File 'lib/httpclient/auth.rb', line 229

def reset_challenge
  @challengeable.clear
end

#set(uri, user, passwd) ⇒ Object

Set authentication credential. uri == nil for generic purpose (allow to use user/password for any URL).



235
236
237
238
239
240
241
242
# File 'lib/httpclient/auth.rb', line 235

def set(uri, user, passwd)
  if uri.nil?
    @cred = ["#{user}:#{passwd}"].pack('m').tr("\n", '')
  else
    uri = Util.uri_dirname(uri)
    @auth[uri] = ["#{user}:#{passwd}"].pack('m').tr("\n", '')
  end
end