#jwt #oauth2 #oidc #tower-middleware #authorizer #resources #claim

tower-oauth2-resource-server

Tower middleware that provides JWT authorization against an OpenID Connect (OIDC) Provider

6 releases

0.1.5 Dec 10, 2024
0.1.4 Nov 25, 2024

#386 in Authentication

Download history 308/week @ 2024-11-04 26/week @ 2024-11-11 154/week @ 2024-11-18 173/week @ 2024-11-25 55/week @ 2024-12-02 144/week @ 2024-12-09

528 downloads per month

MIT license

54KB
1.5K SLoC

tower-oauth2-resource-server

Tower middleware that provides JWT authorization against an OpenID Connect (OIDC) Provider. This is useful when an application has delegated authentication and/or authorization to an external authorization service (e.g. Auth0, Microsoft Entra, etc).

Main inspiration for this middleware (both in naming and functionality) is Spring Security OAuth 2.0 Resource Server.

The middleware will attempt to process each request by:

  • Read JWT from Authorization header (with Bearer prefix)
  • Validate the JWT's signature against a public key obtained from jwks_url
  • Validate iss, exp, aud and possibly nbf scopes of the JWT

If validation fails, a HTTP 401 is returned. Otherwise next service in the middleware chain will be called. Claims of the JWT are made available as a Request extension. This enables you to write further application logic based on the claims, e.g. rejecting request that lack a certain scope.

Configuration

See docs for OAuth2ResourceServerBuilder.

Example usage

Check the examples.

Dependencies

~7–21MB
~320K SLoC