Rate limits and how to reset them
ClientFence counts failed sign-ins, password resets, sign-ups, orders, invoice links and API calls, and refuses more than a set number in a short time. This page lists every limit and shows how to exempt an address, reset a counter and change a limit.
What a limited visitor sees
Section titled “What a limited visitor sees”| Where | What happens |
|---|---|
| Forms in the client area and the admin area (sign-in, sign-up, checkout, promo code, domain search, profile) | The message Rate limit exceeded. Please try again later. |
| A password reset request, or a sign-up with an email over its limit | The usual answer, but no email is sent and no account is made, so nobody can learn which emails have an account. ClientFence logs it. |
| Wrong two-factor codes or email PINs at sign-in | Too many wrong codes. Please try again later. or Too many wrong PINs. Please try again later. |
| A reset link, an email confirmation link or an invoice link opened too often | An error page with HTTP status 429 |
| The API | Code 429 with a Retry-After header: see API rate limits |
A signed-in client opening their own invoices is never limited.
The limits
Section titled “The limits”Counters are kept per visitor address, per account, per email or per invoice link. API limits refill gradually. The others count from the first request and start again when the time is up.
| Policy | What it covers | Limit | Per |
|---|---|---|---|
api_guest |
Calls to /api/guest/... |
100 a minute | Address |
api_authenticated_ip |
Calls to /api/client/... and /api/admin/... that are not signed in with a session, such as calls with an API key |
1,000 an hour | Address |
api_authenticated_account |
Calls of a signed-in staff member or client, including those the admin and client areas make | 1,000 an hour | Staff member or client |
api_login |
Failed staff and client sign-ins (password or passkey), and every acceptance of an invitation with an existing password | 10 an hour | Address |
client_password_reset_ip |
Client Forgot Password? requests | 10 an hour | Address |
client_password_reset_email |
Client Forgot Password? requests | 3 an hour | |
client_password_reset_confirm_ip |
Opening a client reset link, and coming back from Google sign-in | 20 a minute | Address |
client_password_reset_confirm_post_ip |
Saving a new password from a reset link, accepting an invitation, checking a two-factor code or email PIN at sign-in | 20 a minute | Address |
client_email_confirm_ip |
Opening an email confirmation link | 20 a minute | Address |
staff_password_reset_ip |
Staff Forgot your password? requests | 5 an hour | Address |
staff_password_reset_email |
Staff Forgot your password? requests | 3 an hour | |
staff_password_reset_confirm_ip |
Opening a staff reset link | 20 a minute | Address |
staff_password_reset_confirm_post_ip |
Saving a new staff password from the link | 20 a minute | Address |
client_signup |
New client accounts (sign-up form and Google) | 5 an hour | Address |
client_signup_email |
New client accounts | 5 an hour | |
guest_ticket_create |
Tickets from visitors who are not signed in | 3 an hour | Address |
order_generation_ip |
Placing an order (checkout) | 15 an hour | Address |
cart_promo_apply_ip |
Applying a promo code | 10 an hour | Address |
domain_lookup_ip |
Domain availability and transfer checks | 60 an hour | Address |
domain_lookup_batch_ip |
The further results of a multi-extension domain search | 180 an hour | Address |
invoice_get_ip, invoice_get_hash |
Opening an invoice by its link | 10 and 30 an hour | Address, invoice link |
invoice_payment_ip, invoice_payment_hash |
Choosing a payment method and paying from an invoice link | 10 an hour each | Address, invoice link |
invoice_details_ip, invoice_details_hash |
Payment instructions of manual methods, such as bank transfer, on an invoice link | 60 an hour each | Address, invoice link |
invoice_pdf_ip, invoice_pdf_hash |
Invoice PDF by its link | 10 an hour each | Address, invoice link |
quote_ip |
Accepting, declining or downloading a quote by its link | 30 an hour | Address |
client_email_verification_resend_ip, client_email_verification_resend_account |
Resending the email confirmation message | 30 and 3 an hour | Address, client |
client_email_resend_ip, client_email_resend_account |
Resending an email from the client’s email history, and sending a sign-in email PIN | 30 and 5 an hour | Address, account |
profile_password_change_ip |
Changing the password or sign-in email in a profile, and confirming the password for two-factor settings | 30 an hour | Address |
profile_password_change_account |
The same, plus wrong two-factor codes and wrong email PINs at sign-in | 5 an hour | Account |
Mail and DNS actions on a client’s hosting pages have their own limits per client and hour (for example 10 mailbox password changes). They show Too many changes in a short time. Please wait a while and try again. and cannot be changed or exempted.
Sign-in security has its own rules for failed sign-ins: see Sign-in security.
Exempt your own addresses
Section titled “Exempt your own addresses”- Go to Security → Settings and open the Access lists tab (Super Administrators only).
- Under Never rate limited, enter addresses or ranges, one per line, such as
203.0.113.10or198.51.100.0/24. - Select Save.
Requests from these addresses skip every limit in the table at once, with no reset needed. Use it for your office, a monitoring server or an integration that calls the API. Behind Cloudflare or another proxy, trust the proxy first, or every visitor has the proxy’s address.
Reset a counter
Section titled “Reset a counter”- Go to Security → Rate Limits. The list shows only addresses that are over a limit now, with the Policy and the Retry After time.
- Choose one:
- The reset button on a row clears that policy for that address.
- Reset IP clears every counter of the address you enter, even one not listed.
- Reset All clears every counter, including the email, account and invoice link counters that are never listed.
Resetting needs the Manage rate limits staff permission. See Investigate IP blocks and access for finding the cause first.
Invalidate cache (System → Settings → System, Cache tab) also clears every counter, since the
counters are kept in the cache: in the data folder’s cache folder (data/cache by default), or in Redis or Memcached when the
cache uses one.
Change a limit
Section titled “Change a limit”Limits are changed in config.php, under rate_limiter
(the configuration file). Name the policy and give only what you change:
'rate_limiter' => [ 'enabled' => true, 'whitelist_ips' => ['203.0.113.10'], 'policies' => [ 'order_generation_ip' => ['limit' => 30], 'client_signup' => ['limit' => 10, 'interval' => '1 day'], ],],interval takes values such as 60 seconds, 15 minutes, 1 hour or 1 day. whitelist_ips is
the Never rate limited list. 'enabled' => false turns every limit off and the Rate Limits
page warns Rate limiting is currently disabled in configuration. Keep it on: the limits slow down
password guessing and fake sign-ups.
Command line
Section titled “Command line”Run this from the ClientFence directory as the site user. It clears the cache, which also resets every rate limit counter.
php console.php cache:clear
