らくだ🐫にもできるRailsチュートリアル｜11.1
11章でやること
アカウントを有効化するためのメール認証システムを作る！
- ユーザーの初期状態は「有効化されていない」(unactivated) にしておく。
- ユーザー登録が行われたときに、有効化トークンと、それに対応する有効化ダイジェストを生成する。
- 有効化ダイジェストはデータベースに保存しておき、有効化トークンはメールアドレスと一緒に、ユーザーに送信する有効化用メールのリンクに仕込んでおく
- ユーザーがメールのリンクをクリックしたら、アプリケーションはメールアドレスをキーにしてユーザーを探し、データベース内に保存しておいた有効化ダイジェストと比較することでトークンを認証する。
- ユーザーを認証できたら、ユーザーのステータスを「有効化されていない」から「有効化済み」(activated) に変更する。
うむわからん！
こうやって書くとよくわからないけど、
パスワードや記憶トークンの仕組みと似た点が多いとの事なので、記事を見直しつつゆっくり理解しながら進めていきましょうそうしましょう。
11.1 AccountActivationsリソース
セッション機能 (8.1) を使って、アカウントの有効化という作業を「リソース」としてモデル化することにします。アカウントの有効化リソースはActive Recordのモデルとはこの際関係ないので、両者を関連付けることはしません。その代わりに、この作業に必要なデータ (有効化トークンや有効化ステータスなど) をUserモデルに追加することにします。
また、アカウント有効化もリソースの使い方に今までとは異なる点があるので注意！
有効化用のリンクにアクセスして有効化のステータスを変更する部分では、RESTのルールに従うとPATCHリクエストとupdateアクションになるべきです (表 7.1)。しかし、有効化リンクはメールでユーザーに送られることを思い出してください。ユーザーがこのリンクをクリックすれば、それはブラウザで普通にクリックしたときと同じであり、その場合ブラウザから発行されるのは (updateアクションで使うPATCHリクエストではなく) GETリクエストになってしまいます。このため、ユーザーからのGETリクエストを受けるために、(本来であればupdateのところを) editアクションに変更して使っていきます。
やっぱり文章で説明されてもよくわからないので進めながら理解できるように頑張りたい（希望）
|
1 2 |
#branchを切って作業開始！ git checkout -b account-activation |
11.1.1 AccountActivationsコントローラ
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
# AccountActivationsコントローラを生成 $ rails generate controller AccountActivations Running via Spring preloader in process 5709 create app/controllers/account_activations_controller.rb invoke erb create app/views/account_activations invoke test_unit create test/controllers/account_activations_controller_test.rb invoke helper create app/helpers/account_activations_helper.rb invoke test_unit invoke assets invoke coffee create app/assets/javascripts/account_activations.coffee invoke scss create app/assets/stylesheets/account_activations.scss |
有効化のメールに必要な名前付きルート
詳しくは11.2.1との事だけど
有効化のメールに含まれるURLにeditアクションへの名前付きルートが必要になる
|
1 |
edit_account_activation_url(activation_token, ...) |
なので名前付きルートを使えるように設定する
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
Rails.application.routes.draw do root 'static_pages#home' get '/help', to:'static_pages#help' get '/about', to:'static_pages#about' get '/contact', to:'static_pages#contact' get '/signup', to:'users#new' post '/signup', to: 'users#create' get '/login', to: 'sessions#new' post '/login', to: 'sessions#create' delete '/logout', to: 'sessions#destroy' resources :users # account_activations resourceのeditへのルーティングのみを生成 resources :account_activations, only: [:edit] end |
これにより
/account_activation/<token>/editにgetのリクエストが送られるとaccount_activationsコントローラーのeditアクションが実行されるようになる
名前付きルートのedit_account_activation_url(token)も使えるようになる
演習
- 現時点でテストスイートを実行すると greenになることを確認してみましょう。
- 表 11.2の名前付きルートでは、_pathではなく_urlを使うように記してあります。なぜでしょうか? 考えてみましょう。ヒント: 私達はこれからメールで名前付きルートを使います。
- green
- メール本文のURLからアクセスするから
（因みに_pathは相対パスを返し_urlは絶対パスを返すヤツ）
11.1.2 AccountActivationのデータモデル
アカウント有効化メールには一意の有効化トークンが必要
パスワードの実装 (第6章) や記憶トークンの実装 (第9章) と同じように仮想的な属性を使ってハッシュ化した文字列をデータベースに保存するようにします。
具体的にはこんな感じになる
|
1 2 3 4 5 6 7 8 |
#仮想属性の有効化トークンにアクセスしたり user.activation_token #ユーザーを承認できるようにしたり user.authenticated?(:activation, token) #ユーザーが有効かどうかのテストをしたり if user.activated? ... |
あと、本文では使わないけどユーザーを有効にしたときの日時も念のために記録できるようにしておく
- activation_digest:string
- activated:boolean
- activated_at:datetime
この3つの属性をUserモデルに追加する
|
1 2 |
$ rails generate migration add_activation_to_users \ > activation_digest:string activated:boolean activated_at:datetime |
|
1 2 3 4 5 6 7 8 |
class AddActivationToUsers < ActiveRecord::Migration[5.1] def change add_column :users, :activation_digest, :string # activated属性のデフォルトの論理値をfalseに指定 add_column :users, :activated, :boolean, default: false add_column :users, :activated_at, :datetime end end |
|
1 2 |
#マイグレーションの実行 $ rails db:migrate |
Activationトークンのコールバック
ユーザーが新しい登録を完了するためには必ずアカウントの有効化が必要になるのですから、有効化トークンや有効化ダイジェストはユーザーオブジェクトが作成される前に作成しておく必要があります。
メースアドレスを保存する前に全て小文字に変換するように指定した際は
before_saveコールバックにdowncaseメソッドを関連付けてオブジェクトの保存の直前に実行されるようにしたけど
今回は保存直前ではなくオブジェクトが作成された時にのみコールバックを呼び出したい！
よってこう↓
|
1 |
before_create :create_activation_digest |
createの直前にcreate_activation_digestメソッドを呼び出している
→create_activation_digestメソッドは外部から見えないようにprivateキーワードを指定して隠ぺい！
rememberメソッドとの違い
コールバックに関連付けるメソッドは記憶トークンや記憶ダイジェストのために作ったメソッドを使いまわしてるけどもちろん違いもある！
|
1 2 3 4 5 6 7 8 9 10 11 |
# 永続セッションのためにユーザーをデータベースに記憶する def remember self.remember_token = User.new_token update_attribute(:remember_digest, User.digest(remember_token)) end # 有効化トークンとダイジェストを作成および代入する def create_activation_digest self.activation_token = User.new_token self.activation_digest = User.digest(activation_token) end |
記憶トークンやダイジェストは既にデータベースにいるユーザーのために作成されるのでupdate_attributeを使って情報を更新・保存しているが
before_createコールバックの方はユーザーが作成される前に呼び出されることなので更新される属性がない→新しく取得
以上をもとにUserモデルにアカウント有効化のコードを追加
また以下も併せて
- せっかくなので（？）メールアドレスを小文字にするメソッドもメソッド参照に切り替える
- 有効化トークンは本質的に仮のものでなければならないのでactivation_token属性をattr_accessorに追加
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
class User < ApplicationRecord #仮想の属性:remember_token、activation_tokenをUserクラスに定義 attr_accessor :remember_token, :activation_token #保存の直前に参照するメソッド before_save :downcase_email # データ作成の直前に参照するメソッド before_create :create_activation_digest ・ ・ ・ private # メールアドレスをすべて小文字にする def downcase_email self.email = email.downcase end # 有効化トークンとダイジェストを作成および代入する def create_activation_digest self.activation_token = User.new_token self.activation_digest = User.digest(activation_token) end end |
サンプルユーザーの生成とテスト
先に進む前に、サンプルデータとfixtureも更新してスムーズにテストできるように準備をしておく！
なお、Time.zone.nowはRailsの組み込みヘルパーであり、サーバーのタイムゾーンに応じたタイムスタンプを返します。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 |
# テーブル名.create! 作るデータ→対応するカラムと値 User.create!(name: "Example User", email: "example@railstutorial.org", password: "foobar", password_confirmation: "foobar", # 管理者 admin: true, #ユーザーが有効化されている activated: true, activated_at: Time.zone.now) # 99回繰り返す（timesメソッド） 99.times do |n| # nameに代入 Faker::Name.name name = Faker::Name.name # emailに代入 example-#{n+1}@railstutorial.org ←それぞれのアドレスが変わるような指定 email = "example-#{n+1}@railstutorial.org" password = "password" User.create!(name: name, email: email, password: password, password_confirmation: password, #ユーザーが有効化されている activated: true, activated_at: Time.zone.now) end |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 |
michael: name: Michael Example email: michael@example.com password_digest: <%= User.digest('password') %> admin: true activated: true activated_at: <%= Time.zone.now %> archer: name: Sterling Archer email: duchess@example.gov password_digest: <%= User.digest('password') %> activated: true activated_at: <%= Time.zone.now %> lana: name: Lana Kane email: hands@example.gov password_digest: <%= User.digest('password') %> activated: true activated_at: <%= Time.zone.now %> malory: name: Malory Archer email: boss@example.gov password_digest: <%= User.digest('password') %> activated: true activated_at: <%= Time.zone.now %> #コードを埋め込んでtimesメソッドで30件分のユーザーデータを作成 <% 30.times do |n| %> user_<%= n %>: name: <%= "User #{n}" %> email: <%= "user-#{n}@example.com" %> password_digest: <%= User.digest('password') %> activated: true activated_at: <%= Time.zone.now %> <% end %> |
データベースのリセットとサンプルデータを再度生成
|
1 2 |
$ rails db:migrate:reset $ rails db:seed |
演習
- 本項での変更を加えた後、テストスイートが green のままになっていることを確認してみましょう。
- コンソールからUserクラスのインスタンスを生成し、そのオブジェクトからcreate_activation_digestメソッドを呼び出そうとすると (Privateメソッドなので) NoMethodErrorが発生することを確認してみましょう。また、そのUserオブジェクトからダイジェストの値も確認してみましょう。
- リスト 6.34で、メールアドレスの小文字化にはemail.downcase!という (代入せずに済む) メソッドがあることを知りました。このメソッドを使って、リスト 11.3のdowncase_emailメソッドを改良してみてください。また、うまく変更できれば、テストスイートは成功したままになっていることも確認してみてください。
1.
green
2.
|
1 2 3 4 5 6 7 8 9 10 |
>> u = User.new => #<User id: nil, name: nil, email: nil, created_at: nil, updated_at: nil, password_digest: nil, remember_digest: nil, admin: false, activation_digest: nil, activated: false, activated_at: nil> >> u.create_activation_digest Traceback (most recent call last): 1: from (irb):2 #private methodだから呼べないよってなってる NoMethodError (private method `create_activation_digest' called for #<User:0x0000000002f9e730>) Did you mean? restore_activation_digest! >> u.activation_digest => nil |
3.
|
1 2 3 4 5 6 7 8 9 10 |
・ ・ ・ # メールアドレスをすべて小文字にする def downcase_email self.email.downcase! end ・ ・ ・ |
テストはgreen
まとめとか感想
アカウント有効化メール実装の準備
次からが本番ですね！
らくだ🐫にもできるRailsチュートリアルとは
「ド」が付く素人のらくだ🐫が勉強するRailsチュートリアルの学習記録です。
自分用に記録していますが、お役に立つことがあれば幸いです。
調べたとはいえらくだ🐫なりの解釈や説明が含まれます。間違っている部分もあるかと思います。そんな所は教えて頂けますと幸いなのですが、このブログにはコメント機能がありません💧お手数おかけしますがTwitterなどでご連絡いただければ幸いです