Golang の JWT トークン: 安全な API のための開発者ガイド-Golang-php.cn

Golang の JWT トークン: 安全な API のための開発者ガイド

Mary-Kate Olsen

リリース： 2025-01-14 20:06:47

オリジナル

310 人が閲覧しました

JWT Tokens in Golang: A Developer’s Guide to Secure APIs

はじめに

現代の Web 開発では、安全でスケーラブルな認証が非常に重要です。 JSON Web Token (JWT) は、この目標を達成するための標準的な方法となっています。このブログ投稿では、JWT とは何か、JWT がどのように機能するか、Golang で実装する方法について説明します。

JWT とは何ですか?

JSON Web Token (JWT) は、二者間でクレームを安全に送信するためのコンパクトで URL セーフなクレーム表現方法です。 API や分散システムでユーザーを認証および認可するためによく使用されます。

JWT の構造

JWT は、ドット (.) で区切られた 3 つの部分で構成されます。

<code>Header.Payload.Signature</code>

ログイン後にコピー

例:

<code>eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWUsImlhdCI6MTUxNjIzOTAyMn0.reGQzG3OKdoIMWLDKOZ4TICJit3EW69cQE72E2CfzRE</code>

ログイン後にコピー

各部分は次のとおりです:

ヘッダー: トークンの種類 (JWT) と署名アルゴリズム (HS256) を指定します。

<code>{
  "alg": "HS256",
  "typ": "JWT"
}</code>

ログイン後にコピー

ペイロード: クレーム (ID、ロール、名前などのユーザーデータ) が含まれます。

<code>{
    "sub": "1234567890",
    "name": "John Doe",
    "admin": true,
    "iat": 1516239022
}</code>

ログイン後にコピー

署名: 暗号化署名プロセスを使用して、トークンの整合性を保証します。これについて詳しく見てみましょう。

署名の作成方法:

エンコードされたヘッダーとペイロードを接続します:
<code>  base64UrlEncode(header) + "." + base64UrlEncode(payload)</code>
ログイン後にコピー
結果に署名します:

秘密鍵または秘密鍵を使用した暗号化署名アルゴリズム (HMACSHA256、RS256 など) を使用します。

追加の署名: 最終的な JWT は
になります。
<code>  header.payload.signature</code>
ログイン後にコピー

JWT の仕組み

クライアントはログイン認証情報をサーバーに送信します。
有効な場合、サーバーは JWT を生成し、クライアントに返します。
クライアントは JWT を保存します (例: localStorage または Cookie)。
すべてのリクエストについて、クライアントは Authorization ヘッダーに JWT を含めます: Authorization: Bearer
サーバーはリクエストごとに JWT を検証します。
- 受信したヘッダーとペイロードを使用して署名を再計算します。
- 再計算された署名と受信した署名を比較します。

Golang での JWT の実装

Golang 開発者は、優れた golang-jwt/jwt ライブラリを活用して JWT を処理できます。このライブラリは、JWT の作成、署名、検証のための強力な機能を提供します。ここで見つけることができます。

ただし、JWT の管理には、署名メソッドの構成、トークンの解析、クレームの検証などの反復的なタスクが必要になることがよくあります。これを簡素化するために、golang-jwt の機能をラップするカスタムパッケージを作成しました。ここで私のパッケージをご覧いただけます。これは、カスタム JWT パッケージの使用方法の例です。

<code class="language-go">package main

import (
    "context"
    "fmt"
    "log"
    "time"

    "github.com/golang-jwt/jwt/v5"
    jwtutil "github.com/kittipat1413/go-common/util/jwt"
)

type MyCustomClaims struct {
    jwt.RegisteredClaims
    UserID string `json:"uid"`
}

func main() {
    ctx := context.Background()
    signingKey := []byte("super-secret-key")
    manager, err := jwtutil.NewJWTManager(jwtutil.HS256, signingKey)
    if err != nil {
        log.Fatalf("Failed to create JWTManager: %v", err)
    }

    // Prepare custom claims
    claims := &MyCustomClaims{
        RegisteredClaims: jwt.RegisteredClaims{
            ExpiresAt: jwt.NewNumericDate(time.Now().Add(15 * time.Minute)),
            Issuer:    "example-HS256",
            Subject:   "example-subject",
        },
        UserID: "abc123",
    }

    // Create the token
    tokenStringHS256, err := manager.CreateToken(ctx, claims)
    if err != nil {
        log.Fatalf("Failed to create token: %v", err)
    }
    fmt.Println("Generated Token:", tokenStringHS256)

    // Validate the token
    parsedClaims := &MyCustomClaims{}
    err = manager.ParseAndValidateToken(ctx, tokenStringHS256, parsedClaims)
    if err != nil {
        log.Fatalf("Failed to validate token: %v", err)
    }

    fmt.Printf("Token is valid! UserID: %s, Issuer: %s\n", parsedClaims.UserID, parsedClaims.Issuer)
}</code>

ログイン後にコピー

私のパッケージの完全な実装とドキュメントは、GitHub で参照できます: ここ。