Практическое руководство · безопасность

Безопасность API для B2B-интеграций: что проверять

Контроль авторизации, подписи запросов, повторов, журналирования и ключей в B2B API-интеграциях.

Не полагайтесь на доверие к IP-адресу или секретному URL как на единственный контроль. Авторизация должна выполняться на сервере для каждого ресурса.
Практический план

Когда ERP, сайт, WMS и кабинеты партнёров обмениваются данными, ошибочная авторизация одного метода может затронуть сразу несколько организаций. Важно проверять не только API-ключ, но и принадлежность объекта, порядок операций, повторную доставку событий и корректное отключение доступа.

01. Составьте карту интеграций и данных

Этап проверки: составьте карту интеграций и данных.

  • Перечислите API, направления вызовов, роли систем и категории передаваемых документов или остатков.
  • Для каждого метода определите владельца, периодичность, потребителей и максимально допустимую задержку обработки.
  • Укажите, какие данные относятся к отдельному клиенту, складу, дилеру или юридическому лицу.
  • Результат: документирован список границ доверия между системами.

02. Укрепите идентификацию потребителей

Этап проверки: укрепите идентификацию потребителей.

  • Выдавайте разные учётные данные для каждой интеграции и окружения, исключив общий ключ для всех контрагентов.
  • Ограничивайте права токена нужными методами и объектами; задайте срок действия и процедуру отзыва.
  • Храните секреты в контролируемом хранилище, а не в URL, публичном репозитории или пользовательских логах.
  • Результат: компрометация одного соединения не открывает доступ ко всем партнёрам.

03. Проверяйте авторизацию объектов

Этап проверки: проверяйте авторизацию объектов.

  • На сервере проверяйте право вызывающей стороны читать или менять конкретный заказ, склад, цену либо файл.
  • Испытайте доступ к соседним ID, чужим контрагентам и операциям с повышенными привилегиями.
  • Валидируйте схему, типы, размеры и состояние бизнес-процесса независимо от клиентских проверок.
  • Результат: наличие правильного токена не позволяет работать с чужими сущностями.

04. Контролируйте повторы и целостность

Этап проверки: контролируйте повторы и целостность.

  • Для webhook применяйте проверяемую подпись и метку времени, ограничивая окно повторного использования запроса.
  • Используйте ключ идемпотентности для операций создания, чтобы сетевой повтор не породил двойной заказ или списание.
  • Согласуйте очереди повторов, лимиты запросов и маршрутизацию ошибочных сообщений в отдельный разбор.
  • Результат: ошибки связи не превращаются в дублирование бизнес-операций.

05. Создайте наблюдаемость без утечек

Этап проверки: создайте наблюдаемость без утечек.

  • Пишите журнал интеграционных событий с идентификатором запроса, системой-источником и техническим результатом.
  • Скрывайте токены, пароли, содержимое чувствительных документов и персональные данные в отладочных трассировках.
  • Настройте сигнал на всплеск отказов доступа, необычные объёмы чтения и рост повторных запросов.
  • Результат: аномалии заметны, но сами логи не становятся новым каналом утечки.

06. Проверьте отключение и восстановление

Этап проверки: проверьте отключение и восстановление.

  • Испытайте ротацию ключа без потери сообщений и отзыв доступа у бывшего интегратора.
  • Зафиксируйте процедуру безопасного повторного проигрывания очереди после сбоя с защитой от повторного применения.
  • Проведите приёмку на тестовых заказах разных клиентов и сохраните протокол контрольных результатов.
  • Результат: интеграция управляемо подключается, восстанавливается и выводится из эксплуатации.
Документы и первоисточники:

Редакционный материал, октябрь 2026 года. Проверяйте применимость методов к вашей конфигурации и действующим требованиям.