Tide (http-rs/tide) JWT Authorization Middleware
This Rust library offers a middleware for the Tide web server framework, focusing on API key authentication via JWT (JSON Web Tokens) using the tide_jsonwebtoken crate.
Features
- Seamless API key validation using JWT.
- Direct integration with Tide routes.
- Efficient handling of protected and unprotected routes.
Quick Start
Add the required dependencies to your Cargo.toml:
[]
= "0.16" # Use the latest version
= "0.1.0" # Use the latest version
= { = "1.12.0", = ["attributes"] } # Use the latest version
Usage
-
Initialize the Middleware:
First, create an instance of the
ApiKeyMiddleware:let jwt = new; -
Set Up Tide Application:
Initialize the Tide application and apply the middleware to specific routes:
let mut app = new; app.at.get; app.at .with .get; -
Run the Server:
app.listen.await?;
Error Handling
The middleware inspects the x-api-key header in incoming requests. If the JWT is validated, the request continues; otherwise, the middleware returns a 401 Unauthorized status. Potential error messages include:
API key missing: The request lacks thex-api-keyheader.Invalid API key: The supplied API key (JWT) is not valid.
Contributing
Pull requests are encouraged. For major adjustments, kindly initiate an issue first to deliberate on the desired changes.