Auth0 から離れる:実際に移せるもの、そして Auth0 が渡してくれない唯一のもの
Auth0 を離れるチームの多くは、Auth0 が嫌いだから離れるわけではありません。請求額が跳ね上がったから、あるいは SAML と SCIM が接続単位課金のエンタープライズプランの向こう側にあり、新しい顧客の SSO 接続が増えるたびにメーターが回ることがわかったから離れるのです。そこで実際にアイデンティティプロバイダーを移行することを検討し、恐ろしそうだと判断して、もう 1 年とどまります。
見た目ほど恐ろしいものではありません。実際の Auth0 移行に何が伴うのかを紹介します。退屈な部分、手間のかかる部分、そして本当に難しい 1 つの部分です。ご自身で判断できるように。
Auth0 テナントに入っているもの
いくつかのものを、新しい場所に移す必要があります。
- Applications → OAuth/OIDC クライアント。コールバック、ログアウト URL、許可するオリジン、グラントタイプ、そしてクライアントシークレット。機械的な作業です。
- APIs(リソースサーバー)+ スコープ → オーディエンスとスコープ。それらを使うクライアントに紐付けます(Auth0 はこれを「client grants」として管理しています)。
- Roles とその割り当て → ロールと、ユーザーごとのロールの紐付け。
- Connections → エンタープライズ(OIDC/SAML)、ソーシャル、データベースの各接続。エンタープライズ OIDC はフェデレーションプロバイダーにきれいに対応し、それ以外は設定し直します。
- Users → プロファイル、メタデータ、そしてリンクされたソーシャル/エンタープライズのアイデンティティ。
どれも原理的には難しくありません。不安の原因は、具体的な 3 つの点にあります。
人を不安にさせる 3 つのこと
1. アイデンティティを安定させておくこと。 ユーザーは sub によって(アプリは client_id によって)あちこちから参照されています。下流のアプリが保持しているリフレッシュトークン、顧客の IdP にある SCIM の行、自社のデータベースに保存されたユーザー ID。移行で新しい ID を発行してしまうと、それらがすべて黙って壊れます。対策は口で言うのは簡単で、正しく行うことが不可欠です。Auth0 の user_id を sub として保持し、client_id もそのまま維持します。そうすれば、下流の何も気づきません。
2. パスワード、本当に難しいのはこれです。 Auth0 の Management API は、パスワードハッシュを決して返しません。これは Auth0 の意図的なポリシーであって、あなたのツールの不備ではありません。誠実な選択肢は 2 つあります。
- Auth0 のサポート経由の一括エクスポートを依頼します。各ユーザーの bcrypt ハッシュを含む NDJSON ファイルが手に入ります。bcrypt は移植可能なので、bcrypt を検証できるものなら何でもそのハッシュをそのまま受け取れ、ユーザーは何もリセットせずに済みます。
- あるいはハッシュは一切使わず、ユーザーに初回サインイン時に新しいパスワードを設定してもらいます。何かが「失われる」わけではありません(そもそも持ち出せるハッシュがなかったのですから)が、ユーザーにとっては目に見える手順になります。
ハッシュを取り出すセルフサービスの API はありません。そのサポート経由のファイルなしでワンクリックの Auth0 エクスポートにパスワードが含まれると言う人がいたら、それはごまかしです。
3. 1,000 ユーザーの上限。 Auth0 のユーザー一覧 API が返すのは最大 1,000 ユーザーです。それより大きなテナントでは、ユーザーの本当の、完全な取得元はライブの API ではなく、一括エクスポートのファイル(ハッシュを含むのと同じファイル)です。
それをワンクリックにする
これが、私たちが Authagonal に組み込んだものです。インポーターに Auth0 の machine-to-machine アプリ(読み取りスコープのみ)を指定すると、次のことを行います。
- まず読み取り専用のプレビューを実行します。インポートするすべてのアプリケーション、API、ロール、接続、ユーザーを数え、注意が必要なものにはフラグを立てます。確定するまで何も書き込まれません。
- アプリケーション、API のスコープとオーディエンス、ロールとその割り当て、ユーザーとメタデータ、エンタープライズ OIDC 接続を移行します。その際
subとclient_idを保持するので、既存のトークンや参照は引き続き解決されます。 - Auth0 のクライアントシークレット(読み取ると平文で返ってきます)をハッシュし直すので、アプリはシークレットをローテーションすることなく認証を続けられます。
- エクスポートファイルを用意すれば、bcrypt のパスワードハッシュをそのままインポートします。このファイルは 1,000 ユーザーの上限も取り払います。エクスポートがなければ、ユーザーは初回サインイン時にパスワードを設定します。
そして、エンタープライズ機能(SAML、SCIM、MFA、監査ログ、カスタムドメイン)は接続単位で課金されるのではなくすべてのプランに含まれているので、あなたを出口へと押しやったものが、移行先で待ち構えていることはありません。
移行のテストについて、余談を 1 つ
私たちはインポーターを、モックではなく、データを投入した本物のデータベースに対してテストしています。そしてそれは十分に元を取りました。ASP.NET Identity は LockoutEnd を datetimeoffset として保存しており、それを GetDateTime() で読むと、その型に対して例外が投げられます。ロックアウトされたユーザーが 1 人いるだけで、インポート全体が失敗していたはずでした。これは、本物のインポーターを本物のデータに対して実行しなければ見つかりません。どんな移行ツールを評価するにしても、どうテストされているかを尋ねてください。「ソース API をモックしています」は「データの入ったテナントに対して実行しています」と同じではありません。
出口を検討しているなら
移行は、恐れているよりも退屈です。プレビューし、ID を保持し、パスワードの扱いを決める。本当の制約は、Auth0 のハッシュエクスポートの 1 つだけです。ご自身のテナントから何が移行されるかを確認したいなら、プレビューは読み取り専用で、確定する前にすべてを見せてくれます。