Валидный JWT отвечает только на вопрос «кто пришёл». Он не доказывает, что пользователь может вернуть чужой платёж, скачать документ другого tenant или изменить поле status. Закройте уязвимый маршрут и поставьте server-side проверку прав перед доступом к объекту и выполнением действия.

Не ограничивайтесь скрытием кнопки во frontend и непредсказуемым UUID. Клиент управляет path, body и query, поэтому API должно заново проверить каждый переданный идентификатор и каждое чувствительное поле.

Права ломаются на четырёх разных уровнях

УровеньПример ошибкиОбязательная проверка
ФункцияОбычный user вызывает admin exportРазрешено ли действие principal
ОбъектМеняется чужой invoice по IDДоступ к конкретному object и tenant
СвойствоUser передаёт role=admin в bodyAllowlist изменяемых fields
КонтекстДействие доступно после закрытия периодаСостояние объекта и policy conditions

OWASP называет отсутствие проверки доступа к объекту Broken Object Level Authorization: endpoint может быть доступен пользователю законно, но конкретный ID — нет. Отдельно проверяется function-level authorization, когда сам тип операции предназначен другой роли.

Решение принимается до бизнес-действия

principal = authenticate(request)
input = validate(request.body)
object = repository.findInTenant(input.id, principal.tenantId)

decision = authorize(principal, "invoice.refund", object)
if (!decision.allowed) return HTTP_403

result = refundService.execute(object, input.allowedFields)
audit.write(principal.id, "invoice.refund", object.id, decision.policyId)

Это псевдокод порядка, а не библиотека. Object lookup уже ограничен tenant, policy проверяет действие и состояние, а service получает только разрешённые поля. Не передавайте в ответ внутреннюю причину вроде «объект существует, но принадлежит другому клиенту», если это раскрывает наличие ресурса.

Scope token — вход в политику, а не вся политика

OAuth scope удобно ограничивает класс операций, но редко описывает владельца конкретной записи, договор или текущее состояние. RFC 6750 различает invalid_token с HTTP 401 и insufficient_scope с HTTP 403. После проверки scope всё равно нужны object- и tenant-level условия.

  • Проверять issuer, audience, signature и срок token в authentication layer.
  • Сопоставлять scopes с конкретными действиями API, а не с названием экрана.
  • Не доверять role или tenant из body, если они уже определены identity.
  • Делать deny результатом по умолчанию при отсутствии policy.
  • Не писать bearer token и чувствительные поля в audit log.

Фильтрация выборки снижает шанс пропустить проверку

Вместо findById(id) с последующим сравнением владельца используйте repository, который строит выборку в границах доступного tenant или subject. Это не отменяет policy для действия, но не позволяет случайно вернуть чужую строку до проверки. Административный обход оформляют отдельным явным разрешением и аудитом.

Для сложных правил удобно централизовать решение по атрибутам субъекта, объекта, операции и окружения. NIST описывает эту модель как ABAC. Централизация полезна только при versioned policy, тестах и понятном поведении при недоступности policy engine — для защищённой операции это обычно deny.

Отрицательные тесты важнее happy path

  1. Вызвать endpoint без token и проверить отказ до бизнес-логики.
  2. Повторить с валидным token без требуемого scope или роли.
  3. Подставить ID объекта другого пользователя того же tenant.
  4. Подставить объект другого tenant.
  5. Добавить запрещённое поле в корректный body.
  6. Повторить разрешённый запрос и проверить точную запись audit.

Тест должен проверять не только status code, но и отсутствие изменения в базе, внешнего события и различимого по времени ответа. Для batch endpoint проверяйте каждый элемент: разрешение на один ID не распространяется на соседние.

Исправление раскатывается с поиском прошлых обращений

После закрытия маршрута просмотрите audit и access logs за доступный период по действию, principal, tenant и object ID. Не объявляйте инцидент автоматически по одному 200: запрос мог быть законным. Подозрительные случаи передают владельцу процесса по процедуре реагирования, сохраняя минимально необходимые данные.

Что нужно для ревью доступа

Подготовьте route и method, схему identity, перечень scopes/roles, policy или middleware, модель владения объектом, пример разрешённого и запрещённого запроса без tokens, а также side effects операции. Это позволяет проверить полный путь, а не только наличие аннотации над controller.

Проверенные источники