LowGHSA-29wx-vh33-7x7rCVE-2024-51744GO-2024-3250

Bad documentation of error handling in ParseWithClaims can lead to potentially dangerous situations

Published 4 Nov 2024 · Updated 10 Sept 2026

Is your project on an affected github.com/golang-jwt/jwt/v4?

Private repo? Upload its lockfile instead, or connect GitHub to check every repo.

Look after several Go apps? Indie watches up to 15 repos, private ones too, for $5 a month. See Indie

Affected package

Affected
<4.5.1
Fixed in
4.5.1
Update to the fixed version for your release line, for example:go get github.com/golang-jwt/jwt/v4@v4.5.1

Details

Summary

Unclear documentation of the error behavior in ParseWithClaims can lead to situation where users are potentially not checking errors in the way they should be. Especially, if a token is both expired and invalid, the errors returned by ParseWithClaims return both error codes. If users only check for the jwt.ErrTokenExpired using error.Is, they will ignore the embedded jwt.ErrTokenSignatureInvalid and thus potentially accept invalid tokens.

Fix

We have back-ported the error handling logic from the v5 branch to the v4 branch. In this logic, the ParseWithClaims function will immediately return in "dangerous" situations (e.g., an invalid signature), limiting the combined errors only to situations where the signature is valid, but further validation failed (e.g., if the signature is valid, but is expired AND has the wrong audience). This fix is part of the 4.5.1 release.

Workaround

We are aware that this changes the behaviour of an established function and is not 100 % backwards compatible, so updating to 4.5.1 might break your code. In case you cannot update to 4.5.0, please make sure that you are properly checking for all errors ("dangerous" ones first), so that you are not running in the case detailed above.

token, err := /* jwt.Parse or similar */
if token.Valid {
	fmt.Println("You look nice today")
} else if errors.Is(err, jwt.ErrTokenMalformed) {
	fmt.Println("That's not even a token")
} else if errors.Is(err, jwt.ErrTokenUnverifiable) {
	fmt.Println("We could not verify this token")
} else if errors.Is(err, jwt.ErrTokenSignatureInvalid) {
	fmt.Println("This token has an invalid signature")
} else if errors.Is(err, jwt.ErrTokenExpired) || errors.Is(err, jwt.ErrTokenNotValidYet) {
	// Token is either expired or not active yet
	fmt.Println("Timing is everything")
} else {
	fmt.Println("Couldn't handle this token:", err)
}

Is GHSA-29wx-vh33-7x7r in any of your client repos?

Checking one package by hand is fine. Checking it across forty client projects is not. NPMscan reads the lockfiles in every GitHub repo you pick, finds each project with an affected github.com/golang-jwt/jwt/v4, and gives you the command that fixes it.

More advisories for github.com/golang-jwt/jwt/v4

  • LowCVE-2025-30204Excessive memory allocation during header parsing in github.com/golang-jwt/jwt · 26 Mar 2025
  • HighCVE-2025-30204jwt-go allows excessive memory allocation during header parsing · 21 Mar 2025
github.com/golang-jwt/jwt/v4 security overview

References

Advisory data from OSV.dev (opens OSV.dev in a new tab), refreshed daily.