Если уведомление пришло от неправильной компании, сначала остановите именно проблемный тип отправки и сохраните один `notification_id` для расследования. Не исправляйте название массовой заменой шаблона: адресат, ссылка, логотип и данные заказа могли смешаться по той же причине, а это уже риск утечки между арендаторами.
Чаще всего письмо формирует фоновый worker, который больше не видит исходную авторизацию. Он берёт `currentTenant` из глобального объекта, кеш без tenant-префикса или соединение PostgreSQL с контекстом предыдущей задачи. Надёжная граница проще: сервер подтверждает membership пользователя, записывает `tenant_id` в событие, а каждый следующий компонент считает его обязательной частью задания.
Сначала восстановите путь одного уведомления
| Точка | Что найти по notification_id | Красный флаг |
|---|---|---|
| бизнес-событие | subject_id, tenant_id, actor_id | tenant_id взят из заголовка клиента |
| outbox или очередь | tenant_id, recipient_id, template_key | tenant_id отсутствует и будет вычислен позже |
| worker | tenant до начала транзакции | используется глобальный currentTenant |
| render | brand_id, locale, template version | кеш ключуется только template_key |
| send provider | получатель, sender/domain, metadata | отправитель выбран из последней активной компании |
Сравните значения на всех пяти точках, не копируя в тикет полные адреса, токены и текст уведомления. Достаточно внутренних идентификаторов и хешированного адресата. Если tenant меняется уже в outbox, ошибка до очереди. Если событие верно, а бренд чужой, расследуйте worker, кеш шаблонов и повторно используемое соединение.
Tenant выбирает сервер, а не поле запроса
OWASP рекомендует устанавливать tenant context как можно раньше из сервером проверенной identity и membership. Заголовок `X-Tenant-ID`, query-параметр или значение из формы может быть только селектором: сервер обязан подтвердить, что пользователь состоит в этой компании и имеет право выполнить действие. Иначе исправление очереди оставит прямой путь к чужим данным.
function createInvoiceNotification(user, requestedTenant, invoiceId) {
membership = memberships.requireActive(user.id, requestedTenant)
invoice = invoices.requireOwned(invoiceId, membership.tenantId)
transaction(() => {
outbox.insert({
eventId: uuid(),
tenantId: membership.tenantId,
recipientId: invoice.ownerId,
templateKey: 'invoice_ready',
subjectId: invoice.id,
brandVersion: brands.currentVersion(membership.tenantId)
})
})
}В очереди хранится стабильный идентификатор арендатора, а не название компании. Название и логотип можно получить по `tenant_id`, но полезно зафиксировать версию бренда: повторная отправка тогда воспроизводима, а смена оформления не превращает старое событие в визуально другое сообщение.
Worker открывает tenant context на одну задачу
Процесс worker живёт долго и обрабатывает компании по очереди, поэтому контекст нельзя держать в singleton, статической переменной или thread-local без гарантированного сброса. Создавайте scope из payload, начинайте транзакцию, устанавливайте контекст и обязательно завершайте scope в `finally`. Следующая задача должна начинаться с пустого состояния.
async function handle(job) {
const scope = tenantScope.open(job.tenantId)
try {
await db.transaction(async (tx) => {
await tx.query('set local app.tenant_id = $1', [job.tenantId])
const recipient = await recipients.requireOwned(tx, job.recipientId)
const brand = await brands.requireOwned(tx, job.tenantId, job.brandVersion)
assert(recipient.tenantId === job.tenantId)
await renderAndSend(tx, job, recipient, brand)
})
} finally {
scope.close()
}
}`SET LOCAL` действует внутри текущей транзакции и меньше рискует протечь через пул соединений, чем session-level `SET`. Но одной настройки мало: политики RLS должны читать тот же контекст, приложение не должно работать под superuser или ролью с `BYPASSRLS`, а владелец таблицы обычно обходит RLS, если не включён `FORCE ROW LEVEL SECURITY`.
RLS страхует запрос, но не исправляет чужой кеш
PostgreSQL применяет row-level policies к обычным запросам; при включённом RLS без подходящей policy действует default deny. Это полезная последняя граница, однако шаблон мог попасть из Redis ещё до SQL. Каждый ключ кеша и object storage должен включать tenant либо ссылаться на публичный неизменяемый объект.
- Ключ бренда: `tenant:{tenant_id}:brand:{version}`, а не просто `brand:current`.
- Ключ шаблона: tenant, locale, channel и version; сброс выполняется в том же пространстве ключей.
- Ссылка в сообщении собирается из разрешённого домена компании, а не из Host фоновой задачи.
- Получатель повторно проверяется на принадлежность tenant непосредственно перед отправкой.
- Метрики и логи содержат tenant_id и event_id, но не email, телефон, токен и тело письма.
Инвариант перед send блокирует самый опасный исход
Добавьте последнюю проверку на границе внешнего провайдера: tenant задания, получателя, бренда и бизнес-объекта должны совпадать. При несовпадении сообщение не отправляется, задача уходит в карантин без автоматического бесконечного retry, а команда получает сигнал с безопасными идентификаторами. Это не замена правильной модели доступа, а предохранитель от утечки.
| Проверка | При несовпадении | Что измерять |
|---|---|---|
| job.tenant = recipient.tenant | quarantine | tenant_mismatch_total |
| job.tenant = subject.tenant | quarantine | subject_scope_error_total |
| job.tenant = brand.tenant | quarantine | brand_scope_error_total |
| domain разрешён tenant | не строить ссылку | invalid_tenant_domain_total |
Тест A → B ловит протечку через пул
- Создать компании A и B с заметно разными брендами, доменами и получателями.
- Одним экземпляром worker и пулом из одного соединения обработать событие A, затем B, затем снова A.
- После каждой задачи проверить tenant контекст соединения и убедиться, что вне транзакции он пуст.
- Одновременно прогнать A и B, чтобы обнаружить глобальную переменную или общий временный файл.
- Попросить задачу A прочитать recipient, subject и brand компании B; все запросы должны завершиться отказом.
- Повторить отправку одного event_id: внешний эффект создаётся один раз и сохраняет исходный tenant.
- Проверить письмо целиком: From, Reply-To, логотип, ссылки, название, unsubscribe и tracking metadata.
После исправления не ограничивайтесь тестовым письмом из панели. Нужен прогон реального пути через outbox и тот же worker, что работает в production. Для разбора инцидента сохраните timeline, затронутые tenant и поля, причину, защитные меры и способ доказать отсутствие новых пересечений. Возобновлять массовую отправку безопасно после нулевых mismatch-метрик и успешного A → B теста на общей инфраструктуре.