Files
rustfs/crates/protocols/tests/swift_phase4_integration.rs
Zhengchao An c82ee6be58 feat(api): wire opt-in per-client S3 API rate limiting (429 + Retry-After) (#4895)
feat(api): wire opt-in per-client S3 API rate limiting (backlog#1191)

RustFS shipped three rate-limiter implementations and none was wired to
any request path: the tower layer never returned 429 (its over-limit
branch passed requests through) and was never instantiated, the console
env switches only logged, and the Swift token bucket was never called.

Replace them with one working, default-off implementation:

- Rewrite rustfs/src/server/rate_limit.rs as a sharded per-client-IP
  token-bucket limiter (32 mutex shards instead of one global RwLock
  write per request), bounded at 100k tracked IPs with lossless
  refilled-idle sweeps, returning 429 + Retry-After + x-ratelimit-*
  headers and an S3-style XML body.
- Key on trusted-proxy-validated ClientInfo.real_ip, else the socket
  peer address; never read spoofable X-Forwarded-For/X-Real-IP headers.
  Requests without a resolvable identity fail open. The echoed request
  id is charset-gated to prevent reflected XML injection.
- Wire the layer once at startup via option_layer between
  CatchPanicLayer and ReadinessGateLayer (external stack only), gated by
  new RUSTFS_API_RATE_LIMIT_ENABLE/_RPM/_BURST constants; health and
  profiling probes, internode RPC/gRPC, and the console are exempt.
- Make RUSTFS_CONSOLE_RATE_LIMIT_ENABLE/_RPM actually enforce by
  reusing the same limiter core through an axum middleware.
- Delete the dead Swift ratelimit module, its isolated tests, and the
  stale logging-guardrail entry; keep the live SwiftError 429 mapping.
- Add unit tests (exhaustion/recovery with injected time, concurrency,
  cap eviction, spoofed-header and fail-open behavior, env matrix) and
  e2e tests proving 429 + Retry-After on the real server and zero
  behavior change with default configuration.
2026-07-16 07:09:42 +00:00

47 lines
1.7 KiB
Rust

// Copyright 2024 RustFS Team
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//! Integration tests for Swift API Phase 4 features
//!
//! These tests validate the integration between different Swift API modules,
//! ensuring they work together correctly.
#[cfg(feature = "swift")]
mod swift_integration {
use rustfs_protocols::swift::*;
use std::collections::HashMap;
#[test]
fn test_phase4_modules_compile() {
// This test ensures all Phase 4 modules are properly integrated
// Actual integration test would require full runtime with storage
}
#[test]
fn test_symlink_with_expiration_metadata() {
let mut metadata = HashMap::new();
metadata.insert("x-object-symlink-target".to_string(), "original.txt".to_string());
metadata.insert("x-delete-at".to_string(), "1740000000".to_string());
// Both features should coexist in metadata
assert!(symlink::is_symlink(&metadata));
let target = symlink::get_symlink_target(&metadata).unwrap();
assert!(target.is_some());
let delete_at = metadata.get("x-delete-at").unwrap();
let parsed = expiration::parse_delete_at(delete_at).unwrap();
assert_eq!(parsed, 1740000000);
}
}