アクセストークンの再発行

アクセストークンの再発行を行う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...)を使います。