установка

Для Ruby есть типо инструкция на офсайте, но я опишу немного по своему.
Как обычно добавляем в Gemfile:

gem 'ayah_integration'

и бандлим:

bundle install

Теперь надо зарегистрироваться на сайте для получения ключей.

интеграция в модель плагина Devise

Предполагается, что уже есть сгенерированная и настроенная модель Devise. У меня модель называется User, а внедрять капчу я буду в форму восстановления пароля.

интеграция в представление

Если вы особо не мучали Devise генерирований различных представлений, то по умолчанию форма восстановления пароля лежит тут: app/views/devise/passwords/new.html.erb. Ее надо открыть и привести к виду:

1
2
3
4
5
6
7
8
9
10
11
12

...
<%ayah=AYAH::Integration.new(<publisher_key>,<scoring_key>)%>
...
<%= form_for(resource,
  :as => resource_name,
  :url => password_path(resource_name),
  :html => { :method => :post }) do |f| %>
...
<%=ayah.get_publisher_html.html_safe%>
...
<%end%>
...

У AYAH есть 2 вида капчи:

• Lightbox – выводиться в модальном окне после нажатия кнопки ‘отправить’ (как в комментариях в этом блоге)
• Embedded – сразу видна в форме

Так вот в зависимости от того, какой вид отображения AYAH вы выбрали в настройках, капча в форме восстановления пароля будет либо видна после события submit, либо сразу.

интеграция в контроллер

Чтобы соорудить свою обработку события ‘восстановление пароля’ в Devise нужно сделать свой контроллер.
В директории app/controllers нужно сделать файл passwords_controller.rb:

1
2
3
4
5
6
7
8
9
10
11
12
13
14

class PasswordsController < Devise::PasswordsController
  def create
    session_secret = params['session_secret']
    ayah = AYAH::Integration.new(<publisher_key>,<scoring_key>)
    ayah_passed = ayah.score_result(session_secret, request.remote_ip)
    if ayah_passed
      super
    else
      respond_to do |format|
        format.html { redirect_to new_user_password_path, notice: 'Invalid CAPTCHA' }
      end
    end
  end
end

Я тут не слишком заморачивался и вывел ошибку капчи в notice, хотя по нормальному ее, конечно, надо было бы добавить к ошибкам модели devise.

добавление контроллера в routes.rb

Последним шагом надо обозначить в config/routes.rb, что для passwords имеется специальный контроллер:

1
2
3

...
devise_for :users, :controllers => { :passwords => "passwords" }
...

Надо не забывать, что после изменения routes.rb надо перезапустить WEBrick.

Итого

Многие говорят, что такую капчу роботу легче взломать, чем обычную, т.к. тут ограниченный набор картинок. Это мнение во многом справедливо, однако, современная невзламываемая капча количеством и сложностью своих манипуляций с текстом стремительно мчиться к маразму, экстенсивное развитие уже не приносит ожидаемого результата. Чем сложнее будут эффекты преобразований, тем меньше будет преймущество человека перед роботом в разгадывании этих иероглифов.
Капчи подобные AYAH имеют временнУю фору – пока они станут настолько популярными, чтобы ими заинтересовались хакеры, они уже достаточно смогут пополнить базу своих картинок, игр и т.д., а быть может и эволюционировать до алгоритмов автоматической генерации игр/картинок, я имею ввиду генерации сколько угодно большого количества разных, например, ламп или бутербродов (различия не по цвету, а по форме и содержанию).
Разработчик AYAH обещал в скором времени добавить многоязычность интерфейса, так что скоро возможно существенное расширение поля применения.

1. введение в devise
2. настройка devise

Все нижепроделанное относиться к RoR версии выше 3.0.1.

установка

Сначала, как обычно, дописываем в Gemfile:

gem 'devise'

и далее опять же:

bundle install

Теперь надо сгенерировать/интегрировать/спарить/инсталировать/и т.д. rails-приложение и devise:

rails generate devise:install

После этого devise напишет мол надо настроить mailer и домашнюю страницу (root_url). Для режима development настроить mailer можно прописав в config/environments/development.rb опцию:

config.action_mailer.default_url_options ={ :host => 'localhost:3000' }

Далее надо сгенерировать модель пользователей для Devise и выполнить созданные миграции:

rails generate devise User
rake db:migrate

настройка и эксплуатация

маршрутизация

После установки devise пропишет свои особые маршруты. Строка в config/routes.rb вида:

devise_for :users

мало о чем скажет, поэтому посмотреть маршруты devise можно так:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

rake routes
        new_user_session GET    /users/sign_in(.:format)
            user_session POST   /users/sign_in(.:format)
    destroy_user_session DELETE /users/sign_out(.:format)
           user_password POST   /users/password(.:format)
       new_user_password GET    /users/password/new(.:format)
      edit_user_password GET    /users/password/edit(.:format)
                         PUT    /users/password(.:format)
cancel_user_registration GET    /users/cancel(.:format)
       user_registration POST   /users(.:format)
   new_user_registration GET    /users/sign_up(.:format)
  edit_user_registration GET    /users/edit(.:format)
                         PUT    /users(.:format)
                         DELETE /users(.:format)
...

Соответственно в представлении, например, ссылка на регистрацию будет выглядеть как:

1

<%=link_to 'Регистрация', new_user_registration_path %>

а на вход:

1

<%=link_to 'Войти', new_user_session_path%>

Стандартные пути можно изменить подкорректировав config/routes.rb, используя опцию path_names, например, для изменения пути регистрации изменения будут выглядеть так:

1

devise_for :users, :path_names=>{sign_up: 'register'}

методы

Также в первом видео еще рассказали метод, как узнать авторизован ли пользователь:

user_signed_in?

и, видимо, экземпляр класса модели User для текущего пользователя current_user, которая работает также как и экземпляр любой другой модели, например, узнать E-mail текущего авторизованного пользователя можно так:

current_user.email

фильтр

Еще один важный момент в начале второго видео про before_filter. Чтобы узнать недопустить неавторизованного посетителя до экшенов, нужно использовать фильтр:

before_filter :authenticate_user!

Он будет перенаправлять на страницу входа.

настройка представлений

Для того, чтобы иметь возможность редактировать представления devise их нужно привести к обычному виду файлов представлений:

rails g devise:views
      create  app/views/devise/_links.erb
      invoke  form_for
      create    app/views/devise/confirmations
      create    app/views/devise/confirmations/new.html.erb
      create    app/views/devise/passwords
      create    app/views/devise/passwords/edit.html.erb
      create    app/views/devise/passwords/new.html.erb
      create    app/views/devise/registrations
      create    app/views/devise/registrations/edit.html.erb
      create    app/views/devise/registrations/new.html.erb
      create    app/views/devise/sessions
      create    app/views/devise/sessions/new.html.erb
      create    app/views/devise/unlocks
      create    app/views/devise/unlocks/new.html.erb
      invoke  erb
      create    app/views/devise/mailer
      create    app/views/devise/mailer/confirmation_instructions.html.erb
      create    app/views/devise/mailer/reset_password_instructions.html.erb
      create    app/views/devise/mailer/unlock_instructions.html.erb

сообщения об ошибках

Все сообщения devise храняться в YML-файлах локалей, по умолчанию это config/locales/devise.en.yml. Для добавления своей локали нужно создать файл с аналогичным именем, например, config/locales/devise.ru.yml.
Скачать переведенные на другие языки (в т.ч. русский) локали devise можно тут: https://github.com/plataformatec/devise/wiki/I18n

валидация и прочие настройки

Настройки валидации, как и все остальные для этого гема, находятся в config/initializers/devise.rb. Отключить стандартную валидацию devise можно убрав модуль :validatable из модели, в данном случае User.
А вообще в devise вагон других настроек, например, теже ключи аутентификации, а которых говорят в конце второго видео, настраиваются все в том же config/initializers/devise.rb.
Подробнее о настройках и прочих заморочках этого гема:

1. офстраница
2. вики
3. rubydoc