機能概要
- SMTPサーバー
- Gmail or Sendgridを使用
- 「devise」
- 新規会員登録・退会
- ログイン・ログアウト
- パスワードリセット
- ユーザー情報編集
- バリデーション
- 日本語化
- その他
- ログインしていないときにログイン画面にリダイレクト
前提
- 筆者はRailsインストール完了画面から検証しました。
- インストールの手順は、私の記事ですが下記を参照。
手順
SMTPサーバーを構築
ホスト名、ユーザー名、パスワード、ポート番号をメモに控えましょう。
SMTPサーバーは下記のサービスを使ってみると良いと思います。
- 【無料】Gmail(gmailアドレスを使うことになります。)
- 【無料】Sendgrid(任意のドメイン使用可。こちらのリンクから登録がおすすめ。日本語サイトからだと審査等で使えるようになるまで時間がかかるようです)
「devise」等設定手順
「devise」をGemfileに追加
gem 'devise'
「devise」インストールコマンド
$ bundle install
$ rails g devise:install
デフォルトURLの設定&SMTPサーバー情報設定。環境変数を使用。
config.action_mailer.default_url_options = { host: ENV['WEB_HOST'], protocol: ENV['WEB_PROTOCOL']}
config.action_mailer.raise_delivery_errors = true
config.action_mailer.delivery_method = :smtp
config.action_mailer.smtp_settings = {
:address => ENV['SMTP_ADDRESS'],
:domain => ENV['SMTP_DOMAIN'],
:port => ENV['SMTP_PORT'],
:user_name => ENV['SMTP_USER_NAME'],
:password => ENV['SMTP_PASSWD'],
:authentication => 'login',
:enable_starttls_auto => true
}
「devise」で送信されるメールアドレスの設定(下記一行をコメントアウト。使用メールアドレスを追記)
# config.mailer_sender = 'please-change-me-at-config-initializers-devise@example.com'
config.mailer_sender = ENV['SMTP_USER_NAME']
「devise」で送信されるメールのBCCに管理者メールを追加
$ rails g mailer MyMailer sendmail_confirm
Devise.setup do |config|
...
config.mailer = 'MyMailer'
...
end
class MyMailer < Devise::Mailer
def reset_password_instructions(record, token, opts={})
super(record, token, opts.merge(default_opts))
end
def reset_password_instructions(record, token, opts={})
super(record, token, opts.merge(default_opts))
end
def unlock_instructions(record, token, opts={})
super(record, token, opts.merge(default_opts))
end
def default_opts
{
bcc: Settings.mail[:bcc]
}
end
end
ルートURLの設定(アクション名、コントローラーは任意に設定しましょう。)
$ rails g controller Home top
「root to: 'home#top'」を追記
# ・・・
root to: 'home#top'
# ・・・
ログインしていないときにログイン画面にリダイレクトをかける
before_action :authenticate_user!
フラッシュメッセージ&ログアウトリンク設置(表示させたい箇所に配置)
<% if notice %>
<p><%= notice %></p>
<% end %>
<% if alert %>
<p><%= alert %></p>
<% end %>
<% if user_signed_in? %>
<p><%= link_to "ログアウト", destroy_user_session_path, method: :delete %></p>
<% end %>
「devise」のviewを生成
$ rails g devise:views
上記コマンドを実行すると、「app/views」ディレクトリにdeviseディレクトリが生成されます。
「devise」のオプション機能(モジュール)の追加します。
今回は「user」を「devise」に使用するモデルにします。
下記コマンドを実行すると、「config/routes.rb」に「devise_for :users」が追記されます。
$ rails g devise user
ex)
$ rails g devise member
$ rails g devise admin
コメントアウトを外すと、使用したいオプション機能(モジュール)が使えるようになります。
今回は「メール認証」のモジュールを使用したいので、「Confirmable」の部分をコメントアウト。
## Confirmable
# t.string :confirmation_token
# t.datetime :confirmed_at
# t.datetime :confirmation_sent_at
# t.string :unconfirmed_email # Only if using reconfirmable
# ▼ ▼ ▼ 下記のようにコメントアウト
## Confirmable
t.string :confirmation_token
t.datetime :confirmed_at
t.datetime :confirmation_sent_at
t.string :unconfirmed_email # Only if using reconfirmable
DBに反映
$ rails db:migrate
「:confirmable」を追加し、使用するモジュールの指定します。
devise :database_authenticatable, :registerable,
:recoverable, :rememberable, :validatable, :confirmable
「devise」の日本語化
...
module Src
class Application < Rails::Application
# Initialize configuration defaults for originally generated Rails version.
config.load_defaults 5.2
config.i18n.default_locale = :ja#追加
# Settings in config/environments/* take precedence over those specified here.
# Application configuration can go into files in config/initializers
# -- all .rb files in that directory are automatically loaded after loading
# the framework and any gems in your application.
end
end
gem 'devise-i18n'
gem 'devise-i18n-views'
$ bundle install
$ rails g devise:views:locale ja
再起動後、日本語化されていました。
メール本文の変更は、「app/views/devise/mailer/」ディレクトリの下記ファイルから変更が可能です。
- 新規会員登録確認メール(confirmation_instructions.html.erb)
- メールアドレス変更確認メール(email_changed.html.erb)
- パスワード変更確認メール(password_change.html.erb)
- パスワードリセット確認メール(reset_password_instructions.html.erb)
- アカウント凍結確認メール(unlock_instructions.html.erb)
後続作業
【Rails】【Devise】twitter・Facebookログイン実装
メール認証に加えてソーシャルログイン機能を実装する手順です。
参考
【plataformatec/devise: Flexible authentication solution for Rails with Warden.】
https://github.com/plataformatec/devise
公式。手順も掲載されています。
【deviseの使い方を徹底解説!】
https://www.pikawaka.com/rails/devise
手順がとても参考になりました。
【Rails DEVISE ユーザー登録時に管理者側にもメールが送信されるようにする。 - Qiita】
https://qiita.com/dawn_628/items/f1e4da88cd337b50fb7f
送信メールのBCCにメールアドレスを追加するのに参考になりました。
【Deviseで送信されるメールにbccを設定する方法 - ITアドベンチャー】
http://shimotori.github.io/blog-it/2013/05/11/1-set-bcc-to-devise-mail/
送信メールのBCCにメールアドレスを追加するのに参考になりました。
【【Rails5】Devise-i18nで日本語化する | RemoNote】
https://remonote.jp/rails-devise-i18n-locale-ja
deviseの日本語化の参考になりました。
【[Rails][devise]認証メールのテンプレートをカスタマイズしたい | よりこログ】
http://yrfreelance.com/2019/01/13/rails-devise-mail-template/
送信メール本文の変更で参考になりました。