パッケージ関数

New

func New(cfg Config) (*Processor, error)

新しい JWT Processor を作成します。DefaultConfig() でデフォルト設定を取得し、必要なフィールドを変更して渡します。

パラメータ

パラメータ	型	説明
cfg	Config	設定項目

戻り値

戻り値	型	説明
processor	*Processor	JWT プロセッサ
err	error	設定の検証に失敗した場合にエラーを返す

例

package main

import (
    "fmt"

    "github.com/cybergodev/jwt"
)

func main() {
    cfg := jwt.DefaultConfig()
    cfg.SecretKey = "hmac-key-that-has-at-least-32-bytes!"

    processor, err := jwt.New(cfg)
    if err != nil {
        panic(err)
    }
    defer processor.Close()

    fmt.Println("Processor created successfully")
}

エラー

エラー	発生条件
ErrInvalidConfig	設定項目が不正
ErrInvalidSecretKey	鍵が不足、32 バイト未満、弱鍵、型エラー、または ECDSA 曲線が不一致
ErrInvalidSigningMethod	サポートされていない署名アルゴリズム

---

DefaultConfig

func DefaultConfig() Config

適切なデフォルト値を持つ設定を返します。

戻り値

戻り値	型	説明
config	Config	デフォルト設定

デフォルト値

フィールド	デフォルト値
AccessTokenTTL	15 * time.Minute
RefreshTokenTTL	7 * 24 * time.Hour
Issuer	"jwt-service"
SigningMethod	SigningMethodHS256
RateLimitRate	100
RateLimitWindow	time.Minute
Blacklist	DefaultBlacklistConfig()

例

cfg := jwt.DefaultConfig()
cfg.SecretKey = "hmac-key-that-has-at-least-32-bytes!"
// 必要に応じて他のフィールドを変更

---

DefaultBlacklistConfig

func DefaultBlacklistConfig() BlacklistConfig

適切なデフォルト値を持つブラックリスト設定を返します。

戻り値

戻り値	型	説明
config	BlacklistConfig	デフォルトブラックリスト設定

デフォルト値

フィールド	デフォルト値
CleanupInterval	5 * time.Minute
MaxSize	100000
EnableAutoCleanup	true

---

NewNumericDate

func NewNumericDate(t time.Time) NumericDate

time.Time から NumericDate を作成します。

パラメータ

パラメータ	型	説明
t	time.Time	時間値

戻り値

戻り値	型	説明
date	NumericDate	JWT 数値日付

---

NewRateLimiter

func NewRateLimiter(maxRate int, window time.Duration) *RateLimiter

トークンバケットレートリミッターを作成します。

パラメータ

パラメータ	型	説明
maxRate	int	ウィンドウあたりの最大リクエスト数（≤0 の場合、デフォルト 100）
window	time.Duration	時間ウィンドウ（≤0 の場合、デフォルト 1 分）

戻り値

戻り値	型	説明
limiter	*RateLimiter	レートリミッターインスタンス