Module: ActionController::HttpAuthentication::Token::ControllerMethods

Defined in:
lib/action_controller/metal/http_authentication.rb

Instance Method Summary collapse

Instance Method Details

#authenticate_or_request_with_http_token(realm = "Application", message = nil, &login_procedure) ⇒ Object

Authenticate using an HTTP Bearer token, or otherwise render an HTTP header requesting the client to send a Bearer token. For the authentication to be considered successful, login_procedure should return a non-nil value. Typically, the authenticated user is returned.

See ActionController::HttpAuthentication::Token for example usage.



432
433
434
# File 'lib/action_controller/metal/http_authentication.rb', line 432

def authenticate_or_request_with_http_token(realm = "Application", message = nil, &)
  authenticate_with_http_token(&) || request_http_token_authentication(realm, message)
end

#authenticate_with_http_token(&login_procedure) ⇒ Object

Authenticate using an HTTP Bearer token. Returns the return value of login_procedure if a token is found. Returns nil if no token is found.

See ActionController::HttpAuthentication::Token for example usage.



441
442
443
# File 'lib/action_controller/metal/http_authentication.rb', line 441

def authenticate_with_http_token(&)
  Token.authenticate(self, &)
end

#request_http_token_authentication(realm = "Application", message = nil) ⇒ Object

Render an HTTP header requesting the client to send a Bearer token for authentication.



447
448
449
# File 'lib/action_controller/metal/http_authentication.rb', line 447

def request_http_token_authentication(realm = "Application", message = nil)
  Token.authentication_request(self, realm, message)
end