ユーザ登録

ユーザ登録を行うPOST /signupエンドポイントを実装します。メールアドレスとパスワードを受け取り、ハッシュ化してusersテーブルにユーザレコードを作成する処理です。

1. パスワードハッシュヘルパーの追加

パスワードをハッシュ化するヘルパー関数を追加します。

📝 ヘルパー関数とは
ヘルパー関数(helper function)は、他の関数から共通で使うために切り出した補助的な小さな関数のことです。同じ処理を各所で書き重ねずに済み、呼び出し元のコードを読みやすく保てます。

パスワードのハッシュ化はsignupハンドラだけで呼び出す処理ですが、以降で追加するパスワード検証(verify_password)やJWT発行と合わせて「認証まわりの共通処理」として、auth.pyという専用ファイルにまとめて置きます。ハンドラから独立させておくと、認証ロジックの読みやすさが上がり、bcryptから別のハッシュアルゴリズムへの入れ替えなどの変更も1箇所で済むようになります。

Visual Studio Codeのエクスプローラーでjwt-auth-hands-onフォルダを右クリックし、「新しいファイル」を選択してauth.pyを作成します。

jwt-auth-hands-on/
├── .env
├── auth.py  ← このファイルを作成
├── database.py
├── models.py
└── setup_db.py

作成したauth.pyに以下の内容を記述して保存します。

import bcrypt

def hash_password(password: str) -> str:
    salt = bcrypt.gensalt()
    return bcrypt.hashpw(password.encode("utf-8"), salt).decode("utf-8")

コードを解説します。

def hash_password(password: str) -> str:

関数のシグネチャです。引数として生のパスワード文字列を受け取り、戻り値としてハッシュ化した文字列を返します。

salt = bcrypt.gensalt()

bcrypt.gensaltでソルトを生成します。ソルトはパスワードと組み合わせてハッシュ化する際に使う一意のランダム値で、レインボーテーブル攻撃を防ぐ役割があります。

return bcrypt.hashpw(password.encode("utf-8"), salt).decode("utf-8")

bcrypt.hashpwで、生のパスワードをソルト付きのハッシュにします。bcryptはstrではなくbytesを受け取るため、encode("utf-8")で変換して渡しています。生成されたハッシュ文字列にはソルトも埋め込まれているため、後の検証時には追加でソルトを渡す必要がありません。DBにはstrとして保存するため、decode("utf-8")で文字列化しています。

📝 パスワードハッシュに関する仕様
bcryptによるパスワードハッシュの仕様と使い方は、bcrypt PyPI ページに記載があります。ハッシュ化されていないパスワードや、SHA-1・SHA-256などの単純なハッシュ(ソルトなし・ストレッチングなし)でパスワードを保存する構成は、パスワードリスト攻撃・レインボーテーブル攻撃に対して脆弱です。パスワード保存には必ず、bcryptのようなソルト付き・計算コスト調整可能なハッシュ方式を使うようにします。

2. main.py と handlers.py の作成、signup ハンドラの追加

続いて、エントリポイントとなるmain.pyと、HTTPハンドラを配置するhandlers.pyを作成します。以降のセクションで追加するハンドラはすべてhandlers.pyに配置し、main.pyはappの初期化とhandlers.pyのルーターの取り込みに専念する構成にします。

まず、main.pyを作成します。

jwt-auth-hands-on/
├── .env
├── auth.py
├── database.py
├── main.py  ← このファイルを作成
├── models.py
└── setup_db.py

作成したmain.pyに以下の内容を記述して保存します。

from fastapi import FastAPI

from handlers import router

app = FastAPI()
app.include_router(router)

続いて、handlers.pyを作成します。

jwt-auth-hands-on/
├── .env
├── auth.py
├── database.py
├── handlers.py  ← このファイルを作成
├── main.py
├── models.py
└── setup_db.py

作成したhandlers.pyに以下の内容を記述して保存します。APIRouterを作成し、そこにsignupハンドラを登録する形です。

from typing import Annotated

from fastapi import APIRouter, Depends, HTTPException, status
from sqlmodel import Session, select

from auth import hash_password
from database import get_session
from models import SignupRequest, User

router = APIRouter()

@router.post("/signup", status_code=status.HTTP_201_CREATED)
def signup(
    payload: SignupRequest,
    session: Annotated[Session, Depends(get_session)],
):
    if len(payload.password) < 8:
        raise HTTPException(status_code=400, detail="password は 8 文字以上にしてください")
    existing = session.exec(select(User).where(User.email == payload.email)).first()
    if existing is not None:
        raise HTTPException(status_code=400, detail="このメールアドレスは既に登録されています")

    user = User(email=payload.email, password_hash=hash_password(payload.password))
    session.add(user)
    session.commit()
    session.refresh(user)
    return {"id": user.id, "email": user.email, "created_at": user.created_at}

main.py側でapp.include_router(router)を呼んでいるので、handlers.pyにrouter.post(...)で登録したエンドポイントはすべてappに自動で取り込まれます。

3. コードの解説

router = APIRouter()

APIRouterはFastAPIアプリケーションと同じデコレータ(.post・.getなど)を提供するルーター用のクラスです。main.pyからapp.include_router(router)で取り込むことで、app.post(...)で直接登録した場合と同じ扱いになります。ハンドラを別ファイルに切り出すためのFastAPIの標準的な手段です。

@router.post("/signup", status_code=status.HTTP_201_CREATED)
def signup(
    payload: SignupRequest,
    session: Annotated[Session, Depends(get_session)],
):

signupハンドラのシグネチャです。payload: SignupRequestでリクエストボディを型付きで受け取り、Depends(get_session)でDBセッションを依存注入します。status_code=status.HTTP_201_CREATEDで成功時に201 Createdを返す設定です。

if len(payload.password) < 8:
    raise HTTPException(status_code=400, detail="password は 8 文字以上にしてください")
existing = session.exec(select(User).where(User.email == payload.email)).first()
if existing is not None:
    raise HTTPException(status_code=400, detail="このメールアドレスは既に登録されています")

サインアップ時のバリデーションです。パスワードの最小長チェックと、メールアドレスの重複チェックを行っています。重複時に400で拒否することで、UNIQUE制約違反の生SQLエラーが利用者に返るのを防いでいます。

user = User(email=payload.email, password_hash=hash_password(payload.password))
session.add(user)
session.commit()
session.refresh(user)

hash_passwordでパスワードをハッシュ化してからUserを作り、DBに保存します。session.refresh(user)でDB側から自動採番されたidやcreated_atをuserに取り込みます。

return {"id": user.id, "email": user.email, "created_at": user.created_at}

作成したユーザを返します。レスポンスはハッシュを含めない安全な形(id・email・created_at)で作って返します。テーブルモデルをそのまま返すとpassword_hashが漏れるため、明示的に取り出しています。

4. 動作確認

APIサーバを起動します。

uvicorn main:app --reload

以下のような実行結果が表示されます。

INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)

別のターミナルから、ユーザを作成します。

curl -X POST http://localhost:8000/signup -H "Content-Type: application/json" -d '{"email":"test@example.com","password":"password12345"}'

以下のような実行結果が表示されます(IDと日時は環境により変わります)。

{"id":1,"email":"test@example.com","created_at":"2026-08-22T12:00:00"}

password_hashは返却せず、id・email・created_atだけがレスポンスに含まれています。念のため、MySQL側でもusersテーブルに実際にレコードが登録されていることを確認します。別のターミナルを開き、rootユーザでMySQLにログインします。

mysql -u root -p

ログイン後、auth_hands_onデータベースを使用します。

USE auth_hands_on;

続いて、usersテーブルの中身を確認します。

SELECT id, email, password_hash, created_at FROM users;

以下のような実行結果が表示されます(password_hashの値はハッシュ化された結果なので毎回異なります)。

+----+-------------------+--------------------------------------------------------------+---------------------+
| id | email             | password_hash                                                | created_at          |
+----+-------------------+--------------------------------------------------------------+---------------------+
|  1 | test@example.com  | $2b$12$abc...(bcryptのハッシュ文字列)                       | 2026-08-22 12:00:00 |
+----+-------------------+--------------------------------------------------------------+---------------------+

password_hashカラムに$2b$12$から始まる文字列が入っていれば、bcryptによるハッシュ化と保存が正しく行えています。確認できたら、exit;でMySQLのプロンプトを抜けます。

exit;