Скрытый товар в поиске — инцидент видимости, а не только ошибка релевантности. Временно отключите проблемную поверхность или добавьте серверный deny для неподтверждённых статусов, зафиксируйте document ID и пути ответа, затем инвалидируйте только доказанно затронутые кеши. Не удаляйте документ до сохранения причинного следа.

Фильтр в основном search query не закрывает autocomplete, mget, карточку по ID, рекомендации и заранее рассчитанные facets. Защита должна жить на каждом серверном пути чтения либо на уровне роли Elasticsearch. Параметр tenant_id или include_hidden из браузера нельзя считать доверенным.

Карта утечки начинается с одной роли

ПоверхностьКак проявляетсяЧто проверить
Основная выдачаКарточка есть среди hitsbool.filter и фактический index/alias
Autocomplete/suggestНазвание видно до EnterОтдельный endpoint и его источник
Facet/aggregationСчётчик раскрывает категориюФильтр applied до aggregation
Get/mget по IDДокумент открывается напрямуюPrivilege и серверная проверка eligibility
РекомендацииСкрытый ID приходит из offline listФильтрация после candidate generation
Кеш/CDNСтарый ответ остаётся после скрытияCache key, tags и purge result
ЭкспортЧерновик попадает в CSV/feedОтдельная query и service identity

Тестируйте тем же credential и маршрутом, которыми пользуется клиент. Успешный запрос из Kibana под администратором не воспроизводит права анонимного API. В журнале полезны authenticated subject, role, target index/alias, normalized query hash и набор применённых policy-фильтров без текста приватного товара.

Eligibility описывается как проверяемый контракт

POST catalog-read/_search
{
  "query": {
    "bool": {
      "must": [
        { "multi_match": { "query": "поисковая фраза", "fields": ["title^3", "description"] } }
      ],
      "filter": [
        { "term": { "tenant_id": "tenant-from-server-context" } },
        { "term": { "visibility": "public" } },
        { "term": { "publication_state": "published" } },
        { "range": { "publish_at": { "lte": "now" } } }
      ]
    }
  }
}

Это иллюстрация бизнес-фильтра. Реальные поля и правила задаёт каталог: канал продаж, регион, embargo, срок публикации, tenant и soft delete. Значение tenant берётся из проверенной server-side identity, а не из JSON клиента. Тот же контракт используют suggest, aggregation и recommendations finalizer.

Бизнес-видимость и авторизация решают разные задачи

Статус published отвечает, должен ли объект участвовать в витрине. Авторизация отвечает, имеет ли субъект право читать документ вообще. Если скрытие защищает чужой tenant, закупочную цену или закрытый ассортимент, одного query-фильтра приложения мало: credential Elasticsearch должен иметь только необходимый index scope, а document-level security может ограничивать документы внутри индекса.

  • Отдельная server identity получает минимальные read-привилегии на конкретные индексы или aliases.
  • Document-level rule строится из доверенной identity и проверяется отдельно для каждой роли.
  • Права нескольких ролей объединяются; широкая роль может расширить доступ, поэтому проверяйте итоговый набор.
  • Административный поиск и публичная витрина используют разные credentials и endpoints.
  • Прямой доступ к Elasticsearch из браузера не выдаётся.
  • Логи и трассировка не должны включать закрытое содержимое hits.

Elastic прямо предупреждает: filtered aliases нельзя использовать вместо document-level security. Alias filter применяется не ко всем способам чтения; например, прямое получение документа по ID имеет отдельные ограничения. Кроме того, DLS имеет функциональные и лицензионные условия — их проверяют для своей версии и подписки до проектирования.

Индекс обновляется как проекция, а не источник истины

Когда товар скрыли в основной БД, изменение должно попасть в индекс с наблюдаемым revision. Возможны два дизайна: оставить документ со статусом и фильтровать или удалить его из публичного индекса. Первый облегчает повторную публикацию, второй уменьшает поверхность случайной выдачи. В обоих случаях событие должно быть идемпотентным и сравнивать version, чтобы запоздалый update не воскресил старый статус.

СостояниеДействие индексатораКонтроль
Draft → publishedUpsert публичной проекцииRevision и publish_at
Published → hiddenUpdate visibility или delete из public indexПоиск и get больше не возвращают
Tenant изменёнУдалить старую проекцию, создать новуюНет окна двойной доступности
События пришли не по порядкуИгнорировать меньшую revisionМетрика stale events
ReindexПисать новый index и переключить aliasОбе версии используют одну policy
Сбой обновленияRetry/DLQ без публикации наружуLag и oldest failed event

После исправления не делайте бесконтрольный purge всего CDN: сначала выясните cache key и затронутые варианты tenant, locale и роли. Кеш публичной выдачи не должен переиспользоваться для административного ответа. Версия policy и каталога в ключе делает переход проверяемым.

Негативная матрица доказывает отсутствие утечки

  1. Создать синтетические товары: public, draft, scheduled, hidden, deleted и товар другого tenant.
  2. Проверить anonymous, обычного пользователя, редактора своего tenant и администратора.
  3. Для каждой пары пройти search, suggest, aggregation, get/mget, recommendation и export.
  4. Повторить после прогрева кеша и после смены hidden → public → hidden.
  5. Запустить reindex и убедиться, что переключение alias не открывает более широкий набор.
  6. Проверить, что запрещённый документ не появляется в counts, highlights и логах ответа.

Ожидаемый результат записывается до теста. Для запрещённых сочетаний безопаснее одинаковый внешний ответ без подтверждения существования объекта, если продукт не требует иного. Метрика «ноль скрытых hits» полезна только вместе с synthetic probes: пустой счётчик может означать сломанный мониторинг.

Перед выпуском нужен один владелец политики

Закрепите eligibility как общий модуль или gateway contract с владельцем, версией и changelog. Команды search, каталог и security согласуют значения статусов и исключений; иначе каждый endpoint снова реализует собственную трактовку «скрыт».

Для расследования подготовьте роль пользователя, target index/alias, mapping полей видимости, обезличенный document ID, запросы всех поверхностей, revision события, lag индексатора и cache headers. Не прикладывайте описание и цены закрытого товара туда, где у участников нет права их видеть.

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