Summary
When dispatching a request, HTTPEndpoint selects the handler by lowercasing the HTTP method and looking it up as an attribute with getattr, without restricting the lookup to a known set of HTTP verbs.
When an HTTPEndpoint subclass is registered through Route(...) without an explicit methods= argument, the route does not constrain the method and every method reaches the endpoint. If a non-standard HTTP method whose lowercased name matches an attribute on the endpoint subclass reaches the endpoint, that attribute is invoked as if it were a request handler. An attacker can use this to reach methods that were never meant to be HTTP handlers, such as internal helpers, without the authorization checks applied by the intended public handler.
Details
HTTPEndpoint uses the client-supplied method name to resolve an instance attribute, without validating it against the set of HTTP verbs the endpoint supports. A method such as _DO_DELETE therefore resolves an attribute like _do_delete and invokes it. Non-standard methods are valid RFC 9110 token methods, so an endpoint must not treat the method name as a trusted attribute selector.
Impact
An application is affected when all of the following hold:
- It defines an
HTTPEndpoint subclass and registers it via Route(...) without an explicit methods= argument.
- The subclass defines additional methods whose names match a non-standard HTTP-method token shape and that accept a single
request argument and return a response.
This also affects frameworks built on Starlette, like FastAPI.
Mitigation
Register HTTPEndpoint subclasses with an explicit methods= argument on the Route, listing only the HTTP verbs the endpoint supports. The route then rejects any other method with 405 Method Not Allowed before it reaches the endpoint, so non-standard methods cannot resolve an attribute.
Summary
When dispatching a request,
HTTPEndpointselects the handler by lowercasing the HTTP method and looking it up as an attribute withgetattr, without restricting the lookup to a known set of HTTP verbs.When an
HTTPEndpointsubclass is registered throughRoute(...)without an explicitmethods=argument, the route does not constrain the method and every method reaches the endpoint. If a non-standard HTTP method whose lowercased name matches an attribute on the endpoint subclass reaches the endpoint, that attribute is invoked as if it were a request handler. An attacker can use this to reach methods that were never meant to be HTTP handlers, such as internal helpers, without the authorization checks applied by the intended public handler.Details
HTTPEndpointuses the client-supplied method name to resolve an instance attribute, without validating it against the set of HTTP verbs the endpoint supports. A method such as_DO_DELETEtherefore resolves an attribute like_do_deleteand invokes it. Non-standard methods are valid RFC 9110 token methods, so an endpoint must not treat the method name as a trusted attribute selector.Impact
An application is affected when all of the following hold:
HTTPEndpointsubclass and registers it viaRoute(...)without an explicitmethods=argument.requestargument and return a response.This also affects frameworks built on Starlette, like FastAPI.
Mitigation
Register
HTTPEndpointsubclasses with an explicitmethods=argument on theRoute, listing only the HTTP verbs the endpoint supports. The route then rejects any other method with405 Method Not Allowedbefore it reaches the endpoint, so non-standard methods cannot resolve an attribute.