セルフホストの Duende を離れる:何が移行でき、何を運用しなくてよくなるのか
Duende IdentityServer は本当に優れたソフトウェアです。アイデンティティ層を端から端まで自分で所有したいなら、.NET における標準です。しかし「所有する」ことこそがコストのすべてです。ホスティングも、パッチ適用も、スケーリングも自分で行い、その周りにあるもの、つまり管理 UI、MFA、監査ログ、ブランディング、ステータスページ、ユーザーとロールの管理もすべて自分で作ることになります。どこかの時点で、チームは IdP を運用するのはもうやめたいと判断します。そのとき重要な問いはただ 1 つ、移行がどれほど大変か、です。ここでは、実際に何が移行できるのかを紹介します。
実際に運用しているもの
Duende をセルフホストすると、責任を負うのはトークンエンドポイントだけではありません。
- IdP そのもの:ホスティング、スケーリング、パッチ適用、そしてライセンス(SAML はその上に乗る有料アドオンです)。
- その周りに自分で作ったものすべて:管理ポータル、MFA の登録、監査ログ、カスタムブランディング、ステータスページ、ユーザーとロールの管理。
本当に時間を取られるのは、たいてい 2 つ目のリストのほうです。
移行できるもの:その大半は機械的な作業
Duende は設定を SQL(ConfigurationDb)に、ユーザーを ASP.NET Identity に保持しています。移行ではその両方を読み込みます。
- クライアント → OAuth クライアント。リダイレクト URI とログアウト URI、CORS オリジン、グラントタイプ、リフレッシュトークンの使用方法と有効期限のセマンティクス、デバイスコードの有効期間を含みます。無効化されたクライアントは無効化された状態でインポートされ、期限切れのシークレットは警告を出してスキップされます。
- スコープ → ApiScopes と IdentityResources はそのまま対応づけられます。Duende の
ApiResourceという中間層(オーディエンスと共有クレームのリストの組み合わせ)は、よりシンプルなモデルへと平坦化されます。リソース名は、そのメンバーであるスコープを使うすべてのクライアントのオーディエンスになり、そのクレームはそれらのスコープへ統合されます。 - ユーザー → ここは朗報です。ASP.NET Identity V3 のパスワードハッシュ(およびレガシーな bcrypt)はそのままネイティブに検証でき、初回サインイン時に再ハッシュされます。パスワードのリセットも、サポートチケットもなく、ユーザーが気づくことは何もありません。(これは Auth0 から離れるときには本当に難しい部分ですが、Duende ならそのまま動きます。アプリがすでに使っているのと同じハッシュ方式だからです。)
- ロールとその割り当て、外部ログイン、OIDC アイデンティティプロバイダーも、すべて移行されます。SAML プロバイダーには、移行先で再設定が必要であることを示すフラグが付きます。
アイデンティティの安定性について
どの IdP の移行でもそうですが、正しく押さえるべきなのは、ユーザーの sub や client_id を変えないことです。下流のリフレッシュトークン、顧客の IdP にある SCIM の行、そして自社のデータベースに保存されたユーザー ID が、すべてそれらを参照しているからです。インポーターは両方を保持します。また、ポータルのオーナーのひとりが別の ID で Duende ユーザーとしても存在している場合、インポーターは段階的で復旧可能な手順を通じてその 2 つを統合します(Duende の sub へとローテーションします)。サインインできない、移行が中途半端なオーナーを残すことはありません。
余談:移行のテストについて(.NET の落とし穴)
私たちはインポーターを、モックではなく、データを投入した本物の Duende データベースに対してテストしています。それは報われました。ASP.NET Identity は AspNetUsers.LockoutEnd を datetimeoffset として保存しており、それを reader.GetDateTime() で読むと、その型に対して InvalidCastException がスローされます。つまり、ロックアウトされたユーザーがひとりいるだけで、ユーザーのインポート全体が失敗していたはずなのです。これは、ロックアウトされたユーザーを含む本物のデータに対してインポーターを実行してみなければ見つかりません。何らかの移行ツールを検討しているなら、尋ねる価値があるのはこの質問です。データの入ったデータベースに対してテストされているのか、それとも移行元の API に対してモックしているだけなのか。
やめられること
移行の目的は、移行そのものではありません。その後のすべてです。SAML、SCIM、MFA、監査ログ、カスタムドメイン、ブランディングは、自分で作って運用するものではなく、最初から含まれているものになります。IdP のパッチ適用やスケーリングも、もうあなたの問題ではなくなります。Duende のセルフホストが「完全なコントロールが欲しい」という意図的な判断であり、今もそうであるなら、そのままでいてください。それは十分に妥当な選択です。これは、IdP の運用がもはや時間を使いたい場所ではなくなったときのための話です。
検討しているなら
移行の大半は機械的な作業で、パスワードはリセットなしで引き継がれ、プレビューは読み取り専用です。Duende のデータベースを指定すれば、何かが書き込まれる前に、何がインポートされるのかを正確に見せてくれます。