JWTとは
JSON形式で表現されたトークンの一種
JWTに含まれる3つ要素
-
ヘッダー (Header): トークンの種類・署名方式などのメタデータ
{ "alg": "HS256", "typ": "JWT" } -
ペイロード (Payload): トークンに含まれるユーザー情報やデータ本体が入る部分。JSON 形式の Claims(クレーム) の集合
- クレームとは「このトークンが示す情報(ユーザ情報・期限・発行者など)」
// JWT のペイロード(クレーム)を定義する // JWT は「中身(Payload)にどんな情報を入れるか」で意味が決まります。 // 今回は標準クレーム(RegisteredClaims)を利用しています。 claims := jwt.RegisteredClaims{ // このトークンが誰のものか(ユーザーIDなど) Subject: userID, // → JSONでは "sub" // トークンを発行したサービス名(発行者) Issuer: IssuerName, // → "iss" // トークンを発行した日時 IssuedAt: jwt.NewNumericDate(time.Now()), // → "iat" // トークンの有効期限 ExpiresAt: jwt.NewNumericDate(expiresAt), // → "exp" // 他にも Audience(aud)や NotBefore(nbf)など必要に応じて追加できる }完成したJWTのペイロード
{ "sub": "123", "iss": "my-app", "iat": 1736850000, "exp": 1736853600 } -
署名 (Signature): ヘッダーとペイロードから生成されるデジタル署名
token.SignedString(h.Config.HMACSecretKey)
OAuth2とは
他のアプリに、ユーザーのデータへアクセスする許可を安全に与えるための仕組み(認可プロトコル)
主要な構成要素
- 認可サーバ(Authorization Server)
- 「許可を出す」サーバ
- トークン(アクセストークン / リフレッシュトークン)を発行する
- リソースサーバ(Resource Server)
- API サーバ
- ライブラリ情報 / ユーザープロフィール などのデータを持つ
- クライアント(Client Application)
- 外部アプリ
- ユーザーのデータにアクセスする側
- リソースオーナー(Resource Owner)
- 実際のユーザー(データの所有者)
仕組み
「ユーザーが“どこまでアクセスしていいか”を決める認可画面があり、
その許可に基づいてアクセストークンを発行し、
クライアントはそのトークンを使って API にアクセスする」仕組み。
ユーザー クライアント ---- 認可サーバ ---- リソースサーバ(API)
│ │ │ │
│ 認可画面へリダイレクト →
│ │ │ │
│ ← 許可確認画面
│ 許可する →
│ │ --- 認可コード受取 →
│ │ --- 認可コードを渡す → 認可サーバ
│ │ ← アクセストークン返却
│ │ --- API にアクセストークン送信 →
│ │ ← データが返る
- クライアントが認可画面にリダイレクト
- 認可サーバはユーザーに許可の確認
- 例:このアプリにあなたのメールアドレスへのアクセスを許可しますか?
- 認可コード(Authorization Code)がクライアントへ返る
- クライアントは認可コードを使ってトークンを要求
- 認可サーバがアクセストークン(+必要な場合リフレッシュトークン)を発行
- クライアントはアクセストークンを API に添えてリクエスト
- リソースサーバがトークンを検証し、データを返す
JWTとOAuth2の違い
JWT = トークンの形式(中身の構造だけを定義)
OAuth2 = トークン発行〜更新〜アクセス権の仕組み
アクセストークンとリフレッシュトークンの違い(JWT と OAuth2 の観点)
同じ点
JWT と OAuth2 で、アクセストークン/リフレッシュトークンの意味合いそのものは同じです。
| 種類 | 役割 | 有効期限 | 保存場所 | 主な用途 |
|---|---|---|---|---|
| アクセストークン (Access Token) | APIを呼び出す「一時パス」 | 短い(例:15分〜1時間) | メモリやCookie | APIの認可チェック |
| リフレッシュトークン (Refresh Token) | 新しいアクセストークンをもらうための「再発行チケット」 | 長い(例:7日〜30日) | セキュアCookieやDB | ログイン状態の維持 |
違いが出る点
- JWT:トークンの中身(形式)を定義するだけで、発行・更新・失効などの“運用ルール”は別途設計が必要になる
- OAuth2:そのトークンをどう発行・更新・利用するかを定義(プロトコル)
- アクセストークンの発行
- リフレッシュトークンの発行
- 更新フロー
- ローテーション
- 有効期限・失効
使う場面
JWTの場合
- SPA / モバイルアプリのログイン状態保持
- マイクロサービス間通信の認証
- サーバレス環境のセッションレス認証
- OIDC / OAuth2 ベースの SSO
- Cookieとの併用運用
※ SSO: 1回のログインで、複数のサービス・システムをまとめて利用できるようにする仕組み
OAuth2の場合
- ソーシャルログイン
- API連携
- デバイス間の連携
まとめ
JWT はトークンの形式、OAuth2 はトークンの発行・更新・権限管理の仕組みであり、両者はレイヤーがまったく異なることがわかります。