модуль 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 442
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 514
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 501
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 473
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 485
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 478
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 460
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 будет иметь префикс "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 468 def token_params_from(auth) rewrite_param_values params_array_from raw_params auth end
© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.