Skip to content

Free, Open Source, Self-Hosted WhatsApp API Gateway

docs(env): say a shed ingress request still spends the IP bucket

Yudhi Armyndhariseffa46776327
diff --git a/.env.example b/.env.example
index 38dc0be1f..e49ffcf2c 100644
--- a/.env.example
+++ b/.env.example
@@ -711,15 +711,18 @@ WEBHOOK_SSRF_PROTECT=true
# Per-instance fairness cap on the Integration Fabric ingress route (POST /api/ingress/:pluginId/:instanceId/*).
# Providers deliver every tenant's webhooks from one shared egress IP, so this is keyed on
-# (pluginId, instanceId) instead of IP — a noisy tenant gets 429'd without throttling its neighbors.
+# (pluginId, instanceId) instead of IP, so a noisy tenant gets 429'd on this bucket without spending
+# its neighbors'.
# The global RATE_LIMIT_* tiers above skip this route; it is bounded only by this limit and INGRESS_IP_LIMIT below.
# Counted only for deliveries that pass signature verification; requests that fail it count against
# INGRESS_IP_LIMIT alone. A scheme 'none' route (ALLOW_UNSIGNED_INGRESS=true) passes every request.
# INGRESS_INSTANCE_LIMIT=120 # max requests per instance per window (default 120)
# INGRESS_INSTANCE_TTL=60000 # window in ms (default 60000 = 60s)
# Second bucket on the same window, keyed on the client instead of the path. It is checked before
-# anything else, so it is the only bound on requests that fail verification. Sized 10x the per-instance
-# default so it never binds before it, raise it if one IP legitimately drives more than that.
+# anything else, so it is the only bound on requests that fail verification. Every ingress request
+# counts against it, including one the per-instance bucket then sheds, so a tenant that pushes a shared
+# provider IP past it sheds its neighbors on that IP too. Sized 10x the per-instance default; raise it
+# for a high-volume provider that delivers many tenants from one egress IP.
# INGRESS_IP_LIMIT=1200 # max ingress requests per client IP per window (default 1200)
# Integration Fabric delivery retry + retention (the queued path taken when QUEUE_ENABLED=true).