Auth0を仲介としたEpic SMART on FHIR認証の実装ガイド
A Practical Guide to Using Auth0 as an Identity Broker for Epic SMART on FHIR
サマリー
本記事は、Auth0がIDブローカーとして機能し、EpicのSMART on FHIR連携を実現する方法を解説している。単なるログインではなく、FHIRサーバーへのコンテキスト維持が課題であり、アプリケーションと複数の関係性を分けて設計することが重要である。
詳細
本ガイドは、既にAuth0を利用しており、新たにEpicとの接続が必要な開発チーム向けの内容である。SMART on FHIRの認証フローは、単にユーザーをログインさせるだけでなく、「どのFHIRサーバー」「どの患者/遭遇」といったコンテキスト情報を維持したままアプリケーションが動作することが求められる。 この課題の本質は、Auth0のようなIDブローカーを経由する際に、これらの重要なSMART固有のコンテキスト情報(`iss`, `aud`, `launch`など)が失われやすい点にある。したがって、認証プロセスを以下の3つの独立した関係性として捉える必要がある。 1. アプリケーション ↔ Auth0 (ログイン関係) 2. Auth0 ↔ Epic (エンタープライズ接続) 3. Epicトークン ↔ FHIR API (API呼び出し時のみ) 認証フローは、ユーザーがアプリケーションからAuth0へ、そしてAuth0を経由してEpicへとリダイレクトし、最終的にAuth0のコールバックを経てアプリケーションに戻るという複雑なステップを踏む。特に、アプリケーションがFHIR APIを直接呼び出す場合、Auth0経由で取得したトークンとは別に、Epicからのアクセス・トークンを意図的に取得する仕組みが必要となる。 実装上の重要なポイントとして、Epic側で設定すべきコールバックURLは、アプリケーションのドメインではなく、Auth0が生成する固定のエンタープライズ接続用パス(例:`https://<auth0-domain>/login/callback`)である必要がある。この設計理解が、スムーズな連携を実現するための鍵となる。
Original content copyright by respective publishers