> ## Documentation Index
> Fetch the complete documentation index at: https://veriqa.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Лимиты запросов под ваш трафик

> Как подобрать лимиты запросов Veriqa под ваше число пользователей: значения для сайта на 1000 человек и правило пересчёта.

Ядро Veriqa ограничивает число запросов к своим публичным маршрутам: маршруты разбиты на бакеты, и у
каждого бакета свой лимит. Значения по умолчанию рассчитаны на сайт, которым пользуются 1000 человек. Если пользователей больше или меньше, умножьте
лимиты на поправочный коэффициент N / 1000, где N — число ваших пользователей.

Лимит защищает доступность сервиса: исчерпанный бакет отвечает `429` каждому, кто пришёл после, до
конца окна. Поэтому лимит подбирают так, чтобы он выдержал пиковую минуту вашего трафика. Лимит по
IP клиента ядро не ставит — его настраивают на краю сети (см.
[Подготовка к продакшну](https://veriqa.app/docs/ru/guides/hardening.md#rate-limiting-и-anti-abuse)).

## Из чего получены значения

* **Пик — 100 входов в минуту.** Каждый из 1000 пользователей входит 1–2 раза в день, и в среднем на
  весь сайт приходится 1–2 входа в минуту. Расчётный пик — 10 % пользователей за одну минуту,
  например в начале рабочего дня.
* **Весь пик — через один канал.** Бакет без ключа один на инстанс и должен выдержать весь пик.
  Бакет канала рассчитан так, будто через этот канал входят все.
* **Подтверждений в пиковую минуту столько же, сколько входов.**
* **Запас ×2** — на перезагрузки страниц и повторные запросы.
* **Окно — 60 секунд** у всех бакетов.

Лимит = 100 × запросов на один вход × 2, с округлением.

## Лимиты для 1000 пользователей

Пути указаны от корня Veriqa; если задан `Veriqa:PathBase`, перед ними стоит этот префикс. Лимиты
задают ключи секции `Veriqa:RateLimit`, окно каждого бакета — парный ключ `…WindowSeconds`.

| Бакет | Маршруты | Счёт ведётся | Запросов на вход | Лимит за 60 с | Ключ в `Veriqa:RateLimit` |
| - | - | - | - | - | - |
| `authorize` | `/connect/authorize` | на инстанс | 1 | 200 | `AuthorizePermitLimit` |
| `callback` | `/connect/authorize/callback` и действия страницы входа под этим адресом, `/auth/claims` | на инстанс | 1 | 200 | `CallbackPermitLimit` |
| `token` | `POST /connect/token` | на инстанс | 1 и обновления токенов — около 17 в минуту при 1000 сессий и access-токене на час | 250 | `TokenPermitLimit` |
| `signalr` | `/hubs/auth` | на инстанс, скользящее окно | 2: согласование и подключение | 400 | `SignalRPermitLimit` |
| `polling` | `GET /api/transaction/{id}/status` | на инстанс | до 10 при входе в hop-режиме: страница на телефоне спрашивает статус раз в 3 секунды. На компьютере опрос нужен, только когда не работает SignalR | 2000 | `PollingPermitLimit` |
| `webhook` | `/api/channels/{channel}/webhook` и `/api/channels/{channel}/webhook/{tenant}` | на сегмент тенанта | 2–3 обновления платформы на вход через мессенджер | 600 | `WebhookPermitLimit` |
| `email-start` | `/auth/email/start` (форма и отправка письма), `POST /auth/email/code` | на инстанс | 3 | 600 | `EmailStartPermitLimit` |
| `web-provider-pages` | `/auth/web-provider/{channel}/start`, `…/callback`, `…/answer`, `…/press` | на инстанс | 3–4 | 800 | `WebProviderPagesPermitLimit` |
| `email-link-pages` | `/auth/email/confirm`, `/auth/email/claim` | на инстанс | 2: открыть ссылку и подтвердить | 400 | `EmailLinkPagesPermitLimit` |
| `confirmation-pages` | `/auth/transaction`, `/auth/transaction/confirm` с ответами, `/auth/transaction/cancel` | на инстанс | 3–4 на подтверждение | 800 | `ConfirmationPagesPermitLimit` |
| `hop-resolve` | `GET /r/{hop_token}` | на инстанс | 1–2: второй раз — после перевыпуска QR-кода | 400 | `HopResolvePermitLimit` |
| `hop-signal` | `POST /r/{hop_token}` | на инстанс | до 2 | 400 | `HopSignalPermitLimit` |
| `confirmation-create` | `POST /api/transaction/confirmation` | на RP | 1 на подтверждение | 200 | `ConfirmationCreatePermitLimit` |
| `confirmation-result` | `GET /api/transaction/{id}/result`, `POST /api/link-handle/redeem` | на RP | 1–2: зависит от того, как RP читает результат | 400 | `ConfirmationResultPermitLimit` |
| `user-auth` | попытки входа одного пользователя канала | на пользователя канала | — | 5 | `UserAuthPermitLimit` |

Маршруты `/r/…` существуют, только когда включён [hop-режим](https://veriqa.app/docs/ru/reference/configuration.md#veriqahopmode);
префикс задаёт `Veriqa:HopMode:HopPath`.

`email-start` считает запросы, а не письма: 600 запросов в минуту на инстанс — это около 200 входов через
Email, по три запроса на каждый. Письма на один адрес
ограничены отдельно: `SignInMailsPerAddress` (5 в час) и `MailResendInterval` (30 секунд на
транзакцию), см. [Повторная отправка письма](https://veriqa.app/docs/ru/guides/channels.md#повторная-отправка-письма).

## Пересчёт под ваше число пользователей

Поправочный коэффициент — N / 1000. Умножьте на него лимиты всех бакетов, кроме `user-auth`: этот
лимит считает попытки входа одного пользователя и от размера сайта не зависит.

* **Другая доля пиковой минуты.** Если в самую нагруженную минуту у вас входит не 10 % пользователей,
  считайте коэффициент от пика: P / 100, где P — число входов в эту минуту.
* **Бакеты на RP.** `confirmation-create` и `confirmation-result` считаются отдельно для каждого RP,
  поэтому их коэффициент берут от пика подтверждений одного RP.
* **Несколько инстансов.** Каждый инстанс считает свои запросы сам. При равномерной балансировке на
  каждый приходится своя доля пика, и лимит одного инстанса можно разделить на их число.

## Примеры

**Сайт на 10 000 пользователей.** Коэффициент 10: `authorize` — 2000, `token` — 2500,
`web-provider-pages` — 8000. `user-auth` остаётся 5. Лимиты остальных бакетов умножаются так же, в
примере показаны четыре из них.

```json appsettings.json theme={null}
{
  "Veriqa": {
    "RateLimit": {
      "AuthorizePermitLimit": 2000,
      "CallbackPermitLimit": 2000,
      "TokenPermitLimit": 2500,
      "WebProviderPagesPermitLimit": 8000
    }
  }
}
```

**Внутренний портал на 200 сотрудников.** Коэффициент 0,2: `authorize` — 40, `token` — 50,
`email-start` — 120. Значения по умолчанию такой портал тоже выдержит, но запас на 1000 пользователей
ему не нужен: меньший лимит `email-start` ограничивает, сколько писем уйдёт за минуту, если на форму
Email пойдёт поток запросов.

**1000 сотрудников, смена начинается в одно время.** Если в первую минуту смены входят 300 человек,
коэффициент считают от пика: 300 / 100 = 3. `authorize` и `callback` — по 600, `signalr` — 1200.

## Где задаются лимиты

Лимиты читаются только из глобальной секции `Veriqa:RateLimit` конфигурации хоста: для тенанта или
отдельного клиента их не переопределить. Полный перечень ключей и их значения по умолчанию приведены в
[справочнике конфигурации](https://veriqa.app/docs/ru/reference/configuration.md#veriqaratelimit).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.