← Все статьи

Bitrix24 / ЁШКИНKOD

Безопасная интеграция с REST API Битрикс24

Практика для вебхуков и приложений Bitrix24: минимальные права, хранение токенов, журнал, повторы и персональные данные.

Интеграция получает доступ к клиентам, сделкам и иногда документам. Ошибка в хранении вебхука или слишком широкие права способны превратить удобную автоматизацию в риск для бизнеса. Безопасность нужно проектировать вместе с функциональностью.

Давайте только необходимые права

Разделите входящий и исходящий обмен, используйте отдельные учётные данные для каждого сервиса и не включайте лишние области доступа. Не размещайте токен в браузерном JavaScript, публичном репозитории или письме с логами. Храните секреты в серверной конфигурации и предусмотрите их замену.

Проверяйте входящие события

Входящий запрос должен проходить проверку подлинности и ограничение нагрузки. События могут приходить повторно или не по порядку, поэтому сохраняйте ID обработки и сверяйте актуальное состояние сущности. Логируйте код ответа и технический идентификатор, но не печатайте полные персональные данные и токены.

План на случай сбоя

Определите, какие операции можно повторять автоматически, а какие требуют вмешательства. Настройте резервное копирование и сигнал при росте ошибок. Периодически проверяйте не только успешные тестовые запросы, но и отозванные права, тайм-ауты и изменение обязательных полей. Для аудита опишите вашу связку без передачи секретов в форме.

NEW PROJECT / STARTHELLO, WORLD_

Ну что, создадим что-то крутое?

Оставьте контакт и пару слов о задаче. Начнём с разговора.