JWTとは何か?定義とWebセキュリティにおける用途

最終更新: 9月26、2024

JSON Web Token (一般にJWTとして知られる)は、当事者間で情報を安全に送信するためのオープンスタンダードです。RFC 7519仕様に基づいて定義されており、主にWebセキュリティの分野でユーザー認証やデータ整合性の確保に使用されます。

JWTの構造

JWTは、ピリオドで区切られた3つのBase64Urlエンコードされた部分で構成されます。

  • ヘッダ: トークンの種類や署名アルゴリズムなど、トークンに関するメタデータが含まれます。例:
{"alg": "HS256", "typ": "JWT"}
  • ペイロード: このセクションには、エンティティ(通常はユーザー)に関するステートメントであるクレームと追加のメタデータが含まれます。例:
  • {"sub": "1234567890", "name": "John Doe", "admin": true}
  • 署名: トークンの完全性と発行者の真正性を検証するために使用されます。署名を計算するには、 ヘッダ Y·エル ペイロードは、次のようなアルゴリズムを使用してリンクされ、署名されます。 HMAC SHA256.
  • たとえば、署名は次のように生成されます。

    HMACSHA256(
      base64UrlEncode(header) + "." +
      base64UrlEncode(payload),
      your-256-bit-secret)

    JWTのクレームの種類

    請求は一般的に3つのカテゴリーに分類されます。

    登録された請求

    これらはJWTで使用することを推奨される、事前定義されたクレームのセットです。これには以下が含まれます。

    • ISS: トークンの発行者。
    • 以下: トークンの主題。
    • AUD: トークンの対象ユーザー。
    • EXP: トークンの有効期限。
    • nbf: トークンが有効な時間を示します。

    国民の苦情

    クレームはユーザーが自由に定義できますが、名前の衝突を避ける必要があります。例:

    • ユーザ名: 認証された個人のユーザー名。
    • 役割: ユーザーロール(管理者、一般ユーザーなど)。

    民間の請求

    カスタム クレームは、登録済みクレームや公開クレームに干渉しない方法で関係者間で情報を共有するために作成されます。

    JWT は Web セキュリティでどのように機能しますか?

    JWTのワークフローは一般的に以下の手順に従います。

    認証

    このプロセスは、ユーザーがログインフォームなどを通じて認証に成功した時点で開始されます。ユーザーが認証されると、サーバーはユーザーのセッションに関する情報を含むJWT( Java Web Token)を生成します。

    トークン生成

    認証後、サーバーはJWTを作成し、それを応答としてクライアントに送信します。このトークンは、localStorageに保存することも、ブラウザのCookieとして保存することもできます。

    トークンの送信

    以降のリクエストごとに、クライアントは通常Authorizationヘッダーを介してJWTをサーバーに送信します。

    Authorization: Bearer 

    トークン検証

    サーバーはトークンを受け取り、秘密鍵または証明書を使用して検証します。トークンが有効で有効期限が切れていない場合、保護されたリソースへのアクセスが許可されます。

    JWTを使用する利点

    ウェブアプリケーションでJWTを使用することには、いくつかの利点があります。

    スケーラビリティ

    JWTは自己完結型であるため、サーバーはユーザーセッションをメモリに保持する必要がありません。これにより、複数のサーバーインスタンスがセッション状態を確認するためにデータベースにアクセスする必要なくリクエストを処理できるため、スケーラビリティが向上します。

    相互運用性

    JWTはオープンスタンダードであるため、様々なプログラミング言語やプラットフォーム間で相互運用可能です。これにより、様々なシステムやサービスへの統合が容易になります。

    セキュリティ

    JWTに署名できる機能は、コンテンツが改ざんされていないことを保証し、暗号化アルゴリズムの使用はセキュリティをさらに強化し、必要に応じて機密性を提供します。

    JWTを使用する際のデメリット

    JWTの実装には利点がある一方で、欠点もある。

    トークンサイズ

    JWTは、特にペイロードに多くの情報が含まれている場合、サイズが大きくなる可能性があります。そのため、すべてのリクエストにJWTが添付されると、ネットワークのオーバーヘッドが増加する可能性があります。

    有効期限と失効

    JWTは発行されると、有効期限が切れるまで有効です。ユーザーのアカウントが侵害された場合など、ユーザーのJWTを取り消す必要がある場合は、トークンは有効期限が切れるまで使用され続ける可能性があるため、サーバーは失効リストなどの追加のメカニズムを実装する必要があります。

    鍵管理

    JWTのセキュリティは、トークンの署名に使用される鍵の強度に依存します。この鍵を安全に保管し、定期的に更新することは、アプリケーションのセキュリティにとって非常に重要です。

    JWTの一般的な用途

    JWTは、以下のようなさまざまなアプリケーションや状況で使用されています。

    API認証

    RESTful APIを使用するアプリケーションでは、リクエストの認証にJWTが頻繁に使用されます。これにより、API開発者は安全かつ使いやすいアーキテクチャを構築できます。

    マイクロサービス間の認証

    マイクロサービスアーキテクチャにおいて、JWTはサービス間でセッションを共有する必要なくユーザーを検証する簡単な方法を提供することで、サービス間の認証を容易にします。

    SSO (シングル サインオン)

    JWTを導入することで、 SSOソリューションの展開が容易になり、ユーザーは一度認証するだけで、再度ログインすることなく複数のアプリケーションにアクセスできるようになります。

    安全な情報共有

    JWTは、異なる当事者間で情報を共有し、送信されるデータの完全性と真正性を保証するためにも役立ちます。

    アクセス制御

    JWT(JSON Web Token)を使用すると、役割や権限に関するデータをトークンに直接含めることができるため、きめ細かなアクセス制御を実装できます。

    プロジェクトでのJWTの実装

    JWTの作成

    作成するには JWT、など複数の言語で利用可能なさまざまなライブラリを使用することができます JavaScriptを, Python y Java. 例として Node.js 図書館を利用する jsonwebtoken 次のとおりです。

    const jwt = require('jsonwebtoken');
    const token = jwt.sign({ id: user.id }, 'your-256-bit-secret', { expiresIn: '1h' });

    JWTの検証

    JWTの検証も同様に、同じライブラリを使用して行います。

    jwt.verify(token, 'your-256-bit-secret', function(err, decoded) {
      if (err) {
        return console.log('Token inválido');
      }
      console.log(decoded); // { id: 123, i Ss: 'your-issuer', ... }
    });

    トークンの有効期限の処理

    トークンの有効期限切れに対応するため、保護されたリソースへのアクセスを許可する前に、ペイロード内の有効期限(claim exp)を確認する必要があります。トークンの有効期限が切れている場合は、ユーザーを再度ログインさせて新しいトークンを取得させる必要があります。

    ミドルウェアの使用

    多くのアプリケーション、特にNode.jsとExpressのコンテキストでは、ミドルウェアを使用してJWTの検証を一元的に処理します。基本的な例を以下に示します。

    const express = require('express');
    const jwt = require('jsonwebtoken');
    const app = express();

    const checkToken = (req, res, next) => {
    const token = req.headers['authorization']?.split(' ')[1];
    if (!token) return res.sendStatus(401); // No autorizado

    jwt.verify(token, 'your-256-bit-secret', (err, decoded) => {
    if (err) return res.sendStatus(403); // Prohibido
    req.user = decoded; // Guardar información del usuario en el request
    next(); // Continuar a la siguiente middleware
    });
    };

    app.get('/protected', checkToken, (req, res) => {
    res.send('Este es un recurso protegido.');
    });

    JSON Web Tokenは、 Webアプリケーションにおける認証と認可を管理するための強力なツールです。そのシンプルな構造と検証・妥当性確認機能により、安全で拡張性が高く、相互運用可能なシステムの実装が容易になります。ただし、その効果を最大限に引き出すためには、ベストプラクティスと適切なセキュリティ管理を考慮する必要があります。