activerecord-tenanted v0.7.0 リリース: セキュリティ修正とRails依存バージョン更新

このリリースでは、ActiveStorage::Service::DiskService#path_for の挙動を upstream Rails 8.1.2.1 に合わせて修正することでパストラバーサル脆弱性を解消し、最低 Rails バージョン要件を >= 8.1.2.1 に引き上げました。また、GitHub Actions のワークフローを強化し、マトリクステストを追加するなど開発インフラも改善されています。

背景

セキュリティ上の懸念として、ActiveStorage::Service::DiskService#path_for がテナント情報を適切に除去せず、パス・トラバーサルが可能になるケースが報告されました。これに対処するため、gem が上書きしているメソッドを upstream の Rails 8.1.2.1 の実装に合わせる変更が必要となりました。

同時に、この修正を安全に取り込むには、対象となる Rails バージョンが最低でも 8.1.2.1 であることが前提となります。そのため、gem の 最低 Rails バージョン要件 を >= 8.1.2.1 に更新する決定が行われました。さらに、開発者体験の向上と継続的インテグレーションの堅牢化を目的に、GitHub Actions のワークフローがハードニングされ、Rails 8.1 と Rails edge へのマトリクステストが追加されました。

これらの変更は、テナント対応ストレージ機能の安全性を確保しつつ、将来的な Rails バージョンへの適応コストを低減させることを意図しています。

技術的な変更

コードベースの唯一の機能変更は、Gem のバージョン情報を示す定数 VERSION を 0.6.0 から 0.7.0 に更新した点です。この変更はリリースプロセス上必須であり、利用者が正しいバージョンを取得できるようにします。

module ActiveRecord
  module Tenanted
-    VERSION = "0.6.0"
+    VERSION = "0.7.0"
  end
end

併せて CHANGELOG.md が更新され、リリースノートとしてセキュリティ修正、依存バージョンの上げ、開発インフラの改善が明示されています。CHANGELOG の追加はドキュメント更新として扱われますが、リリース情報の可視化に重要な役割を果たします。

これらの変更は、既存の API や動作に直接的な影響を与えるものではなく、バージョン管理と情報共有の整合性を向上させるだけです。

設計判断

安全なストレージパス解決 を実現するために、gem が提供していた DiskService#path_for のオーバーライドを upstream の実装に合わせる方針が採択されました。この選択は、独自実装を維持するよりも Rails 本体の挙動に依存することで保守コストを削減し、将来のアップデートでの破壊的変更リスクを低減します。

最低 Rails バージョン要件の引き上げ は、セキュリティパッチ適用の前提条件として合理的です。Rails 8.1.2.1 以降であれば、修正済み DiskService#path_for が標準で利用できるため、gem 側で追加の回避策を保持する必要がなくなります。

CI のハードニングとマトリクステスト の導入は、複数バージョンの Rails に対する互換性検証を自動化し、リリース前に潜在的な破壊的変更を早期に検出する設計姿勢を示しています。これにより、将来的なバージョンアップ時の回帰リスクが抑制されます。

まとめ

v0.7.0 は、ActiveStorage のパストラバーサル脆弱性 修正と Rails バージョン要件 の更新という重要なセキュリティ改善を含むと同時に、リリース情報の透明性を高める CHANGELOG の整備、CI の堅牢化とテスト範囲の拡大という開発インフラの向上を伴います。これにより、利用者は安全かつ最新の Rails 環境でテナント機能を活用でき、今後のメンテナンスコストも削減されます。