まとめ

この章では、JWT認証の仕組みを学びつつ、実際にサインアップ・ログイン・保護されたエンドポイント・リフレッシュ・ログアウトまでの一通りをGoで実装しました。

  • JWTは、トークン自体に検証可能な情報を埋め込むステートレスな認証方式である
  • JWTはヘッダ・ペイロード・署名の3パートを.で連結した文字列で、ペイロードは暗号化されず誰でも復号できる
  • パスワードはbcryptでソルト付きハッシュ化して保存し、レスポンスに含めない
  • 認証系のエラーメッセージは、原因を区別しない共通の文言にそろえる
  • アクセストークンは短命(例: 15分)にして盗難時の影響を狭め、リフレッシュトークンで再発行する構成にする
  • リフレッシュトークンはDBで管理し、ローテーションと失効管理ができる
  • JWT検証ミドルウェアでBearer <トークン>を検証し、認証済みユーザのIDをgin.Contextに載せて後続ハンドラに渡せる
  • ログアウトはリフレッシュトークンをrevoked_atで失効させることで実現し、以降の/refreshを拒否できる
  • JWTの即時無効化を実現するため、revoked_access_tokensテーブルでアクセストークンのブラックリストを管理し、認証ミドルウェアで照合することでログアウト直後から拒否できる
  • コードは責務ごとにmain.go/model.go/helper.go/middleware.go/handler.goの5ファイルに分割し、Goのマルチファイル構成ではgo run .でパッケージ全体をまとめてコンパイル・実行できる
  • DB接続情報とJWTの署名鍵は.envファイルに外出しし、godotenvで環境変数として読み込むことで、秘匿情報をコードから分離できる

次の章では、Goの静的解析ツールをハンズオン形式で体験します。