← All posts

パスワードリセットなしでユーザーを移行する

Authagonal·June 21, 2026
migrationpasswordsbcrypt

ID 移行ガイドはどれも、最後には同じ段落にたどり着きます。そして、それはいつも少し申し訳なさそうです。「ユーザーはパスワードをリセットする必要があります」。まるで自然法則のように扱われています。そうではありません。それは選択であり、たいていはより難しい方法をやりたがらなかったツールに強いられた選択です。

より難しい方法とは、ユーザーの 既存の パスワードハッシュをその場で検証することです。そうすれば、ユーザーは移行後も以前とまったく同じ認証情報でサインインでき、何かが起きたことに気づきもしません。これができるかどうかは、1 つの問いに帰着します。古いハッシュを入手できるか、そして新しいシステムはそれを検証できるか、です。

パスワードハッシュは思われているより持ち運びやすい

パスワードハッシュは秘密のアルゴリズムではありません。bcrypt は bcrypt です。bcrypt のハッシュは文字列の中にコストファクターとソルトを含んでいるので、bcrypt を実装しているものなら、ほかのどの bcrypt システムが生成したハッシュでも検証できます。ASP.NET Identity が使う PBKDF2 形式も同じで、仕様が公開されていて、バージョン管理されていて、自己記述的です。手元にあるものが何かわかっていれば、パスワードを一切知らなくても、パスワードをそれと照合できます。

つまり、ログインを維持したまま移行するのに平文は必要なく(誰も持っていません)、最初に全員分をハッシュし直す必要もありません。必要なのは、保存されているハッシュを入手し、サインイン時にそれと照合し、ユーザーが初めてログインしたときに各ハッシュを新システム自身の形式へ静かにアップグレードすることです。この最後の部分が遅延移行(レイジーマイグレーション)です。古いハッシュを持ち込み、一度検証し、透過的に置き換える。通常のログインが数週間続くうちにユーザーテーブルは自らハッシュし直され、旧形式は自然に消えていきます。リセットはゼロ、サポートチケットもゼロです。

2 つの経路

厄介なのは、移行元によって渡される形式が異なることで、優れたインポーターは両方を検証します:

  • セルフホストの Duende / ASP.NET Identity から: V3 の PBKDF2 ハッシュ(および旧来の bcrypt があればそれも)はそのまま検証でき、初回サインイン時に再ハッシュされます。移行先がすでに使っているのと同じ方式なので、これは簡単なケースです。これほどすんなりいくことに、ほとんどのチームが驚きます。
  • Auth0 から: bcrypt ハッシュはそのまま検証できます。問題は形式ではなく、それを 入手する ことです。

本当にできないとき

Auth0 の Management API はパスワードハッシュを決して返しません。これは意図的なポリシーであって、誰かのツールの欠陥ではありません。それを使わずにパスワードも含められると謳う「ワンクリックで Auth0 をエクスポート」の類いは疑ってかかるべきです。公式にサポートされている経路は、サポート経由での一括エクスポートです。各ユーザーの bcrypt ハッシュを含む NDJSON ファイルです。そのファイルを入手できれば、ハッシュはそのままインポートされ、遅延移行も含めてすべて機能し、移行は誰にも気づかれません。

それを待てないなら、代替手段は、あの申し訳なさそうな段落の誠実なバージョンです。ユーザーは初回サインイン時に新しいパスワードを設定します。失われたものは何もありません。引き継ぐハッシュがそもそもなかったのですから。違いは、ツールがそれ以上のことをできなかったからではなく、あなたが承知のうえでそれを選んだという点です。

これが見た目以上に重要な理由

強制リセットは、移行の最中にユーザー全体に対してできることの中で、最も目立ち、最も不安をあおるものです。サポートの負荷を生み、フィッシングそっくりの「リセットするにはここをクリック」というメールを予期するようユーザーを慣らしてしまい、静かなインフラ変更が全員の問題に変わる瞬間になります。それを避けることが、移行を「何も起きなかった」と感じさせるための大部分であり、移行とは本来そう感じられるべきものです。

ですから、「全員がリセットする」を受け入れる前に、2 つの問いを投げかけてください。ほとんどの移行では両方の答えがイエスであり、あの申し訳なさそうな段落は最初から必要なかったのです。

インポートで何が引き継がれるかを確認する。プレビューは読み取り専用で、何かが書き込まれる前にすべてを確認できます。