actix-web-middleware-keycloak-auth
| Crates.io | actix-web-middleware-keycloak-auth |
| lib.rs | actix-web-middleware-keycloak-auth |
| version | 0.5.0 |
| created_at | 2020-11-25 18:17:19.942793+00 |
| updated_at | 2024-09-29 10:11:10.004569+00 |
| description | A middleware for Actix Web that handles authentication with a JWT emitted by Keycloak |
| homepage | |
| repository | https://github.com/dsferruzza/actix-web-middleware-keycloak-auth |
| max_upload_size | |
| id | 316375 |
| size | 145,860 |
David Sferruzza (dsferruzza)
documentation
https://docs.rs/actix-web-middleware-keycloak-auth
README
actix-web-middleware-keycloak-auth
A middleware for Actix Web that handles authentication with a JWT emitted by Keycloak.
Features
- Actix Web middleware
- deny HTTP requests that do not provide a valid JWT (or choose to allow them and handle the authentication state from a following middleware)
- require one or several Keycloak realm or client roles to be included in the JWT
- error HTTP responses sent from the middleware can have generic bodies as well as detailed error reasons
- access JWT claims from handlers (for example: get the ID of the authenticated user)
- parse custom JWT claims (using Serde)
- access parsed roles from handlers (every Keycloak role contained in the JWT)
- compatible with paperclip using the
paperclip_compatfeature - store auth status in request-local data instead of returning a HTTP response (so that the next middleware/handler can try another auth mechanism, for example)
Usage
License
MIT License Copyright (c) 2020 David Sferruzza