型と定数

NumericDate

type NumericDate struct {
    time.Time
}

JWT 数値日付値（Unix タイムスタンプ）。有効範囲は 0 から 253402300799（9999-12-31 23:59:59 UTC）まで。

struct

メソッド

メソッド	シグネチャ	説明
MarshalJSON	func (date *NumericDate) MarshalJSON() ([]byte, error)	Unix タイムスタンプの JSON 数値にシリアライズ。ゼロ時刻または有効範囲外の場合は null を返す
UnmarshalJSON	func (date *NumericDate) UnmarshalJSON(b []byte) error	JSON 数値または文字列から Unix タイムスタンプをパース。負の値と有効範囲外の値を拒否

---

StringOrSlice

type StringOrSlice []string

JSON 文字列または JSON 配列のいずれかからデシリアライズ可能な []string を保持する型。要素数 1 のスライスは JSON 文字列として、複数要素のスライスは配列としてマーシャルされ、RFC 7519 §4.1.3 に準拠する。

type

メソッド

メソッド	シグネチャ	説明
MarshalJSON	func (s StringOrSlice) MarshalJSON() ([]byte, error)	要素数 1 のスライスは JSON 文字列として、複数要素は配列としてマーシャル（RFC 7519 §4.1.3）
UnmarshalJSON	func (s *StringOrSlice) UnmarshalJSON(b []byte) error	JSON 文字列または配列からパース

---

SigningMethod

type SigningMethod string

署名アルゴリズム型。

type

---

ValidationError

type ValidationError struct {
    Field   string
    Message string
    Err     error
}

フィールドレベルの検証失敗エラー。

struct

メソッド

メソッド	シグネチャ	説明
Error	func (e *ValidationError) Error() string	エラーメッセージ
Unwrap	func (e *ValidationError) Unwrap() error	内部エラーをアンラップ

---

RateLimiter

type RateLimiter struct { ... }

トークンバケットレートリミッター。RateLimitProvider インターフェースを実装。

struct

メソッド

メソッド	シグネチャ	説明
Allow	func (rl *RateLimiter) Allow(key string) bool	単一リクエストをチェック
AllowN	func (rl *RateLimiter) AllowN(key string, n int) bool	n 回のリクエストをチェック
Reset	func (rl *RateLimiter) Reset(key string)	指定したキーをリセット
Close	func (rl *RateLimiter) Close()	リソースを解放

---

SystemClock

type SystemClock struct{}

システムクロック。ClockProvider のデフォルト実装。

struct

メソッド

メソッド	シグネチャ	説明
Now	func (SystemClock) Now() time.Time	現在のシステム時刻を返す

---

FixedClock

type FixedClock struct {
    T time.Time
}

固定時刻クロック。テスト用途。

struct

フィールド

フィールド	型	説明
T	time.Time	固定時刻値

メソッド

メソッド	シグネチャ	説明
Now	func (c FixedClock) Now() time.Time	固定時刻を返す

---

署名アルゴリズム定数

const (
    SigningMethodHS256 SigningMethod = "HS256"
    SigningMethodHS384 SigningMethod = "HS384"
    SigningMethodHS512 SigningMethod = "HS512"

    SigningMethodRS256 SigningMethod = "RS256"
    SigningMethodRS384 SigningMethod = "RS384"
    SigningMethodRS512 SigningMethod = "RS512"

    SigningMethodPS256 SigningMethod = "PS256"
    SigningMethodPS384 SigningMethod = "PS384"
    SigningMethodPS512 SigningMethod = "PS512"

    SigningMethodES256 SigningMethod = "ES256"
    SigningMethodES384 SigningMethod = "ES384"
    SigningMethodES512 SigningMethod = "ES512"
)

定数	値	アルゴリズム	型
SigningMethodHS256	"HS256"	HMAC-SHA256	対称
SigningMethodHS384	"HS384"	HMAC-SHA384	対称
SigningMethodHS512	"HS512"	HMAC-SHA512	対称
SigningMethodRS256	"RS256"	RSA-SHA256	非対称
SigningMethodRS384	"RS384"	RSA-SHA384	非対称
SigningMethodRS512	"RS512"	RSA-SHA512	非対称
SigningMethodPS256	"PS256"	RSA-PSS-SHA256	非対称
SigningMethodPS384	"PS384"	RSA-PSS-SHA384	非対称
SigningMethodPS512	"PS512"	RSA-PSS-SHA512	非対称
SigningMethodES256	"ES256"	ECDSA-SHA256	非対称
SigningMethodES384	"ES384"	ECDSA-SHA384	非対称
SigningMethodES512	"ES512"	ECDSA-SHA512	非対称

---

トークンタイプ定数

const (
    TokenTypeAccess  = "access"
    TokenTypeRefresh = "refresh"
)

RegisteredClaims.TokenType フィールドに書き込まれるトークンタイプ定数。

• アクセストークンは Processor.Create が生成する
• リフレッシュトークンは Processor.CreateRefresh が生成する
• Processor.Refresh と Processor.RefreshInto は TokenTypeAccess のトークンを拒否する

定数	値	説明
TokenTypeAccess	"access"	アクセストークン
TokenTypeRefresh	"refresh"	リフレッシュトークン