guard/src/manager/api/inventory/nodes.rs
loki5512344 e456cb583f
feat(manager): SCAN inventory, pagination, request limits, graceful shutdown
- Inventory nodes/servers use cursor SCAN plus MGET batches instead of KEYS
  and per-key GET; a Redis error returns 503 instead of an empty fleet.
- GET /blacklist no longer writes: the legacy metadata backfill moved to a
  one-shot startup task. The list endpoint paginates (limit 100, max 1000,
  offset max 10000) instead of dumping SMEMBERS.
- Router-wide DefaultBodyLimit 8 KiB and TimeoutLayer 10 s; every mutating
  endpoint is rate limited (30/min per client IP) with idle eviction, and the
  login limiter resets on success. reason > 256 bytes and malformed targets
  are rejected with 400.
- SIGTERM/Ctrl-C trigger graceful shutdown; the heartbeat and eviction tasks
  are cancelled and joined so in-flight ban edits reach Redis.
- MANAGER_TRUSTED_PROXIES enables X-Forwarded-For (right-to-left walk) only
  for configured proxy networks; otherwise the TCP peer is used.
- tests/manager_api.rs covers 401/400/413/429/503 and CORS preflight through
  the real router; manager_security gains limiter and proxy-IP tests.
2026-11-16 12:36:29 +01:00

49 lines
1.3 KiB
Rust

//! `GET /api/v1/nodes`: registered edge nodes from the Redis heartbeat keys.
#[cfg(feature = "store-redis")]
use crate::manager::AppState;
#[cfg(feature = "store-redis")]
use axum::{Json, extract::State, http::StatusCode};
use serde::{Deserialize, Serialize};
#[cfg(feature = "store-redis")]
use std::sync::Arc;
/// SCAN pattern of node records.
#[cfg(feature = "store-redis")]
const NODES_PATTERN: &str = "rampart:nodes:*";
#[derive(Debug, Serialize, Deserialize)]
pub struct NodeInfo {
pub id: String,
pub role: String,
pub ip: String,
pub status: String,
pub last_heartbeat: String,
}
#[derive(Serialize)]
pub struct NodesResponse {
pub nodes: Vec<NodeInfo>,
}
/// Lists the fleet with SSCAN-style iteration and batched reads.
///
/// # Errors
/// Returns 503 when Redis is unreachable or a command fails; an empty `nodes`
/// array then always means a healthy but empty fleet.
#[cfg(feature = "store-redis")]
pub async fn list_nodes(
State(state): State<Arc<AppState>>,
) -> Result<Json<NodesResponse>, (StatusCode, Json<serde_json::Value>)> {
let mut conn = state
.redis_client
.get_multiplexed_async_connection()
.await
.map_err(|error| super::unavailable(&error))?;
let values = super::scan_values(&mut conn, NODES_PATTERN)
.await
.map_err(|error| super::unavailable(&error))?;
Ok(Json(NodesResponse {
nodes: super::decode_all(&values),
}))
}