модуль ActionController::HttpAuthentication::Token
Обеспечивает простую реализацию HTTP Token аутентификации.
Простой Token пример:
class PostsController < ApplicationController
TOKEN = "secret"
before_action :authenticate, except: [ :index ]
def index
render plain: "Everyone can see me!"
end
def edit
render plain: "I'm only accessible if you know the password"
end
private
def authenticate
authenticate_or_request_with_http_token do |token, options|
# Compare the tokens in a time-constant manner, to mitigate
# timing attacks.
ActiveSupport::SecurityUtils.secure_compare(token, TOKEN)
end
end
end
Вот более сложный Token пример, где только Atom-каналы и XML API защищены HTTP-токенной аутентификацией, а обычный HTML-интерфейс защищён методом сессий:
class ApplicationController < ActionController::Base
before_action :set_account, :authenticate
private
def set_account
@account = Account.find_by(url_name: request.subdomains.first)
end
def authenticate
case request.format
when Mime[:xml], Mime[:atom]
if user = authenticate_with_http_token { |t, o| @account.users.authenticate(t, o) }
@current_user = user
else
request_http_token_authentication
end
else
if session_authenticated?
@current_user = @account.users.find(session[:authenticated][:user_id])
else
redirect_to(login_url) and return false
end
end
end
end
В интеграционных тестах вы можете сделать что-то подобное:
def test_access_granted_from_xml
authorization = ActionController::HttpAuthentication::Token.encode_credentials(users(:dhh).token)
get "/notes/1.xml", headers: { 'HTTP_AUTHORIZATION' => authorization }
assert_equal 200, status
end
На совместных хостингах Apache иногда не передает заголовки аутентификации в экземпляры FCGI. Если ваша среда соответствует этому описанию и вы не можете выполнить аутентификацию, попробуйте добавить эту строку в конфигурацию Apache:
RewriteRule ^(.*)$ dispatch.fcgi [E=X-HTTP_AUTHORIZATION:%{HTTP:Authorization},QSA,L] Константы
- AUTHN_PAIR_DELIMITERS
- TOKEN_KEY
- TOKEN_REGEX
Открытые методы экземпляров
# File actionpack/lib/action_controller/metal/http_authentication.rb, line 441
def authenticate(controller, &login_procedure)
token, options = token_and_options(controller.request)
unless token.blank?
login_procedure.call(token, options)
end
end Если заголовок Authorization содержит токен, вызывает процедуру входа в систему с текущим токеном и опциями.
- controller
-
ActionController::Baseэкземпляр для текущего запроса. - login_procedure
-
Процедура, которая вызывается, если токен присутствует. Процедура должна принимать два аргумента:
authenticate(controller) { |token, options| ... }
Возвращает результат вызова login_procedure , если токен найден. Возвращает nil , если токен не найден.
# File actionpack/lib/action_controller/metal/http_authentication.rb, line 513
def authentication_request(controller, realm, message = nil)
message ||= "HTTP Token: Access denied.\n"
controller.headers["WWW-Authenticate"] = %(Token realm="#{realm.tr('"', "")}")
controller.__send__ :render, plain: message, status: :unauthorized
end Устанавливает заголовок WWW-Authenticate, чтобы клиент знал, что требуется токен.
controller - экземпляр ActionController::Base для исходящего ответа. realm - String область, используемая в заголовке.
Возвращает ничего.
# File actionpack/lib/action_controller/metal/http_authentication.rb, line 500
def encode_credentials(token, options = {})
values = ["#{TOKEN_KEY}#{token.to_s.inspect}"] + options.map do |key, value|
"#{key}=#{value.to_s.inspect}"
end
"Token #{values * ", "}"
end Кодирует данный токен и опции в значение заголовка Authorization.
token - String токен. options - необязательный Hash с опциями.
Возвращает String.
# File actionpack/lib/action_controller/metal/http_authentication.rb, line 472
def params_array_from(raw_params)
raw_params.map { |param| param.split %r/=(.+)?/ }
end Преобразует raw_params в массив параметров
# File actionpack/lib/action_controller/metal/http_authentication.rb, line 484
def raw_params(auth)
_raw_params = auth.sub(TOKEN_REGEX, "").split(/\s*#{AUTHN_PAIR_DELIMITERS}\s*/)
if !_raw_params.first.start_with?(TOKEN_KEY)
_raw_params[0] = "#{TOKEN_KEY}#{_raw_params.first}"
end
_raw_params
end Этот метод принимает тело авторизации и разделяет пары ключ-значение по стандартным разделителям :, ;, или \t, определённым в AUTHN_PAIR_DELIMITERS.
# File actionpack/lib/action_controller/metal/http_authentication.rb, line 477
def rewrite_param_values(array_params)
array_params.each { |param| (param[1] || +"").gsub! %r/^"|"$/, "" }
end Удаляет символы " , которые окружают значение.
# File actionpack/lib/action_controller/metal/http_authentication.rb, line 459
def token_and_options(request)
authorization_request = request.authorization.to_s
if authorization_request[TOKEN_REGEX]
params = token_params_from authorization_request
[params.shift[1], Hash[params].with_indifferent_access]
end
end Парсит токен и опции из заголовка Authorization. Ожидается, что значение заголовка Authorization будет иметь префикс "Token" или "Bearer". Если заголовок выглядит так:
Authorization: Token token="abc", nonce="def"
Тогда возвращаемый токен — "abc", а опции — {nonce: "def"}
request - экземпляр ActionDispatch::Request с текущими заголовками.
Возвращает пару Array [String, Hash] , если токен присутствует. Возвращает nil , если токен не найден.
# File actionpack/lib/action_controller/metal/http_authentication.rb, line 467 def token_params_from(auth) rewrite_param_values params_array_from raw_params auth end
© 2004–2020 David Heinemeier Hansson
Licensed under the MIT License.