1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 1 year has passed since last update.

JWTとOAuth2の違い

1
Posted at

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 にアクセストークン送信 →
   │                  │ ← データが返る

  1. クライアントが認可画面にリダイレクト
  2. 認可サーバはユーザーに許可の確認
    • 例:このアプリにあなたのメールアドレスへのアクセスを許可しますか?
  3. 認可コード(Authorization Code)がクライアントへ返る
  4. クライアントは認可コードを使ってトークンを要求
  5. 認可サーバがアクセストークン(+必要な場合リフレッシュトークン)を発行
  6. クライアントはアクセストークンを API に添えてリクエスト
  7. リソースサーバがトークンを検証し、データを返す

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 はトークンの発行・更新・権限管理の仕組みであり、両者はレイヤーがまったく異なることがわかります。

1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?