타입과 상수

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을 보관; 단일 요소 슬라이스는 JSON 문자열로, 다중 요소 슬라이스는 배열로 직렬화, RFC 7519 §4.1.3 준수.

type

메서드

메서드	시그니처	설명
MarshalJSON	func (s StringOrSlice) MarshalJSON() ([]byte, error)	단일 요소 슬라이스는 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"	리프레시 토큰