Получатель webhook должен выбирать проект по проверенной связи с источником: аккаунтом интеграции, установкой приложения или объектом провайдера. Поле project_id из произвольного запроса само по себе такой связью не является. Начните с двух тестовых проектов и таблицы принадлежности: один и тот же внешний идентификатор в разных аккаунтах не должен случайно вести к одному получателю.
Отдельный URL для каждого проекта может упростить конфигурацию, но адрес тоже не заменяет проверку отправителя и полномочий. Успешный результат — событие попадает только в разрешённый проект; неизвестная или противоречивая связь останавливает обработку до бизнес-действия.
Решение о получателе имеет собственные входы
| Вход маршрутизатора | Как его использовать | Опасное упрощение |
|---|---|---|
| Проверенная идентичность интеграции | Выбрать область внешних объектов | Довериться имени в JSON |
| Внешний account и object | Найти внутреннюю связь | Искать object без account |
| Тип события и действие | Выбрать разрешённый обработчик | Отправлять всё каждому проекту |
| Версия связи | Объяснить принятое решение | Незаметно менять адресата при повторе |
GitHub рекомендует проверять тип события и действие перед обработкой, а также использовать secret для валидации доставки. Документация проверена 16 октября 2026 года. Эти меры подтверждают происхождение и допустимый обработчик, но внутреннюю принадлежность вашему проекту всё равно определяет приложение. Правило ниже — архитектурная рекомендация, а не готовая функция провайдера.
Условный порядок решения:
verified_integration -> source_account
(source_account, external_object) -> project
allowed_event + unambiguous_binding -> saved_route
unknown_or_conflicting_binding -> quarantine
saved_route -> очередь конкретного проектаНеизвестный проект не получает значение по умолчанию
Если связь ещё не появилась, сохраните допустимое событие в ограниченном ожидании или отправьте на ручной разбор по принятой политике. Назначение первому проекту из списка создаёт тихую утечку данных. Различайте отсутствующую связь и временную недоступность справочника: у них разные причины, сроки и действия оператора. Никакой из этих исходов не разрешает угадывать получателя.
При переносе объекта между проектами зафиксируйте правило времени: применяется принадлежность на момент события, на момент приёма или текущее владение после отдельной сверки. Универсального ответа нет. Решение зависит от смысла события и доступной истории. Для финансового или правового эффекта спорный перенос требует отдельного согласования; обычная смена строки mapping не должна молча переадресовать старый повтор.
В журнал маршрута достаточно записать безопасные идентификаторы входа, версию правила, выбранный проект и причину отказа. Полный payload и ключ подписи в общую диагностику не нужны. Для очереди и фонового worker сохраните ту же доверенную принадлежность; если worker заново читает непроверенное поле tenant из тела, защита на HTTP-входе теряется.
Испытание включает заведомо чужое событие
- Отправить разрешённое событие проекта A и проверить единственного получателя.
- Повторить тест для B с совпадающим условным object_id в другой области источника.
- Передать неизвестную связь и убедиться в отсутствии бизнес-эффекта.
- Создать конфликт двух связей и проверить остановку с объяснимой причиной.
- Повторить ранее принятое событие после изменения mapping и сверить согласованное правило.
Ошибочный маршрут исправляют отдельно от последствий. Сначала остановите новые неверные назначения, затем найдите затронутые эффекты по сохранённым решениям. Повтор всей очереди без такого разбора способен ещё раз изменить данные соседнего проекта. Для проектирования подготовьте обезличенную таблицу account–object–project, список событий и правило переноса владения. По ним можно проверить границу доступа до подключения реальных клиентов.