Class: HTTPClient::BasicAuth
- Inherits:
-
Object
- Object
- HTTPClient::BasicAuth
- Includes:
- Util, Mutex_m
- Defined in:
- lib/httpclient/auth.rb
Overview
Authentication filter for handling BasicAuth negotiation. Used in WWWAuth and ProxyAuth.
Direct Known Subclasses
Instance Attribute Summary collapse
-
#scheme ⇒ Object
readonly
Authentication scheme.
Instance Method Summary collapse
-
#challenge(uri, param_str = nil) ⇒ Object
Challenge handler: remember URL for response.
-
#get(req) ⇒ Object
Response handler: returns credential.
-
#initialize ⇒ BasicAuth
constructor
Creates new BasicAuth filter.
-
#reset_challenge ⇒ Object
Resets challenge state.
-
#set(uri, user, passwd) ⇒ Object
Set authentication credential.
-
#set? ⇒ Boolean
have we marked this as set - ie that it’s valid to use in this context?.
Methods included from Util
#argument_to_hash, hash_find_value, #http?, #https?, #keyword_argument, try_require, uri_dirname, uri_part_of, urify
Constructor Details
#initialize ⇒ BasicAuth
Creates new BasicAuth filter.
221 222 223 224 225 226 227 |
# File 'lib/httpclient/auth.rb', line 221 def initialize super @cred = nil @auth = {} @challenge = {} @scheme = "Basic" end |
Instance Attribute Details
#scheme ⇒ Object (readonly)
Authentication scheme.
218 219 220 |
# File 'lib/httpclient/auth.rb', line 218 def scheme @scheme end |
Instance Method Details
#challenge(uri, param_str = nil) ⇒ Object
Challenge handler: remember URL for response.
273 274 275 276 277 278 |
# File 'lib/httpclient/auth.rb', line 273 def challenge(uri, param_str = nil) synchronize { @challenge[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
259 260 261 262 263 264 265 266 267 268 269 270 |
# File 'lib/httpclient/auth.rb', line 259 def get(req) target_uri = req.header.request_uri synchronize { return nil unless @challenge.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_challenge ⇒ Object
Resets challenge state. Do not send ‘*Authorization’ header until the server sends ‘*Authentication’ again.
231 232 233 234 235 |
# File 'lib/httpclient/auth.rb', line 231 def reset_challenge synchronize { @challenge.clear } end |
#set(uri, user, passwd) ⇒ Object
Set authentication credential. uri == nil for generic purpose (allow to use user/password for any URL).
239 240 241 242 243 244 245 246 247 248 |
# File 'lib/httpclient/auth.rb', line 239 def set(uri, user, passwd) synchronize do 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 end |
#set? ⇒ Boolean
have we marked this as set - ie that it’s valid to use in this context?
251 252 253 |
# File 'lib/httpclient/auth.rb', line 251 def set? @cred || @auth.any? end |