ヘッダー & セッション認証

以下の HeaderStore、headersProvider、sessionAuth コードは、互いに独立したファイルの例ではなく、プロジェクト共通 HTTP アダプター (rxjsHttpService.ts/commonService.ts) の各部分を分けて説明するものです。全体ファイル構造を最初に見たい場合は、HTTP クライアントの最小完成形/拡張形全体コードを確認した後にこのページを読んでください。

ログイン後に受け取ったアクセストークンのように複数のサービスが一緒に使用する必要があるヘッダーはHeaderStoreに保管できます。

クライアントコンポーネントではHeaderStoreを読み取り、サーバーコンポーネントではクッキーを読み取るように headersProviderを作成できます。この関数ではCSRとSSRのヘッダー取得方法を一箇所で分離できます。

自動生成サービスを一つずつ修正せずに、共通callApiにセッションオペレーターを付けます。これによりすべての生成サービスが同じトークン取得とリフレッシュルールを使用します。

Authorizationがない場合はトークンエンドポイントを最初に確認し、元のリクエストが401の場合はリフレッシュ後にもう一度リクエストします。リフレッシュも失敗した場合はログアウトエンドポイントを呼び出し元のエラーを伝えます。

401 refresh/retry を使用せず、リクエスト前にトークンだけを同期するには withEnsureToken() を使用します。

公開APIや簡単なプロジェクトではこれで十分です。HeaderStoreとセッション認証は必須構造ではありません。