federation-broker

Per-org federation relay: receives k-anonymized, DP-noised pattern observations from tenant Dryade instances, aggregates them, and serves the top-K patterns back. Complements the federation client that lives in core/ee/federation/.

Routes

Mounted under /api/plugins/federation-broker/.

| Route | Method | Description | | ----------- | ------ | ---------------------------------------- | | /submit | POST | Tenant uploads {tenant_id, patterns, counts, epsilon}. | | /top-k | GET | Aggregated top-K patterns (k-anon gated).| | /health | GET | Broker status + counters. |

Configuration

| Env var | Required | Description | | -------------------------------- | -------- | ------------------------------------ | | FEDERATION_BROKER_K_THRESHOLD | no | Min distinct contributors (default 5).| | FEDERATION_BROKER_TOP_K | no | Max patterns returned (default 100). |

Status

Storage backend is in-memory (stub). Production deployment requires swapping to Postgres or Redis (see TODO in plugin.py).

Tier

enterprise