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.
This commit is contained in:
parent
324ef12b27
commit
e456cb583f
21 changed files with 1377 additions and 180 deletions
31
docs/api.md
31
docs/api.md
|
|
@ -64,6 +64,8 @@ Authorization: Bearer <token>
|
|||
|
||||
### `GET /api/v1/blacklist` 🔒
|
||||
|
||||
Query: `limit` (по умолчанию 100, максимум 1000) и `offset` (максимум 10000).
|
||||
|
||||
```json
|
||||
{
|
||||
"items": [
|
||||
|
|
@ -75,9 +77,16 @@ Authorization: Bearer <token>
|
|||
```
|
||||
|
||||
Источник: Redis set `rampart:blacklist` и hash `rampart:blacklist:metadata`.
|
||||
Записи читаются через `SSCAN` порциями, поэтому set никогда не выгружается целиком;
|
||||
порядок страниц не определён (Redis set) и при параллельных изменениях страницы
|
||||
могут пересекаться. `total` — размер set по `SCARD`, он может включать истёкшие
|
||||
записи, которые API скрывает в `items`.
|
||||
|
||||
Метаданные содержат причину, время создания и абсолютный срок истечения; API
|
||||
скрывает истёкшие записи. Старые set-записи без метаданных получают один
|
||||
ограниченный срок в пять минут при первом чтении или восстановлении edge.
|
||||
скрывает истёкшие записи. `GET` ничего не пишет в Redis: старые set-записи без
|
||||
метаданных показываются с временной записью «пять минут» только для чтения, а
|
||||
сама метаданные восстанавливаются одноразовым фоновым backfill при старте
|
||||
manager (или при восстановлении снимка edge).
|
||||
|
||||
### `POST /api/v1/blacklist` 🔒
|
||||
|
||||
|
|
@ -89,6 +98,9 @@ Authorization: Bearer <token>
|
|||
// с duration_secs и expires_at_unix опубликовано в rampart:blacklist:events.
|
||||
```
|
||||
|
||||
`target` — одиночный IPv4/IPv6-адрес (CIDR не поддерживается), `reason` — не
|
||||
длиннее 256 байт; иначе `400 Bad Request`.
|
||||
|
||||
Edge подписывается на Pub/Sub перед загрузкой снимка из Redis. Поэтому события,
|
||||
пришедшие во время загрузки, будут применены после снимка. При старте и после
|
||||
переподключения активные Redis-баны восстанавливаются с оставшимся TTL; новые
|
||||
|
|
@ -112,6 +124,9 @@ Edge подписывается на Pub/Sub перед загрузкой сн
|
|||
|
||||
Список зарегистрированных edge-нод из Redis (`rampart:nodes:*`, heartbeat).
|
||||
|
||||
Если Redis недоступен, API возвращает `503 Service Unavailable`; пустой массив
|
||||
означает исправное, но пустое окружение.
|
||||
|
||||
```json
|
||||
{
|
||||
"nodes": [
|
||||
|
|
@ -129,8 +144,16 @@ Edge подписывается на Pub/Sub перед загрузкой сн
|
|||
|
||||
- drain нод через API или CLI;
|
||||
- webhooks, metrics summary, challenge management;
|
||||
- регистрации нод через `POST /api/v1/nodes`;
|
||||
- rate limiting на сами запросы API (кроме login).
|
||||
- регистрации нод через `POST /api/v1/nodes`.
|
||||
|
||||
## Ограничения запросов
|
||||
|
||||
- Тело запроса — не больше 8 КиБ (`413`), любой запрос — не дольше 10 секунд.
|
||||
- `/api/v1/auth/login` — 5 попыток в минуту с одного клиентского адреса (`429`).
|
||||
- `POST`/`DELETE /api/v1/blacklist` (и любые будущие mutating-методы) — 30 запросов
|
||||
в минуту с одного клиентского адреса (`429`); успешный login сбрасывает счётчик.
|
||||
- Клиентский адрес — TCP peer, если запрос не пришёл с сети из
|
||||
`MANAGER_TRUSTED_PROXIES`; только тогда используется `X-Forwarded-For`.
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue