Authlib: OpenID implicit grant checks raw scope instead of allowed scope before issuing ID tokensGHSA-q686-2qmg-hqc7
MEDIUMFix: authlib/authlib#945GHSA-q686-2qmg-hqc7 is a medium-severity (CVSS 4.6) CWE-863 vulnerability in authlib. A fix is available for authlib — see the affected versions and patch details below.
EPSS Exploitation Probability
Probability of exploitation in the next 30 days, from FIRST.org EPSS.
How urgent is this, really
GHSA-q686-2qmg-hqc7 by exploitation likelihood (EPSS) against impact (CVSS). Outside the shaded patch-first corner.
Where this sits among everything scored
Of 396,257 CVEs with a current EPSS score, this one falls in the < 10% band (highlighted). Counts from FIRST.org, log-scaled.
Real-World Exposure
authlibReal-time download stats are indexed for npm and PyPI packages. This vulnerability affects PyPI packages — download data is not available via public APIs for these ecosystems.
Description
Report metadata
| Field | Value |
|---|---|
| Package | authlib (PyPI, pkg:pypi/authlib) |
| Repository | https://github.com/authlib/authlib |
| Component | authlib.oidc.core.grants.implicit.OpenIDImplicitGrant.validate_authorization_request |
| Vulnerability class | Authorization bypass: a client's scope restriction is bypassed for OpenID Connect ID token issuance |
| Verified against | c529a61af40e3efe05286140e00fbdced07d7987 (v1.8.0). Earlier releases were not checked. |
| API surface | Public API (OpenIDImplicitGrant, registered with server.register_grant(...)) |
| Affected in default configuration | Yes. No non-default option is needed once OpenIDImplicitGrant is registered. Client metadata decides exposure: Authlib's standard ClientMixin checks response type and scope independently, so a client can be permitted id_token responses without being allowed the openid scope. |
Summary
OpenIDImplicitGrant.validate_authorization_request() first runs the parent ImplicitGrant validation, which filters the requested scope through client.get_allowed_scope() and stores the result in request.scope. It then decides whether this is an OpenID request by checking the raw, client-supplied request.payload.scope instead of that filtered value. A client that is allowed profile but not openid can therefore request scope=openid profile, pass the check, and receive a signed ID token (with sub and profile claims) once the user consents. This happens even when Authlib's built-in, scope-filtering BearerTokenGenerator is in use.
The tainted input is the authorization request's scope parameter. The OAuth client fully controls it, and the client is the very party the scope restriction is meant to constrain. Any registered client can add openid to its request if it is permitted an id_token or id_token token response type and its allowed scopes exclude openid but include a claim-bearing scope such as profile.
Sibling paths treat the same client correctly, which suggests the raw-scope check is a bug rather than intended behaviour:
ImplicitGrant.validate_authorization_request()-> filters the requested scope throughclient.get_allowed_scope()intorequest.scope(safe,authlib/oauth2/rfc6749/grants/implicit.pylines 141-147)OpenIDImplicitGrant.validate_authorization_request()-> checks the rawrequest.payload.scope(unsafe,authlib/oidc/core/grants/implicit.pyline 72)UserInfoEndpoint-> rejects the same client's access token with 403insufficient_scope(safe; observed during verification, line not recorded)- OIDC authorization code flow -> issues no
id_tokenfor the same client (safe; observed during verification, line not recorded)
Impact
A registered OAuth client that the operator has excluded from the openid scope can get an OpenID Connect ID token for any user who logs in and approves its authorization request. During verification the provider returned an RS256-signed ID token carrying iss, aud (the requesting client), nonce, auth_time, at_hash, sub and name, while the granted scope was only profile. A consent page built the way the Authlib docs show lists only profile, so the user is not shown that an identity token will be issued.
Without this bug, the same request fails with InvalidScopeError ("Missing 'openid' scope") because the client's resolved scope does not include openid. The new capability is the ID token itself: a signed assertion of the user's identity (sub) plus claims from the client's other allowed scopes. Gating that token is exactly what the openid scope is for. The access token stays restricted when the built-in token generator is used: Authlib's UserInfoEndpoint rejects it with 403 insufficient_scope.
Scoring note: we did not compute a CVSS score. An initial triage rated this High. After dynamic verification we assess practical severity as closer to Medium, because:
- The attacker must be a registered client that is permitted
id_tokenresponse types. - The user must log in and consent.
- The ID token's
audis the attacking client.
Two kinds of deployment are not affected:
- Deployments that use only the OIDC authorization code flow. During verification, that flow issued no ID token for the same client.
- Deployments where every client permitted an
id_tokenorid_token tokenresponse type is also allowed theopenidscope.
Preconditions
- The authorization server registers
OpenIDImplicitGrant(or a subclass), e.g.server.register_grant(MyOpenIDImplicitGrant). The vulnerable method runs on every OIDC implicit authorization request. - A client's metadata permits an OIDC implicit response type (
id_tokenorid_token token). Nothing in Authlib ties this to theopenidscope. The standard SQLAlchemyClientMixinchecks response type and scope independently, and it filters requested scopes against the client's allowed scopes atauthlib/integrations/sqla_oauth2/client_mixin.py:124-129. - That client's allowed scopes exclude
openidbut include another claim-bearing scope, such asprofile. - The attacker controls that registered client and sends an authorization request that adds
openidto otherwise allowed scopes (e.g.scope=openid profile), with anonce. - A user logs in and approves the request.
- Branch condition: the raw
request.payload.scopecontainsopenidwhile the filteredrequest.scopedoes not. Sois_openid_scope(self.request.payload.scope)is true atimplicit.py:72and noInvalidScopeErroris raised.
No non-standard usage, monkey-patching or unusual configuration is needed: this is the public grant used as intended. Keeping a client's response types and allowed scopes in sync is not documented as the integrator's responsibility. The parent grant stores the filtered request.scope specifically so that authorization decisions use it. We did not capture a link to the relevant Authlib docs page, but the verification built its consent page the way those docs show.
Data flow
- Source: the OAuth client controls the authorization request's
scopeparameter, e.g.GET /authorize?response_type=id_token%20token&client_id=c&redirect_uri=https%3A%2F%2Fc%2Fcb&scope=openid%20profile&nonce=n. The raw value remains available asrequest.payload.scope. - Propagation:
ImplicitGrant.validate_authorization_request()filters the requested scope throughclient.get_allowed_scope()and stores the result inrequest.scope(here'profile').request.payload.scopestill holds the rawopenid profile(authlib/oauth2/rfc6749/grants/implicit.py:141-147). - Sink:
OpenIDImplicitGrant.validate_authorization_request()uses the raw value to decide whether this is an OpenID request:if not is_openid_scope(self.request.payload.scope):(authlib/oidc/core/grants/implicit.py:72). The injectedopenidsatisfies the check, so the method returns the redirect URI instead of raisingInvalidScopeError(authlib/oidc/core/grants/implicit.py:70-84). - Reachability:
OpenIDImplicitGrantis the public grant that serves OIDC implicit authorization requests. After the user consents,create_granted_params()andprocess_implicit_token()issue the ID token and user claims (authlib/oidc/core/grants/implicit.py:112-129,authlib/oidc/core/grants/implicit.py:132-169).
Vulnerable code
authlib/oidc/core/grants/implicit.py, lines 70-84 at c529a61af40e3efe05286140e00fbdced07d7987 (an excerpt; ... marks code left out of the captured snippet):
redirect_uri = super().validate_authorization_request() # safe: parent grant sets the filtered request.scope
if not is_openid_scope(self.request.payload.scope): # <-- sink (line 72): raw, client-supplied scope
raise InvalidScopeError("Missing 'openid' scope", ...)
...
return redirect_uri
Reproduction
Verified two ways on Authlib c529a61af40e3efe05286140e00fbdced07d7987 (v1.8.0):
- a pytest PoC using the Flask test client
- a standalone Flask OpenID Provider on localhost, driven with
curl
The Python and Flask versions were not recorded.
Setup: a client registered with scope='profile' only (no openid) and response types id_token / id_token token. It uses Authlib's built-in SQLAlchemy ClientMixin and the built-in scope-filtering BearerTokenGenerator.
- The client sends an authorization request with
scope=openid profileand anonce. ImplicitGrantsetsrequest.scope='profile'. A consent page built the way the docs show displays onlyprofile.OpenIDImplicitGrant.validate_authorization_request()checks the rawrequest.payload.scopeat line 72, so the request passes.- After the user approves, the provider returns an RS256-signed ID token with
iss,aud(the client),nonce,auth_time,at_hash,subandname, while the granted scope isprofile. The ID token's signature verified against the provider's JWKS.
Controls run during verification:
- The same request without
openidreturnsinvalid_scope("Missing 'openid' scope"). - Authlib's
UserInfoEndpointrejects this client's access token with 403insufficient_scope. - The OIDC authorization code flow for the same client issues no
id_token.
The sketch below shows the request shape against Authlib's Flask OIDC test app. The verification's own test script is not included here.
# Client metadata: scope='profile' (no openid), response_types=['id_token token'].
rv = client.get('/authorize?response_type=id_token%20token&client_id=client-id&redirect_uri=https%3A%2F%2Fclient.test%2Fauthorized&scope=openid%20profile&nonce=n')
# after the user grants consent:
assert 'id_token=' in rv.headers['Location'] # should have been rejected: openid is not an allowed scope
- Expected:
InvalidScopeError/invalid_scope("Missing 'openid' scope"), because the client's resolved allowed scope (request.scope == 'profile') does not includeopenid. - Actual: after consent, the redirect carries a signed ID token (including
subandname) while the granted scope isprofile.
Suggested remediation
Decide whether to issue OpenID tokens from the scope the grant actually authorized, never from the raw requested scope. The authorized scope is self.request.scope, which the parent grant has already filtered through client.get_allowed_scope().
redirect_uri = super().validate_authorization_request()
-if not is_openid_scope(self.request.payload.scope):
+if not is_openid_scope(self.request.scope):
raise InvalidScopeError("Missing 'openid' scope", ...)
During verification, this one-line change at line 72 blocked the exploit, and the existing OIDC implicit/hybrid tests still passed (23 passed).
The same rule should hold for the rest of OIDC issuance. create_granted_params() (authlib/oidc/core/grants/implicit.py:112-129) passes the raw payload.scope to generate_token. It should pass self.request.scope instead.
Notes:
- Adjacent raw-scope use, worth fixing in the same change:
create_granted_params()hands the rawpayload.scopetogenerate_token. So a deployment whose custom token generator does not filter scope also grants the client access-token scopes it is not allowed; verification notedopenidandemail. Authlib's built-inBearerTokenGeneratorre-filters the access-token scope, so this only shows up with a non-filtering generator. That re-filtering does not stop the ID token. - Other paths through the same raw value: beyond
create_granted_params(), we did not audit every scope read inprocess_implicit_token()(authlib/oidc/core/grants/implicit.py:132-169), or in other OIDC grants such as the hybrid grant. Whether they share the pattern is not verified. - Already safe, no change needed:
- the scope filtering in the parent
ImplicitGrantand inClientMixin UserInfoEndpoint, which rejects this client's access token with 403insufficient_scope- the OIDC authorization code flow, which issues no ID token for this client
- the scope filtering in the parent
Suggested regression test, alongside the existing Flask OIDC implicit-grant tests:
- Register a client with
scope='profile'andresponse_types=['id_token token']. - Send an authorization request with
scope=openid profileand anonce, and approve it. - Assert that the response is an
invalid_scopeerror ("Missing 'openid' scope") and that the redirect contains noid_token.
A second case should use a token generator that does not filter scope, and assert that the issued access token carries only the client's allowed scopes.
Affected Packages
| Ecosystem | Package | Vulnerable range | Fix |
|---|---|---|---|
| 🐍PyPI | authlib | all versions | 1.9.0pip install --upgrade 'authlib==1.9.0' |
Detection & mitigation playbook
Open-source dependencyDetect
Scan your dependency tree (package-lock.json, pnpm-lock.yaml, requirements.txt, go.sum, etc.) for authlib, including transitive dependencies — a direct dependency you never call can still pull in a vulnerable version.
Fix
Update authlib to 1.9.0 or later, then make sure no transitive (indirect) dependency still pins the vulnerable range — O3 confirms GHSA-q686-2qmg-hqc7 is resolved across your whole dependency graph.
Workarounds
Put an independent control in front of the weakness: restrict the affected endpoint or interface to trusted networks, require an additional authentication factor or proxy-level check, and invalidate existing sessions and credentials in case the flaw has already been used.
Frequently Asked Questions
Is GHSA-q686-2qmg-hqc7 in your dependencies?
Find it across PyPI, including transitive dependencies.