PT-2026-60909 · Npm · Better Auth
Published
2026-07-07
·
Updated
2026-07-07
CVSS v3.1
8.7
High
| Vector | AV:N/AC:H/PR:N/UI:N/S:C/C:H/I:H/A:N |
Am I affected?
Users are affected if all of the following are true:
- Their application uses
better-authat a version below the patched release. - Their application enables
oidcProvider()frombetter-auth/plugins/oidc-providerormcp()frombetter-auth/plugins/mcp(the mcp plugin delegates tooidcProviderand inherits both defaults). - For the algorithm-negotiation impact: relying parties of the application's OIDC server use a JWT verification library that performs algorithm negotiation from the discovery document without pinning to a specific signing algorithm.
- For the PKCE impact: the authorization URL is exposed to any party other than the user agent and the application's OP.
If the application only uses
@better-auth/oauth-provider (the canonical replacement) and have not enabled the legacy plugins, it is not affected. The new package's discovery document excludes none and its authorize schema rejects plain at parse time.Fix:
- Upgrade to
better-auth@1.6.11or later. - Migrate from the deprecated
oidcProviderandmcpplugins to@better-auth/oauth-providerwhen feasible. - If developers cannot upgrade their applications, see workarounds below.
Summary
The legacy
oidcProvider and mcp plugins exhibit two related defects in their OIDC discovery and authorize surfaces.The discovery document advertises
"none" in id token signing alg values supported (and, for mcp, in resource signing alg values supported on the OAuth protected-resource metadata). Any relying party that performs algorithm negotiation from this metadata without pinning to a real signing algorithm may accept unsigned tokens.PKCE
plain is enabled by default. The runtime gate in the authorize handler accepts code challenge method=plain under this default, and a missing code challenge method parameter is silently downgraded to "plain" before the allowlist check. Discovery advertises code challenge methods supported: ["S256"], contradicting the runtime acceptance of plain. RFC 9700 §2.1.1 (OAuth 2.1) explicitly forbids plain.Details
The metadata builders unconditionally inject
"none" into the alg list. The runtime authorize gate is structured so a buggy client that strips the code challenge method parameter still enters the plain code path because the handler rewrites the missing value to "plain" before the allowlist check fires.@better-auth/oauth-provider (the deprecation target for oidcProvider) is not affected by either defect. The metadata builder uses a JWSAlgorithms type union that structurally excludes "none". The authorize schema is code challenge method: z.literal("S256").optional(), which rejects plain at parse time.Patches
Fixed in
better-auth@1.6.11. The legacy oidcProvider and mcp plugins now:- Drop
"none"fromid token signing alg values supported(both plugins) and fromresource signing alg values supported(mcp). Discovery no longer advertises the unsigned-token option. - Default
allowPlainCodeChallengeMethodtofalse. A request that explicitly passescode challenge method=plainis rejected withinvalid requestunless the integrator opts in. - Reject a
code challengewithout an accompanyingcode challenge methodinstead of silently rewriting the missing value toplain. Clients that sendcode challengemust also sendcode challenge method=S256.
Discovery and runtime behavior align on
S256 only by default.Integrators who must keep plain PKCE for legacy clients can restore the previous shape with
oidcProvider({ allowPlainCodeChallengeMethod: true }) (and likewise for mcp). With the opt-in set, a request that omits code challenge method is treated as plain again, preserving backwards compatibility while keeping the secure default for everyone else. Both legacy plugins are deprecated long-term; the recommended migration is @better-auth/oauth-provider, which never advertised none or accepted plain PKCE.Workarounds
If developers cannot upgrade their applications immediately:
- Disable plain PKCE explicitly: set
oidcProvider({ allowPlainCodeChallengeMethod: false })(and the equivalent onmcp). Closes the runtime acceptance ofplaineven though the silent downgrade still rewrites missing methods. - Override the metadata to drop
"none"fromid token signing alg values supported. ForoidcProvider, passmetadata: { id token signing alg values supported: ["RS256"] }. Formcp, set the same onoptions.oidcConfig.metadata. Verify by curling the.well-knownendpoint. - Migrate to
@better-auth/oauth-provider: the package is the deprecation target and is unaffected by both defects.
Impact
- Algorithm-negotiation downgrade: relying parties that read the discovery document without pinning may accept unsigned (
alg: "none") tokens. - Authorization-code interception: PKCE
plaindoes not protect the authorization code if the URL leaks (Referer headers, browser history, screen capture, proxy logs). PKCES256is what protects against that exposure; withplainthe protection is absent. - OAuth 2.1 / RFC 9700 non-conformance: deployments shipping the defaults are non-compliant with current standards.
Credit
Reported by @subhanUmer.
Resources
Fix
Use of a Broken Cryptographic Algorithm
Found an issue in the description? Have something to add? Feel free to write us 👾
Related Identifiers
Affected Products
Better Auth