---
title: "Sorcery gemの使い方｜Rails 8.1で動くログイン実装と0.18.0の注意点"
url: "https://www.issoh.co.jp/tech/details/4205/"
published: 2024-11-14
updated: 2026-10-28
categories: ["Ruby on Rails"]
publisher: "株式会社一創"
---

# Sorcery gemの使い方｜Rails 8.1で動くログイン実装と0.18.0の注意点

Sorceryは、Ruby on Railsにログイン機能を組み込むための軽量な認証gemです（英単語のsorcery＝魔術や、ゲームブック『ソーサリー』の解説ではありません）。この記事では、最新の0.18.0をRails 8.1.4に入れて実際に動かしたコードで、ユーザー登録からログイン、ロック、OAuthまでを解説します。Qiitaなどの解説記事に多い`redirect_back_or_to`は、0.18.0では非推奨警告が出る書き方になっているので、その直し方も扱います。

## まとめ：Sorcery 0.18.0を使う前に押さえる要点

- 最新は**0.18.0（2025年12月6日公開・MIT）**。動作要件は**Ruby 3.2以上・Rails 7.1以上**で、mainブランチのCIはRails 7.1〜8.1とRuby 3.2〜4.0の組み合わせで回っています。
- 導入は「Gemfile追加 → `rails g sorcery:install` → `rails db:migrate`」。Userモデルと`authenticates_with_sorcery!`はジェネレータが作りますが、バリデーションと画面は自分で書きます。
- 元のページへ戻すリダイレクトは、`config.use_redirect_back_or_to_by_rails = true`を設定し、`redirect_to_before_login_path`で書きます。旧来の`redirect_back_or_to`は非推奨警告が出ます。
- 追加機能はsubmoduleで足します。パスワードリセットのトークンは**既定では有効期限がない**ため、`reset_password_expiration_period`を必ず設定します。
- OAuthは`authentications_class`の設定が必須です。設定しないと`NoMethodError`で止まります。`state`の生成と照合もSorceryはしないので、自分で書きます。
- 画面まで一式ほしいならDevise、DeviseやSorceryへの依存を避けたいならRails 8標準の認証ジェネレーター、自前の画面で認証の部品だけ借りたいならSorcery、という選び方になります。

## Sorcery・Devise・Rails 8標準認証の違い

Sorceryはログイン処理やパスワードのハッシュ化をメソッドとして提供し、ビューやコントローラは生成しません。[公式README](https://github.com/Sorcery/sorcery)は「公開メソッドは20個未満」「生成コードを持たない」ことを設計方針に掲げています。Railsで認証を組むときの比較相手は、Deviseと、Rails 8.0から入った標準の認証ジェネレーター（`rails g authentication`）です。

### 3つの選択肢の比較表

| 観点        | Sorcery 0.18.0    | Devise 5.0.4  | Rails 8標準ジェネレーター |
| --------- | ----------------- | ------------- | ---------------- |
| 形態        | gem（メソッド提供）       | gem（画面・ルート一式） | コード生成（bcryptを使用） |
| ビュー       | 自作                | 自動生成          | ログイン・リセット画面を生成   |
| ユーザー登録    | 自作                | あり            | なし（自作）           |
| パスワードリセット | submodule         | あり            | あり（リンク15分）       |
| アカウントロック  | submodule         | Lockable      | なし（試行は3分10回まで）   |
| OAuthログイン | submodule（20種の実装） | OmniAuth連携    | なし               |
| セッション保存   | Railsのsession     | Warden経由      | sessionsテーブル     |

Rails 8の標準ジェネレーターは、[Railsガイドのセキュリティの章](https://guides.rubyonrails.org/security.html)に「ユーザー登録のコードは生成されない」と明記されています。Rails 8.1.4で実行すると、`Session`モデル、`SessionsController`、`PasswordsController`と`email_address`・`password_digest`を持つusersテーブルのマイグレーションが作られました。DeviseはRails標準の上に別の規約を重ねるので、標準から外れた要件ではオーバーライド箇所を探す時間がかかります。Deviseの内部で使われている認証の仕組みは[Wardenのカスタム戦略の作り方](/tech/details/7166/)で解説しています。

### Sorceryを選ばないほうがよい場面

新規のRails 8アプリで、要件がメールとパスワードのログインとパスワードリセットだけなら、Sorceryを足す理由は薄く、標準ジェネレーターで足ります。依存gemが1つ減り、生成コードを読めば全体が見えるからです。管理画面を短期間で立ち上げる、メール確認・ロック・登録画面まで標準のまま揃えたい、という場合はDeviseのほうが書く量は少なくなります。Sorceryが向くのは、既存のSorcery採用アプリを保守する場合と、ロック・remember\_me・OAuthなど標準ジェネレーターに無い部品を、自前の画面のまま足したい場合です。

### メンテナンス状況と0.18.0の動作要件

Sorceryは2024年9月に、当時のメンテナが「Sorcery Unmaintained」とする[プルリクエスト#376](https://github.com/Sorcery/sorcery/pull/376)をマージし、一時は保守停止の状態でした。その後メンテナが交代し、[0.18.0のリリースノート](https://github.com/Sorcery/sorcery/releases/tag/v0.18.0)のとおり2025年12月6日に新版が出ています。0.18.0ではRuby 3.2未満とRails 7.1未満のサポートを打ち切り、`form_authenticity_token`メソッドを削除しました。[RubyGems.org](https://rubygems.org/gems/sorcery)上の依存はbcrypt（\~> 3.1）・oauth（>= 0.6）・oauth2（\~> 2.0）・railties（>= 7.1）です。0.18.0のあとはタグが付いておらず、mainブランチへの最終コミットは2026年6月です。採用時は、過去のリリース間隔だけで今後の更新頻度を見積もらず、未解決のIssueと保守体制も確認してください。

## Sorceryのインストールと初期設定

Ruby 4.0.6・Rails 8.1.4・sorcery 0.18.0の新規アプリで、登録・ログイン・ログアウト・ロック・remember\_me・パスワード変更を検証しています。OAuthは、Googleの認可画面へのリダイレクト、state照合、ユーザー作成処理までを確かめたもので、Googleとのトークン交換は含みません。まずGemfileに追記して`bundle install`します。

```
gem 'sorcery', '~> 0.18.0'
```

続けてインストールジェネレータとマイグレーションを実行します。ジェネレータの基本的な使い方は[Railsジェネレータ（rails generate）の使い方](/tech/details/2874/)で解説しています。

```
bin/rails g sorcery:install
bin/rails db:migrate
```

実行すると、`config/initializers/sorcery.rb`、`app/models/user.rb`、usersテーブルのマイグレーションが作られます。usersテーブルは`email`（NOT NULL・一意インデックス）、`crypted_password`、`salt`の3列です。Userモデルにはジェネレータが`authenticates_with_sorcery!`を差し込みますが、バリデーションは入りません。次のように自分で足します。

```
class User < ApplicationRecord
  authenticates_with_sorcery!

  validates :email, presence: true, uniqueness: true
  validates :password, length: { minimum: 8 }, if: -> { new_record? || changes[:crypted_password] }
  validates :password, confirmation: true, if: -> { new_record? || changes[:crypted_password] }
  validates :password_confirmation, presence: true, if: -> { new_record? || changes[:crypted_password] }
end
```

usersテーブルに`password`列はありません。`password`は仮想属性で、保存時にbcryptでハッシュ化されて`crypted_password`に入ります。パスワードのバリデーションを「新規作成時か、パスワード変更時」に限るのは、メールアドレスだけを更新するときにパスワード入力を求めないためです。実測でも、この条件付きにしておけば`update!(email: ...)`はパスワードなしで通りました。

## ユーザー登録とログイン・ログアウトの実装

Sorceryは画面を作らないので、ルーティング・コントローラ・フォームを用意します。ここでは「登録」「ログイン」「ログアウト」の3つを作ります。以下のコードに加えて、PagesControllerのhomeアクションと表示用ビュー、ユーザー登録用のnewビューを用意してください。

### ルーティングとアクセス制限

```
Rails.application.routes.draw do
  root "pages#home"
  resources :users, only: [:new, :create]
  get    "login",  to: "user_sessions#new"
  post   "login",  to: "user_sessions#create"
  delete "logout", to: "user_sessions#destroy"
end
```

全ページをログイン必須にし、未ログイン時の行き先を決めるのはApplicationControllerです。`not_authenticated`は、Sorceryの既定では`root_path`へリダイレクトするだけなので、ログイン画面へ送るように上書きします。

```
class ApplicationController < ActionController::Base
  before_action :require_login

  private

  def not_authenticated
    redirect_to login_path, alert: "ログインが必要です"
  end
end
```

### ユーザー登録（UsersController）

登録画面と登録処理はログイン前に開くので、`skip_before_action`で除外します。登録後に`auto_login`を呼ぶと、パスワードを再入力させずにログイン状態にできます。

```
class UsersController < ApplicationController
  skip_before_action :require_login, only: [:new, :create]

  def new
    @user = User.new
  end

  def create
    @user = User.new(user_params)
    if @user.save
      auto_login(@user)
      redirect_to root_path, notice: "登録しました"
    else
      render :new, status: :unprocessable_entity
    end
  end

  private

  def user_params
    params.require(:user).permit(:email, :password, :password_confirmation)
  end
end
```

`auto_login`は有効化状態を確認せず、セッションIDも作り直しません。後述のuser\_activationを入れる場合は、登録後に`auto_login`を呼ばず「確認メールを送りました」と案内してログイン画面へ戻します。登録直後にログインさせる構成でも、`auto_login`の前に`reset_session`を呼んでおくとセッション固定攻撃を防げます。フォームは`form_with model: @user`で、`email`・`password`・`password_confirmation`の3項目を送ります。7文字のパスワードで送ると422、8文字以上なら302で`root_path`へ遷移しました。

### ログイン・ログアウト（UserSessionsController）

`login`は認証に成功するとユーザーを、失敗すると`nil`を返します。第3引数は後述のremember\_me用です。

```
class UserSessionsController < ApplicationController
  skip_before_action :require_login, only: [:new, :create]

  def new
  end

  def create
    if login(params[:email], params[:password], params[:remember_me] == "1")
      redirect_to_before_login_path(root_path, notice: "ログインしました")
    else
      flash.now[:alert] = "メールアドレスかパスワードが違います"
      render :new, status: :unprocessable_entity
    end
  end

  def destroy
    logout
    redirect_to login_path, notice: "ログアウトしました", status: :see_other
  end
end
```

ログインフォームはモデルを持たないので`form_with url: login_path`で書きます。

```
<%= form_with url: login_path do |f| %>
  <%= f.label :email, "メールアドレス" %>
  <%= f.email_field :email %>
  <%= f.label :password, "パスワード" %>
  <%= f.password_field :password %>
  <%= f.check_box :remember_me %>
  <%= f.label :remember_me, "ログインしたままにする" %>
  <%= f.submit "ログイン" %>
<% end %>
```

失敗時に`status: :unprocessable_entity`（422）を返すのは、Turboがフォーム再描画を正しく扱うためです。ログアウトの`status: :see_other`（303）は、DELETEのあとのリダイレクト先をGETで開かせるためです。結合テストでは、未ログインで保護ページを開くと`/login`へ302、正しいパスワードで元の保護ページへ302、ログアウトで303を返しました。

## redirect\_back\_or\_toの非推奨警告と元のページへ戻す設定

Rails 7.0で、Rails本体にも`redirect_back_or_to`という同名のメソッドが入りました。Sorceryの`redirect_back_or_to`はこれを上書きしているため、0.18.0では呼ぶたびに次の非推奨警告が出ます（[lib/sorcery/controller.rb](https://github.com/Sorcery/sorcery/blob/v0.18.0/lib/sorcery/controller.rb)）。

```
DEPRECATION WARNING: `redirect_back_or_to` overrides the method of the same name defined in Rails 7.
To avoid overriding, set `config.use_redirect_back_or_to_by_rails = true` and use `redirect_to_before_login_path`.
In a future release, `config.use_redirect_back_or_to_by_rails = true` will become the default.
```

注意が要るのは、設定だけ変えて呼び出しを`redirect_back_or_to`のまま残した場合です。Rails版はリファラ（直前に開いていたページ）へ戻すので、ログインフォームから送信すると`/login`に戻ってしまいます。保護ページ`/secret`を開いてからログインする流れで3通りを試した結果は次のとおりです。

| 設定値       | 呼び出すメソッド                          | 遷移先     | 警告 |
| --------- | --------------------------------- | ------- | -- |
| false（既定） | redirect\_back\_or\_to            | /secret | あり |
| true      | redirect\_back\_or\_to            | /login  | なし |
| true      | redirect\_to\_before\_login\_path | /secret | なし |

正解は3行目です。初期化ファイルの`configure`ブロックに1行足し、コントローラの呼び出しを`redirect_to_before_login_path`に置き換えます。将来の版で既定値が`true`に変わると予告されているので、今のうちに置き換えておけば、更新時に2行目の状態に落ちる事故を防げます。

```
Rails.application.config.sorcery.configure do |config|
  config.use_redirect_back_or_to_by_rails = true
  # ...
end
```

## Sorceryの主要ヘルパーメソッドとnot\_authenticated

コントローラとビューで使うメソッドは多くありません。検索で単体で調べられることの多い`not_authenticated`は、`require_login`が未ログインを検知したときに呼ぶメソッドで、どのメソッドを呼ぶかは`config.not_authenticated_action`で変えられます。

| メソッド                                   | 動き                             |
| -------------------------------------- | ------------------------------ |
| login(email, password, remember)       | 成功でユーザー、失敗でnil                 |
| login!(email, password)                | 失敗でSorcery::InvalidCredentials |
| logout                                 | セッションを破棄                       |
| auto\_login(user)                      | パスワードなしでログイン                   |
| logged\_in? ／ current\_user            | ログイン判定 ／ ログイン中のユーザー            |
| require\_login                         | before\_action用。未ログインなら下へ      |
| not\_authenticated                     | 既定はroot\_pathへリダイレクト           |
| redirect\_to\_before\_login\_path(url) | 保存したURLかurlへ戻す                 |

`require_login`は、GETかつAjaxでもJSONでもないリクエストのときだけ、開こうとしたURLを`session[:return_to_url]`に保存します。POSTやJSON APIのリクエストでは戻り先URLが新たに保存されません。セッションに以前の戻り先URLも残っていなければ、ログイン後は`redirect_to_before_login_path`の引数のURLへ飛びます。公開ページを持つコントローラでは`skip_before_action :require_login, only: [:index, :show]`のように除外します。

## submoduleの追加手順と既定値

パスワードリセットやロックなどは、submoduleとして必要なものだけ有効にします。ジェネレータに`--only-submodules`を付けて実行すると、マイグレーションが作られ、初期化ファイルの`submodules`の配列にも追記されます。

```
bin/rails g sorcery:install remember_me brute_force_protection --only-submodules
bin/rails db:migrate
```

このあと`external`を追加で実行すると、配列は`[:remember_me, :brute_force_protection, :external]`になりました。ジェネレータを使えば宣言漏れは起きません。初期化ファイルを手で書き換える場合は、`submodules =`を2回書くと後の代入で前の指定が消えるので、1つの配列にまとめます。同じことがUserモデル側の設定を書く`config.user_config`ブロックにも当てはまります。Sorceryはこのブロックを1つしか保持しないため、生成された初期化ファイルにある`config.user_config do |user|`とは別にもう1つ書くと、後から書いた方で前のブロックが丸ごと置き換わります。以降のコード例の`user.`で始まる設定は、すべて既存の1つのブロックの中に書き足してください。各submoduleの既定値は、0.18.0のソースで次のとおりです。

| submodule                | 機能          | 主な既定値                      |
| ------------------------ | ----------- | -------------------------- |
| remember\_me             | ログイン状態の保持   | 7日                         |
| session\_timeout         | セッションの期限切れ  | 3600秒（ログイン時刻から）            |
| brute\_force\_protection | アカウントロック    | 50回失敗で3600秒                |
| reset\_password          | パスワード再設定    | トークン期限なし／再送間隔300秒          |
| user\_activation         | メール認証       | 有効化前はログイン不可                |
| magic\_login             | パスワードなしログイン | トークン900秒                   |
| http\_basic\_auth        | Basic認証     | –                          |
| activity\_logging        | 最終ログイン等の記録  | –                          |
| external                 | OAuthログイン   | authentications\_classは未設定 |

### remember\_meによるログイン状態の保持

remember\_meを有効にすると、usersテーブルに`remember_me_token`と`remember_me_token_expires_at`が加わります。`login`の第3引数に`true`を渡すと、署名付きCookie`remember_me_token`が発行されます。実測では、チェックなしではCookieが発行されず、チェックありでは有効期限が約60万5,000秒（7日）後に設定されました。期間は`user.remember_me_for`（秒）で変えます。

### パスワードリセットとトークンの有効期限

reset\_passwordで最も見落としやすいのは、`reset_password_expiration_period`の既定値が`nil`で、リセット用のトークンが期限切れにならない点です（[reset\_password.rbの既定値](https://github.com/Sorcery/sorcery/blob/v0.18.0/lib/sorcery/model/submodules/reset%5Fpassword.rb)）。メールが第三者に読まれた場合、そのリンクはパスワードが変更されるまで使えてしまいます。Rails 8標準ジェネレーターのリセットリンクが既定15分であることと比べても、明示的に期限を設定すべき値です。

```
Rails.application.config.sorcery.configure do |config|
  config.user_config do |user|
    user.reset_password_mailer = UserMailer
    user.reset_password_expiration_period = 15.minutes.to_i
  end
end
```

リセット依頼を受けたら`user.deliver_reset_password_instructions!`、リンク先では`User.load_from_reset_password_token(params[:token])`でユーザーを引き、`user.password_confirmation = params[:password_confirmation]`を代入してから`user.change_password(params[:password])`で更新します。前掲のUserモデルは確認用パスワードを必須にしているため、`change_password`だけを呼ぶと`false`が返り、「Password confirmation can’t be blank」で更新されません（実測）。UserMailerには既定のメソッド名`reset_password_email`を定義します。メイラーを指定せずにreset\_passwordを有効にすると、アプリの起動時点で`ArgumentError`（you must define a mailer）になります。

### アカウントロック（brute\_force\_protection）

ログインに続けて失敗するとアカウントを一時ロックします。既定は50回失敗で3600秒（1時間）のロックで（[brute\_force\_protection.rb](https://github.com/Sorcery/sorcery/blob/v0.18.0/lib/sorcery/model/submodules/brute%5Fforce%5Fprotection.rb)）、実測でも50回失敗した時点で`lock_expires_at`が1時間後になり、その後は正しいパスワードでもログインできませんでした。50回は総当たり対策としては緩いので、`user.consecutive_login_retries_amount_limit`と`user.login_lock_time_period`で回数と時間を詰めます。ロック解除メールを送るには`user.unlock_token_mailer`にメイラーを指定します。指定しなければメールは送られません。複数のアカウントに同じパスワードを試す攻撃は、アカウント単位のロックでは止まりません。Rails 7.2で入った`rate_limit`をログインのcreateアクションに付け、IPアドレス単位の回数制限と組み合わせます（Rails 8標準ジェネレーターの生成コードは`rate_limit to: 10, within: 3.minutes`）。

### user\_activationによるメール認証とアカウント有効化

user\_activationを入れると、登録直後のユーザーは`activation_state`が`pending`になり、既定（`prevent_non_active_users_to_login = true`）ではメールのリンクを踏むまでログインできません。`user.user_activation_mailer = UserMailer`を設定し、`activation_needed_email`と`activation_success_email`の2メソッドを定義します。リンク先では`User.load_from_activation_token(params[:id])`で引いて`activate!`を呼びます。こちらもトークンの期限（`activation_token_expiration_period`）は既定で`nil`です。

## OAuthによるGoogleログインの追加設定

externalのsubmoduleは、0.18.0のソースに20種類のプロバイダ実装を持ちます（Google・GitHub・LINE・Microsoft・Slack・Discord・Facebook・Auth0など）。まず連携情報を入れる`authentications`テーブルを作ります。

```
bin/rails g sorcery:install external --only-submodules
bin/rails g model Authentication --skip-migration
bin/rails db:migrate
```

モデルの関連付けと、初期化ファイルの設定です。`authentications_class`は既定で`nil`なので、これを書かないとコールバック時に`NoMethodError: undefined method 'sorcery_adapter' for nil`で止まります（Rails 8.1.4で実測）。`user_config`を新しく書き足すと既存のブロックを上書きしてしまうので、生成済みのブロックに1行足します。

```
class User < ApplicationRecord
  authenticates_with_sorcery!
  # 前掲のemail・passwordのバリデーションは残したまま、次の2行を追記します
  has_many :authentications, dependent: :destroy
  accepts_nested_attributes_for :authentications
end

class Authentication < ApplicationRecord
  belongs_to :user
end

Rails.application.config.sorcery.configure do |config|
  config.external_providers = [:google]
  config.google.key = ENV["GOOGLE_KEY"]
  config.google.secret = ENV["GOOGLE_SECRET"]
  config.google.callback_url = "http://localhost:3000/oauth/callback?provider=google"
  config.google.user_info_mapping = { email: "email" }

  config.user_config do |user|
    user.authentications_class = Authentication
  end
end
```

コントローラでは、`login_at`でプロバイダの認可画面へ送り、戻ってきたら`login_from`で既存の連携を探します。見つからなければ`create_from`でユーザーを作ります。Sorceryは`login_at`の第2引数で渡された`state`を認可URLに載せるだけで、生成もコールバック時の照合もしません。ログインCSRFを防ぐため、ランダムな値をセッションに保存して送り、戻ってきた`params[:state]`と照合してから処理します。

```
class OauthsController < ApplicationController
  skip_before_action :require_login

  def oauth
    session[:oauth_state] = SecureRandom.urlsafe_base64(32)
    login_at(params[:provider], state: session[:oauth_state])
  end

  def callback
    state = session.delete(:oauth_state)
    unless state.present? && ActiveSupport::SecurityUtils.secure_compare(state, params[:state].to_s)
      return head :forbidden
    end

    provider = params[:provider]
    if login_from(provider)
      redirect_to root_path, notice: "ログインしました"
    else
      user = create_from(provider)
      reset_session
      auto_login(user)
      redirect_to root_path, notice: "登録してログインしました"
    end
  rescue ActiveRecord::RecordNotUnique
    redirect_to login_path, alert: "このメールアドレスは登録済みです。ログイン後に連携してください"
  end
end
```

ルーティングは`get "oauth/:provider", to: "oauths#oauth"`と`get "oauth/callback", to: "oauths#callback"`の2本を、callbackを先に書きます。`create_from`はモデルのバリデーションを通さずに保存します（[external.rbのsave(validate: false)](https://github.com/Sorcery/sorcery/blob/v0.18.0/lib/sorcery/model/submodules/external.rb)）。パスワード必須のバリデーションは掛かりませんが、DB側のemail一意制約は効くので、同じメールアドレスでパスワード登録済みのユーザーがいると`ActiveRecord::RecordNotUnique`になります。既存ユーザーに連携を足すときは、ログイン後に`add_provider_to_user`を使います。

キーとシークレットは環境変数で渡し、コールバックURLはプロバイダの管理画面に登録した値と完全に一致させます。X（旧Twitter）のプロバイダもありますが、X APIは利用プランごとに使える機能と料金が決まっているため、採用前に開発者ポータルでログインに必要な権限が使えるかを確認してください。業務システムの社内IDと連携するSSOや多要素認証まで含めて設計する場合は、[認証基盤・ID管理システム開発](/service/system/identity/)のように認証基盤側で組む方法もあります。トークン方式との違いは[JWTとセッション・OAuthの違い](/tech/details/13453/)を参照してください。

## つまずきやすいエラーと原因

| 症状                             | 主な原因                            |
| ------------------------------ | ------------------------------- |
| bundle installで解決できない          | Ruby 3.2未満またはRails 7.1未満        |
| DEPRECATION WARNINGが出る         | redirect\_back\_or\_toを呼んでいる    |
| ログイン後に/loginへ戻る                | 設定trueのままredirect\_back\_or\_to |
| 未ログインでrootへ飛ぶ                  | not\_authenticatedを上書きしていない     |
| メール更新でパスワードエラー                 | バリデーションに条件がない                   |
| 正しいパスワードで入れない                  | ロック中またはactivation未完了            |
| OAuthでsorcery\_adapter for nil | authentications\_class未設定       |
| user.の設定が効かない                  | user\_configブロックを2つ書いている        |
| OAuthでRecordNotUnique          | 同じemailの既存ユーザー                  |

原因が分からないときは、`bin/rails console`で`User.last.crypted_password`が`$2a$`で始まるbcryptのハッシュになっているか、`failed_logins_count`や`lock_expires_at`に値が残っていないかを見ると切り分けが早くなります。セッションの保存先や失効の考え方は[セッション管理とは？](/tech/details/16366/)で扱っています。

## よくある質問

### Sorceryとは何のgemですか？

Ruby on Railsにログイン・ログアウト・パスワードのハッシュ化などの認証機能を組み込む軽量なgemです。画面やコントローラは生成せず、開発者が自分で書きます。英単語のsorcery（魔術）やゲームブックとは関係ありません。

### Sorceryの最新バージョンと対応Rails・Rubyは？

最新は2025年12月6日公開の0.18.0です。Ruby 3.2以上・Rails 7.1以上が必要で、Rails 8.0・8.1でも動きます。この記事のコードはRails 8.1.4とRuby 4.0.6で確認しました。

### SorceryとDeviseはどちらを選ぶべきですか？

登録・ロック・メール確認まで画面ごと揃えたいならDevise、画面は自作して認証の部品だけ借りたいならSorceryです。要件がログインとパスワードリセットだけの新規Rails 8アプリなら、DeviseやSorceryを追加せず、bcryptを使う標準の認証ジェネレーターで対応できます。

### not\_authenticatedメソッドは何をしますか？

`require_login`が未ログインを検知したときに呼ばれるメソッドで、既定では`root_path`へリダイレクトします。ApplicationControllerで上書きし、ログイン画面へ誘導するのが一般的です。

### redirect\_back\_or\_toで警告が出るのはなぜですか？

Rails 7.0で同名のメソッドがRails本体に入り、Sorceryの`redirect_back_or_to`がそれを上書きしているためです。`config.use_redirect_back_or_to_by_rails = true`を設定し、呼び出しを`redirect_to_before_login_path`に置き換えると警告が消え、ログイン前に開いたページへ戻る動きも保てます。

## 関連記事

- [Wardenのカスタム戦略の作り方：valid?・authenticate!とDevise連携・JWT認証](/tech/details/7166/)
- [セッション管理とは？セッションIDの発行から失効までの実装と保存先選定を解説](/tech/details/16366/)
- [JWTとは？構造・署名検証の仕組みとセッション・OAuth/OIDCとの違いを実装視点で解説](/tech/details/13453/)
- [Rails APIとは？作成手順・JWT認証・React連携・Docker環境を実装解説【Rails 8.1】](/tech/details/2905/)
- [Railsジェネレータ（rails generate）の使い方｜生成ファイル一覧と取り消し・カスタム生成【Rails 8.1.4】](/tech/details/2874/)

---

出典: [Sorcery gemの使い方｜Rails 8.1で動くログイン実装と0.18.0の注意点](<https://www.issoh.co.jp/tech/details/4205/>)（株式会社一創）
