本章の概要

この章では、GoでJWT(JSON Web Token)による認証を扱い、ハンズオン形式で学習しながら実装します。これにより、ログインAPIからアクセストークンの発行・検証・リフレッシュ・ログアウトによる失効管理までを含む、実用的な認証機構が構築できるようになります。

1. 本章の目的

前章 GoでCORS対応をしよう までで、ブラウザから呼び出せるAPIサーバを準備できました。実際のアプリケーションでは、これに加えて「誰からのリクエストなのか」を判定する認証の仕組みが必要になります。本章では、認証方式としてよく使われるJWT(JSON Web Token)を採り上げます。JWTはトークン自体に検証可能な情報が含まれる仕組みで、サーバがセッション状態を保持しなくてもリクエスト元を判定できるため、REST APIとの相性が良い方式です。本章では、ユーザ登録・ログインでトークンを発行し、保護されたエンドポイントで検証したうえで、リフレッシュトークンによる再発行とログアウトによる失効管理までを一通り扱います。

2. ハンズオンの流れ

MySQLにusersテーブルとrefresh_tokensテーブルを用意し、GinとGORMで認証APIを実装します。まずサインアップ・ログインでアクセストークンとリフレッシュトークンを発行し、JWT検証ミドルウェアで保護されたGET /notesを叩けるところまで作ります。そのうえで、リフレッシュトークンでアクセストークンを再発行するPOST /refreshと、リフレッシュトークンを失効させるPOST /logoutを実装します。

本章で構築する認証フローを以下に示します。

3. 事前準備

3.1 必要なツール

この章では、以下のツールを使用します。まだインストールしていない場合は、リンク先の手順に沿って準備をお願いします。

ツール名 関連箇所 理由
Visual Studio Code Visual Studio Codeのインストール 認証APIのコードを記述するエディタとして使用する
Go Goのインストール 認証APIの実装・実行環境として使用する
MySQL MySQLのインストール ユーザ情報とリフレッシュトークンを保存するデータベースとして使用する