Скрытый товар в поиске — инцидент видимости, а не только ошибка релевантности. Временно отключите проблемную поверхность или добавьте серверный deny для неподтверждённых статусов, зафиксируйте document ID и пути ответа, затем инвалидируйте только доказанно затронутые кеши. Не удаляйте документ до сохранения причинного следа.
Фильтр в основном search query не закрывает autocomplete, mget, карточку по ID, рекомендации и заранее рассчитанные facets. Защита должна жить на каждом серверном пути чтения либо на уровне роли Elasticsearch. Параметр tenant_id или include_hidden из браузера нельзя считать доверенным.
Карта утечки начинается с одной роли
| Поверхность | Как проявляется | Что проверить |
|---|---|---|
| Основная выдача | Карточка есть среди hits | bool.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 → published | Upsert публичной проекции | Revision и publish_at |
| Published → hidden | Update 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 и каталога в ключе делает переход проверяемым.
Негативная матрица доказывает отсутствие утечки
- Создать синтетические товары: public, draft, scheduled, hidden, deleted и товар другого tenant.
- Проверить anonymous, обычного пользователя, редактора своего tenant и администратора.
- Для каждой пары пройти search, suggest, aggregation, get/mget, recommendation и export.
- Повторить после прогрева кеша и после смены hidden → public → hidden.
- Запустить reindex и убедиться, что переключение alias не открывает более широкий набор.
- Проверить, что запрещённый документ не появляется в counts, highlights и логах ответа.
Ожидаемый результат записывается до теста. Для запрещённых сочетаний безопаснее одинаковый внешний ответ без подтверждения существования объекта, если продукт не требует иного. Метрика «ноль скрытых hits» полезна только вместе с synthetic probes: пустой счётчик может означать сломанный мониторинг.
Перед выпуском нужен один владелец политики
Закрепите eligibility как общий модуль или gateway contract с владельцем, версией и changelog. Команды search, каталог и security согласуют значения статусов и исключений; иначе каждый endpoint снова реализует собственную трактовку «скрыт».
Для расследования подготовьте роль пользователя, target index/alias, mapping полей видимости, обезличенный document ID, запросы всех поверхностей, revision события, lag индексатора и cache headers. Не прикладывайте описание и цены закрытого товара туда, где у участников нет права их видеть.