Идемпотентность API: защита от повторной оплаты и выполнения операции
Как обрабатывать повторы запроса без повторного эффекта: привязка idempotency key к пользователю, параметрам и атомарной записи результата.
Коротко о главном
- Чем опасно
- Повторное списание или создание дублирующего заказа.
- С чего начать защиту
- Связывайте ключ с пользователем, операцией и отпечатком существенных параметров.
- Как подтвердить
- Нужны ручной аудит и проверка реализации. Отсутствие находок во внешнем скане не подтверждает безопасность.
В этой статье
- Продукт
- Веб-приложения
- Оценка риска
- Уровень зависит от конфигурации
Как проверить и что учитывать
Нужна ручная проверка
Для подтверждения нужны анализ реализации и проверки на согласованном тестовом контуре. Публикация не означает автоматическое обнаружение этого сценария FindRisk. Не делайте вывод о наличии уязвимости только по одному внешнему признаку: подтвердите результат в настройках и версии компонента.
Что нужно для подтверждения
В тестовой среде повторите запрос последовательно и параллельно, затем смените параметры и пользователя. Проверьте единственность эффекта, стабильный результат повтора и корректное восстановление после сбоя.
Ограничения вывода
- Внешний ответ не раскрывает все роли, обработчики и настройки внутренних компонентов.
- Используйте только свои системы или письменное разрешение владельца; нагрузочные проверки согласуйте отдельно.
Что это за уязвимость
Повтор запроса после сетевой ошибки нормален. Для операции с побочным эффектом сервер должен отличать повтор от новой команды и не выполнять один подтверждённый запрос дважды.
Когда возникает риск
Одного ключа в заголовке недостаточно: неатомарная проверка допускает гонку, а общий ключ без владельца смешивает пользователей. Нужно определить срок хранения и поведение незавершённой операции.
Возможные последствия
Как обрабатывать повторы запроса без повторного эффекта: привязка idempotency key к пользователю, параметрам и атомарной записи результата.
- Повторное списание или создание дублирующего заказа.
- Выдача чужого результата при неверной области уникальности ключа.
Как защитить приложение
Исправляйте причину в обработчике, а не только внешний симптом.
- Связывайте ключ с пользователем, операцией и отпечатком существенных параметров.
- Атомарно регистрируйте выполнение и сохраняйте результат; другой payload с тем же ключом отклоняйте.
- Для внешних эффектов используйте согласованный механизм провайдера или надёжную очередь событий.
Как безопасно проверить исправление
В тестовой среде повторите запрос последовательно и параллельно, затем смените параметры и пользователя. Проверьте единственность эффекта, стабильный результат повтора и корректное восстановление после сбоя.
Оценка риска и границы сканирования
Средний уровень — ориентировочная редакционная оценка, не CVSS подтверждённой находки. Для конкретной системы приоритет зависит от доступных данных, полномочий и компенсирующих мер; последствия могут быть значительно серьёзнее.
Отсутствие находки во внешнем скане не доказывает безопасность реализации. Проверяйте сценарии после входа, альтернативные маршруты и внутренние сервисы.
Как проходит проверка
Для подтверждения нужны анализ реализации и проверки на согласованном тестовом контуре. Публикация не означает автоматическое обнаружение этого сценария FindRisk. Автоматический результат показывает внешний признак риска и требует проверки специалистом с учётом конкретной конфигурации.
Проверить другие внешние рискиЧто делать после обнаружения
- Зафиксируйте затронутый сценарий и сохраните журналы без токенов и персональных данных.
- Ограничьте проблемный обработчик, оцените доступные данные и назначьте владельца исправления.
- Устраните первопричину и добавьте регрессионную проверку на тестовых данных.
Частые вопросы
Что означает риск «Идемпотентность API»?
Как обрабатывать повторы запроса без повторного эффекта: привязка idempotency key к пользователю, параметрам и атомарной записи результата.
Можно ли подтвердить проблему только внешней проверкой?
Для подтверждения нужны анализ реализации и проверки на согласованном тестовом контуре. Публикация не означает автоматическое обнаружение этого сценария FindRisk. Итог нужно сопоставить с конфигурацией, версиями и правами доступа на вашем сайте.
Что сделать в первую очередь?
Связывайте ключ с пользователем, операцией и отпечатком существенных параметров.