jwt-security-review
Audit JSON Web Token implementations for algorithm confusion, weak secrets, missing validation, and token lifecycle flaws. Use when a codebase or API uses JWTs for auth.
v2026.8.26-b2b6b523 installs+3 in 7 days0 Starssynced 19 hours ago
Install
No NotHoly CLI yet? Install it first.
$ curl -fsSL https://notholy.com/install.sh | sh$ notholy skills install securityskills/jwt-security-reviewWrites to ~/.notholy/skills after checking the signature and the SHA-256.
SignatureSigned, ed25519
Package8035307e…682e4b56
8035307e5be1…b81e682e4b561 file · 1.3 KBScanMedium1 finding
- No license found
Sourcegithub.com/securityskills/skills/tree/main/web-appsec/auth/jwt-security-review@b2b6b52
On this page
Review JWT-based authentication end to end.
Review Areas
Algorithm Handling
- Pin the expected algorithm server-side; reject
alg: noneoutright - RS256→HS256 confusion: if the server verifies HMAC using the public key as the secret, an attacker can forge tokens. Confirm verification uses the correct key type per algorithm
- Watch for
jku/x5uheader injection where the server fetches keys from an attacker-controllable URL kidinjection: path traversal or SQL/Command injection in key lookup
Key and Secret Strength
- HS256 secrets: ≥32 bytes of entropy, not from wordlists (
jwt-toolscrack mode) - Keys rotated; old keys revoked rather than just unused
Claims Validation
expandnbfenforced, clock skew boundedissandaudvalidated against expected values- Reject tokens with unexpected/extra privileged claims (e.g.,
admin: true) — parse then validate allowlist - Don't trust client-controlled
role/uidclaims if a server-side lookup exists
Token Lifecycle
- Refresh tokens: rotation with reuse detection; stored hashed server-side
- Revocation path exists for logout/password change/admin force-logout
- Access tokens short-lived (≤15 min); no long-lived bearer tokens
- Tokens not persisted in localStorage if XSS surface exists; prefer httpOnly cookies with CSRF protection
subis stable and unambiguous (user ID, not email that can change)
Common Code Smells
jwt.decode(token) // decode ≠ verify: signature never checked
jwt.verify(token, key) // no algorithms option pinned
jwt.verify(token, key, { algorithms: ['*'] })Test Cases
- Remove the signature; send
alg: nonetoken - Flip
algto HS256 signed with the public key - Expired/missing
exp, wrongiss/aud - Tampered claims with valid signature (e.g., escalate role)
- Replay a rotated refresh token — should invalidate the family
Output
Findings with token samples (redacted), affected code paths, and remediation per issue.
Files in this version
- SKILL.md2.2 KB
Permissions
| Permission | Declared | Found by the scan |
|---|---|---|
| Reads files | No | No |
| Writes files | No | No |
| Runs shell commands | No | No |
| Uses the network | No | No |
| Uses connectors | No | No |
| Drives a browser | No | No |
Scan findings
Reviewed on Nov 13, 2026
- MediumLicense · No license found
A clean scan lowers the risk but does not prove a package is safe. Read what you install.
| Version | Published | Commit | SHA-256 | Signature | Permission change |
|---|---|---|---|---|---|
| v2026.8.26-b2b6b52 | Nov 13, 2026 | b2b6b52 | 8035307e | Signed | – |
More from securityskills
All from this publisherMore in APIs, SaaS and identity
See the category- testing-for-sensitive-data-exposuremukul975/testing-for-sensitive-data-exposure5
- performing-jwt-none-algorithm-attackmukul975/performing-jwt-none-algorithm-attack5
- sharp-edgestrailofbits/sharp-edges4
- hydraaeondave/hydra4
- implementing-google-workspace-admin-securitymukul975/implementing-google-workspace-admin-security4
- implementing-api-security-posture-managementmukul975/implementing-api-security-posture-management4
Ask anything your scope allows.
Create an account, add credits and ask the first question in the chat or the terminal.
- 1/3
Create the account
Individual or company. You can switch to a company later without losing balance or keys.
IndividualCompany - 2/3
Add credits
By card. Pay per token, no subscription.
$5.00minimum deposit - 3/3
Ask
In the chat, or install the CLI and run notholy login in your terminal.
$ notholy login