アクセストークンの再発行
アクセストークンの再発行を行うPOST /refreshエンドポイントを実装します。リクエストで受け取ったリフレッシュトークンがDBに存在し、失効・期限切れになっていないことを確認したうえで、古いリフレッシュトークンを失効させて新しいアクセストークンとリフレッシュトークンを返す処理です。
1. refresh ハンドラの追加
handlers.pyのimportにdatetimeとRefreshRequestを追加します。
from datetime import datetime
from typing import Annotated
from fastapi import APIRouter, Depends, HTTPException, status
from sqlmodel import Session, select
from auth import (
generate_access_token,
generate_refresh_token,
hash_password,
refresh_token_expires_at,
verify_password,
)
from database import get_session
from dependencies import get_current_user
from models import (
LoginRequest,
RefreshRequest,
RefreshToken,
SignupRequest,
TokenResponse,
User,
)
続いて、handlers.pyの末尾(notes関数の下)にrefreshハンドラを追加します。
@router.post("/refresh", response_model=TokenResponse)
def refresh(
payload: RefreshRequest,
session: Annotated[Session, Depends(get_session)],
):
rt = session.exec(
select(RefreshToken).where(RefreshToken.token == payload.refresh_token)
).first()
if rt is None or rt.revoked_at is not None or rt.expires_at <= datetime.utcnow():
raise HTTPException(status_code=401, detail="refresh token が無効または失効しています")
rt.revoked_at = datetime.utcnow()
session.add(rt)
session.commit()
return TokenResponse(
access_token=generate_access_token(rt.user_id),
refresh_token=issue_refresh_token(rt.user_id, session),
)
2. コードの解説
@router.post("/refresh", response_model=TokenResponse)
def refresh(
payload: RefreshRequest,
session: Annotated[Session, Depends(get_session)],
):
refreshハンドラのシグネチャです。payload: RefreshRequestでリフレッシュトークンをリクエストボディから受け取り、Depends(get_session)でDBセッションを注入します。response_model=TokenResponseにより、レスポンスはTokenResponseスキーマにキャストされて返ります。
rt = session.exec(
select(RefreshToken).where(RefreshToken.token == payload.refresh_token)
).first()
if rt is None or rt.revoked_at is not None or rt.expires_at <= datetime.utcnow():
raise HTTPException(status_code=401, detail="refresh token が無効または失効しています")
DBからリフレッシュトークンを検索し、以下のいずれかに該当する場合はまとめて401で拒否します。
- トークンがDBに存在しない
revoked_atが設定されている(=失効済み)expires_atが現在時刻を過ぎている
「存在しない」と「失効している」でメッセージを分けず、詳細を漏らさない構成にしています。
rt.revoked_at = datetime.utcnow()
session.add(rt)
session.commit()
古いリフレッシュトークンをrevoked_atで失効させます。再発行のたびに古いトークンを失効させるローテーション運用にしておくと、盗まれた古いトークンで永続的に新しいアクセストークンを取得され続けるリスクを下げられます。
return TokenResponse(
access_token=generate_access_token(rt.user_id),
refresh_token=issue_refresh_token(rt.user_id, session),
)
古いトークンを失効させたうえで、新しいアクセストークンとリフレッシュトークンを発行してレスポンスに返します。クライアント側は、以降のリクエストで受け取った最新のリフレッシュトークンだけを使う運用になります。
3. 動作確認
APIサーバは--reloadで動いているので、handlers.pyの保存で自動再起動されます。ログイン時に取得しておいたrefresh_tokenを/refreshに投げて、新しいアクセストークンとリフレッシュトークンを取得します。
curl -X POST http://localhost:8000/refresh -H "Content-Type: application/json" -d '{"refresh_token":"3f4c8d2a..."}'
以下のような実行結果が表示されます。
{"access_token":"eyJhbGciOi...新しい...","refresh_token":"a91b7e3d...新しい..."}
アクセストークンとリフレッシュトークンの両方が新しい値になっています。ここで、古いリフレッシュトークンで再度リフレッシュを試みると失効エラーになることを確認します。
curl -X POST http://localhost:8000/refresh -H "Content-Type: application/json" -d '{"refresh_token":"3f4c8d2a..."}'
以下のような実行結果が表示されます。
{"detail":"refresh token が無効または失効しています"}
/refreshのローテーションが働き、古いリフレッシュトークンは1度しか使えない状態になっています。次のセクションのログアウトでは、この新しく取得したリフレッシュトークン(a91b7e3d...)を使います。