action_ip_filter gemをリリースしました

こんにちは。スマートバンクでソフトウェアエンジニアをしております @moznion です。
表題の通り、action_ip_filterというgemを公開いたしましたのでそのご報告です。

これは何 / モチベーション

Ruby on RailsのController内の個別のactionに対し、アクセス元IPアドレスによるアクセス制限を課すことができるgemです。

例えば以下のように使うことができます:

class AdminController < ApplicationController
  include ActionIpFilter::IpFilterable

  filter_ip "192.0.2.0/24", "198.51.100.1", only: [:index, :show]

  def index
    # `192.0.2.0/24` あるいは `198.51.100.1` からのアクセスのみ許可する
  end

  def show
    # #indexと同様の制限が適用される
  end

  def public_action
    # 制限無し
  end
end

ActionIpFilter::IpFilterable を include すると filter_ip というメソッドが生えてくるので、そこに「許可するIPアドレス(複数指定可能)」を指定すると所望の制限を適用することが可能です (そのほかにもオプションが存在するのでREADMEを参照ください)。

こうした、「エンドポイントに対するIPアドレス制限」を実現する際に真っ先に選択肢に挙がるのは rack-attack であると思うのですが、rack-attackはrack middlewareであるという特性上すべてのリクエストに対してアクセス制限のロジックを適用します。
そのため「全体のうち一部のエンドポイントにだけ制限を適用したい」というようなユースケースでは、本来処理する必要の無い大半のエンドポイントへのアクセスであっても余計な制御ロジックが実行されてしまうためオーバーヘッドが気になるということがありました *1。
そうした背景からaction_ip_filterではrack middlewareではなくRailsのconcernとして実装するというアプローチを採用しました。こうすることにより、実際にアクセス制限を課したいエンドポイントへのアクセスが発生した時にだけ制限ロジックが実行されるようになるため、より効率的に処理することが可能となります。

また、コントローラー内に宣言的な形でIPアドレス制限を記述できるのでわかりやすいという利点もあるかと思っています。テストも書きやすいですしね *2。

このユースケースってRails公式のRate Limit機能でぎりぎり上手く賄えそうな雰囲気もあるけど、IP block/filter用途だとRailsのは微妙だった？
— r7kamura (@r7kamura) 2025年11月28日

id:r7kamuraさんから上記のようなおたよりも頂いていました。ありがとうございます。
その後追記したREADME *3 にも記載したのですが、確かに rate_limit で実現可能な機能ではある一方で rate_limit はあくまでrate limittingを行うパーツであるということや、背後にキャッシュストアを要求するという理由から今回は独立した意図を持ったgemとして作成したという次第でした。

内部実装が実はrate_limitでしたとかだとお洒落かもしれない（お洒落なだけではある）
Railsがrack-attackにあるような機能をより積極的に取り込んでいきたいと考えているなら、こういうIP単位でのblocking機能ってユースケース多くありそうだし、rate_limitとは別に公式に専用機能あってほしいね
— r7kamura (@r7kamura) 2025年11月28日