9 releases

new 0.2.2 Nov 21, 2024
0.2.1 Jul 23, 2024
0.1.6 Jul 22, 2024

#10 in #actix-web-middleware

39 downloads per month
Used in relay-mailer

MIT/Apache

13KB
165 lines

Actix Route Rate Limiter

A library crate that can be used to add rate limiting middleware to Actix Web Application routes.

use std::sync::Arc;
use actix_web::{web, App, HttpServer, HttpResponse};
use chrono::Duration;
use actix_route_rate_limiter::{LimiterBuilder, RateLimiter};

#[actix_web::main]
pub async fn main() -> std::io::Result<()> {

    // build a limiter
    let limiter = LimiterBuilder::new()
        .with_duration(Duration::seconds(20)) // default value is one second
        .with_num_requests(2) // default value is one request
        .build();


    HttpServer::new(move || {
        App::new()
            .wrap(RateLimiter::new(Arc::clone(&limiter)))
            .route("/", web::get().to(HttpResponse::Ok))
    })
        .bind(("0.0.0.0", 12345))?
        .run()
        .await
}

This crate can be used to wrap routes with rate limiting logic by defining a duration and number of requests that will be forwarded during that duration.

If a quantity of requests exceeds this amount, the middleware will short circuit the request and instead send an HTTP 429 - Too Many Requests response with headers describing the rate limit:

  • Retry-After : the rate-limiting duration, begins at first request received and ends after this elapsed time
  • X-RateLimit-Limit : number of requests allowed for the duration
  • X-RateLimit-Remaining : number of requests remaining for current duration
  • X-RateLimit-Reset : number of seconds remaining in the duration

Actix Web docs regarding App.wrap()

Dependencies

~16–27MB
~452K SLoC