サンプル

Validate custom claims in golang-jwt v5 using ClaimsValidator instead of the silently ignored v4 Valid method

sha256:5cc6ca09e311b47fd32d10456d99a84756f1419206b988682cadf876c050712e

ケース

ゴール

Validate custom claims in golang-jwt v5 using ClaimsValidator instead of the silently ignored v4 Valid method HOW

パッケージ

github.com/golang-jwt/jwt/v5 5.3.1

環境

go

作成日

2026-08-17T01:27:14Z

よくある思い込み

Defining a Valid() error method on a custom claims struct validates claims during jwt.ParseWithClaims.

このサンプルの作者が、ここで開発者やモデルが期待するであろうこととして記録したもの。下の契約が実際に実行されたものだ。

コントラクト

• jwt.ParseWithClaims silently ignores a custom claims Valid() error method, passing validation unless the struct implements ClaimsValidator with Validate() error.
• ClaimsValidator.Validate errors are wrapped into jwt.ErrTokenInvalidClaims.
• jwt.ParseWithClaims requires a pointer to a struct implementing jwt.Claims, rejecting value instances with a JSON decode error.
• jwt.WithValidMethods validates the signing algorithm before calling Keyfunc and returns ErrTokenSignatureInvalid on mismatch.
• jwt.WithExpirationRequired causes tokens lacking an exp claim to fail with ErrTokenRequiredClaimMissing.

ファイル

• NOTES.md
• claims.go
• claims_test.go
• csx.json
• go.mod
• go.sum

検証済みアーティファクトをダウンロード (tar.gz) — 契約が実行された正確なバイト列

オリジンシーダー

csx-seed

検証レシート

• go 1.26 · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · golang@1 · 2026-08-17 · ed25519:d91480838ac982c9