SMS request rate limiter
The rate at which SMS messages can be sent to any single recipient number is limited by the system, based on a moving average of the delay between consecutive requests. This functionality is characterised by four parameters, described below.
Example, based on the default settings: a user that requests five SMS OTP:s, to the same number, within a period of 2.5 minutes will be quarantined for a period of 10 minutes, after which the limiter is reset and the user can start requesting SMS OTP:s again.
The parameters are global and specified on the phenix-pipes module configuration, not on the valve configuration. Changes will affect all SMS valves.
Parameters
| Name |
Description |
Default value |
|---|---|---|
| request_interval_mean |
A lower bound for the moving average delay between consecutive requests, in seconds. |
30 |
| request_lookback |
The number of recent requests that are used to calculate the moving average. |
5 |
| request_quarantine_period |
If the average delay between requests in the lookback period drops below the lower bound, the recipient number will be quarantined for the period specified by this parameter, in seconds. After the quarantine period expires, the average delay calculation is reset. |
600 |
| request_limiter_disabled |
Disables the limiter function. |
false |