guard/src/cli/commands/blacklist.rs
loki5512344 a8a3057719
feat(xdp): IPv6 UDP rate limit, working loader; English comments and docs
XDP behaviour:
- udp_rate_limit6 (LRU, full 128-bit source key) plus throttle_hit6, so
  udp_policy = "rate-limit" applies to native IPv6 as well.
- scripts/xdp_ipv6_smoke.sh: phase 4 patches .rodata before load and
  verifies policy=2 on a real kernel (3 pass / 3 rate-limited).

Loader (XDP could never load before this):
- .rodata is one struct rampart_config with frozen offsets enforced by
  _Static_assert; XdpGlobals is #[repr(C)] and the image is built with
  offset_of!. Before, a 96-byte image was written into a 76-byte map at
  offsets clang had reordered, so load() failed with EINVAL.
- patch_rodata fails loudly when the map size and image size diverge.
- build.rs tracks xdp/core and xdp/hooks, not just universal_filter.c.
- build_ringbuf looked for "events_map"; the map is "events_ringbuf".
- tests/xdp_object_maps.rs checks map names and .rodata size without root.

Docs and style:
- Code comments are English, JavaDoc/Rustdoc style, without emoji or
  banners (new project rule, TODO §0.8).
- README rewritten bilingual: Russian first, English below, nav buttons,
  compact TOC and copy-paste quick start.
- docs/README.md: documentation index and maintenance rules;
  configuration.md documents the whole [xdp] section and IPv4/IPv6
  coverage; testing.md covers the real-kernel smoke; stale links removed.
2026-11-15 23:50:52 +01:00

101 lines
2.6 KiB
Rust

//! `blacklist` subcommands: manage the manager blacklist over its HTTP API.
use serde::Deserialize;
use serde::Serialize;
#[derive(Deserialize)]
struct AddResponse {
status: String,
target: String,
}
#[derive(Deserialize)]
struct BlacklistItem {
target: String,
reason: String,
}
#[derive(Deserialize)]
struct BlacklistResponse {
items: Vec<BlacklistItem>,
total: usize,
}
#[derive(Deserialize)]
struct LoginResponse {
token: String,
}
#[derive(Serialize)]
struct RemoveRequest<'a> {
target: &'a str,
}
async fn authenticated_client() -> anyhow::Result<(reqwest::Client, String, String)> {
let manager_url = std::env::var("RAMPART_MANAGER").unwrap_or_else(|_| "http://localhost:8080".to_string());
let password = std::env::var("RAMPART_API_PASSWORD")
.map_err(|_| anyhow::anyhow!("RAMPART_API_PASSWORD must be set to use the manager blacklist API"))?;
let client = reqwest::Client::new();
let response = client
.post(format!("{manager_url}/api/v1/auth/login"))
.json(&serde_json::json!({"password": password}))
.send()
.await?
.error_for_status()?;
let token = response.json::<LoginResponse>().await?.token;
Ok((client, manager_url, token))
}
pub async fn add(target: String, reason: Option<String>) -> anyhow::Result<()> {
let (client, manager_url, token) = authenticated_client().await?;
let body = serde_json::json!({
"target": target,
"type": "ip",
"reason": reason.unwrap_or_else(|| "manual".to_string()),
});
let resp = client
.post(format!("{manager_url}/api/v1/blacklist"))
.bearer_auth(token)
.json(&body)
.send()
.await?
.error_for_status()?
.json::<AddResponse>()
.await?;
println!("[OK] {}: {}", resp.status, resp.target);
Ok(())
}
pub async fn remove(target: String) -> anyhow::Result<()> {
let (client, manager_url, token) = authenticated_client().await?;
let response = client
.delete(format!("{manager_url}/api/v1/blacklist"))
.bearer_auth(token)
.json(&RemoveRequest { target: &target })
.send()
.await?
.error_for_status()?;
let result: serde_json::Value = response.json().await?;
println!("[OK] {}: {}", result["status"].as_str().unwrap_or("removed"), target);
Ok(())
}
pub async fn list() -> anyhow::Result<()> {
let (client, manager_url, token) = authenticated_client().await?;
let list = client
.get(format!("{manager_url}/api/v1/blacklist"))
.bearer_auth(token)
.send()
.await?
.error_for_status()?
.json::<BlacklistResponse>()
.await?;
println!("Blacklist ({} entries)", list.total);
println!("----------------------");
for item in &list.items {
println!(" {} ({})", item.target, item.reason);
}
Ok(())
}