oa-vkontakte
Расширение для OmniAuth, реализующее аутентификацию через Vkontate Open Api.
Установка
gem install oa-vkontakte
Добавить в config/initializers/omniauth.rb:
Rails.application.config.middleware.use OmniAuth::Builder do
provider :vkontakte, <ID приложения>, <Защищенный ключ приложения>
end
Если ещё не определен, добавить путь в config/routes.rb:
match '/auth/:provider/callback' => 'authentications#create'
В нужную вьюху добавить хелпер, рисующий кнопку входа:
<%= vkontakte_login_button %>
Также кнопка доступна по адресу /auth/vkontakte, но форма там передается GET-запросом. Можно пропробовать встроить её как iframe.
После клика на кнопку и разрешения добавления приложения, будет совершен POST-запрос на /auth/vkontakte/callback. В action, к которому будет привязан этот путь, будет доступна переменная
request["omniauth.auth"]
Содержание этой переменной примерно следующее:
{
'uid' => '1234567890', # ID пользователя vkontakte.ru
'provider' => 'vkontakte',
'user_info' => {
'name' => 'Nick Recobra',
'nickname' => 'oruen',
'first_name' => 'Nick',
'last_name' => 'Recobra',
'image' => 'http://cs191.vkontakte.ru/u00001/e_375bc433.jpg', # путь до вконтактовского аватара
'urls' => { 'Page' => 'http://vkontakte.ru/id1234567890' }
}
}
Интеграция с Devise
Devise с версии 1.2.rc интегрирован с OmniAuth. Подключить к нему oa-vkontakte
достаточно просто, дописав в config/initializers/devise.rb
:
config.omniauth :vkontakte, <ID приложения>, <Защищенный ключ приложения>
Callback будет приходить действию Devise::OmniauthCallbacks#vkontakte, так что придется озаботиться его наличием. Это удобно сделать, поменяв контроллер для callback’ов OmniAuth в routes.rb
:
devise_for :users, :controllers => { :omniauth_callbacks => "authentications" }
AuthenticationsController в этом случае выглядит как-то так:
class AuthenticationsController < Devise::OmniauthCallbacksController
def vkontakte
omniauth = request.env["omniauth.auth"]
# создание или аутентификация пользователя
...
end
end
Ссылки
OmniAuth: github.com/intridea/omniauth
Интеграция OmniAuth и Devise: railscasts.com/episodes/235-omniauth-part-1 и railscasts.com/episodes/236-omniauth-part-2
Note on Patches/Pull Requests
-
Fork the project.
-
Make your feature addition or bug fix.
-
Add tests for it. This is important so I don’t break it in a future version unintentionally.
-
Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
-
Send me a pull request. Bonus points for topic branches.
Copyright
Copyright © 2010 Nick Recobra. See LICENSE for details.