Ресурсы · 63
HTTP-кэширование: защита персонализированных ответов
Разделите общий, частный и прикладной кэш, проверьте ключи, повторную проверку и аннулирование после изменения прав доступа.
Обновлено · 6 min
Чего помогает достичь это руководство
- Слои инвентаризации
- Выбор срока хранения
- Проверка ключей
- Повторная проверка и изменение
Быстрая проверка
- Означает ли отсутствие кэша, что ничего не сохраняется?
- Защищает ли Vary права доступа?
- Следует ли кэшировать каждый API?
Пошаговый метод
- 1
Слои инвентаризации
Перечислите кэши браузера, CDN, прокси, сервис-воркера и приложения. Классифицируйте публичные и персонализированные ответы. Политика HTTP не описывает автоматически кэширование, реализованное в коде.
Результат: диаграмма слоев и владельцев.
- 2
Выбор срока хранения
RFC 9111 различает директивы: no-cache требует проверки перед повторным использованием, no-store запрещает соответствующее хранилище HTTP, а unqualified private исключает общее хранилище. Ни одна из них сама по себе не гарантирует конфиденциальность системы.
Результат: политика хранения для каждого ответа.
- 3
Проверка ключей
Проверка метода, URI и измерений, изменяющих представление. Vary касается полей запроса; Это не авторизация. Необходимо проверить пропущенные языковые параметры, согласование формата и контекст учетной записи на уровне приложения.
Результат: ключи и тесты разделения.
- 4
Повторная проверка и изменение
Тестирование новых и устаревших ответов, обновлений данных и отозванных прав. Проверка ETag, условной проверки и поведения при недоступности источника. Ранее правильный ответ может стать конфиденциальным после отзыва.
Результат: трассировка до и после.
- 5
Воспроизведение с двумя учетными записями.
Использование вымышленных идентификаторов и маркеров. Чередование запросов к одному и тому же URI с использованием теплого и холодного кэша. Проверка выхода из системы, прямых ссылок и логирования без записи реальных токенов.
Результат: негативные тесты и стратегия аннулирования.
Измерять свежесть кэша наряду со скоростью
Вымышленный пример: данные не описывают клиента или наблюдаемый результат.
Ситуация
Два чтения быстрые, но одно показывает прежнюю доступность после изменения источника.
Проверка
Сравнить значение, версию, точку чтения и время после изменения. Проверить инвалидирование, истечение срока и обращение к источнику по контракту системы.
Действие
Определить допустимое устаревание для каждого применения и отслеживать расхождения. Малая задержка не доказывает согласованность выдаваемых данных.
Многоразовый рабочий лист
Заполните ваши авторизованные наблюдения. Эти поля являются рабочим шаблоном, а не наблюдаемыми результатами.
| Поле | Информация для записи |
|---|---|
| Реагирование | Общедоступный или персонализированный; Размеры |
| Слой | Кэш, владелец и ключ |
| Политика | Сохранение, актуальность и проверка |
| Пробный запуск | Вымышленный отчет, изменение и наблюдение |
Вымышленный пример
Иллюстративная ситуация
Вымышленный пример: CDN повторно использует ответ профиля по одному и тому же URI для двух тестовых учетных записей.
Решение и ожидаемые доказательства
В сценарии обнаруживается утечка, проверяется политика и ключи, затем воспроизведение происходит после исправления и отзыва доступа.
Различение механизмов
| Механизм | Назначение | Проверка или ограничение |
|---|---|---|
| no-cache | Разрешить хранение с обязательной проверкой | Не следует воспринимать это как отсутствие хранения |
| Неквалифицированное частное хранилище | Исключить общее кэширование | Не следует воспринимать это как гарантию конфиденциальности |
| no-store | Предотвратить соответствующее HTTP-хранилище | Проверять кэш и историю приложений отдельно |
Показатели управления
| Показатель | Что он измеряет | Первое действие |
|---|---|---|
| Разделение учетных записей | Нет метки от другой учетной записи | Проверить тело, ссылки и метаданные |
| Возраст и проверка | Повторное использование в соответствии с политикой | Проверить срок действия и недоступный источник |
| Задержка аннулирования | Время до исправления представления | Назвать каждый слой устаревшим |
Распространенные ошибки
- Не следует воспринимать это как отсутствие хранения
- Не следует воспринимать это как гарантию конфиденциальности
- Проверять кэш и историю приложений отдельно
Часто задаваемые вопросы
Означает ли отсутствие кэша, что ничего не сохраняется?
Нет. Требуется проверка перед повторным использованием; это не запрещает хранение, как это делает no-store.
Защищает ли Vary права доступа?
Нет. Он участвует в выборе представления; авторизация остается отдельной.
Следует ли кэшировать каждый API?
Нет. Преимущества зависят от стоимости, актуальности и риска. Конфиденциальные ответы могут оправдывать отказ от использования общих кэшей.
ETag, HTTP-кеш и параллельные изменения
Подробные справочные заметки в этой версии доступны на английском.
ETag: revalidate responses and prevent lost updates
An ETag is an opaque validator for the selected representation. It compares versions; it is neither authorisation nor an access token, and it need not be a file hash. Personalised responses require separate decisions about access, cache selection and HTTP conditions.
Local teaching model: a representation already exists; at most one conditional field contains a single ETag or *. GET, HEAD and PUT are covered. Tag lists, date validators, ranges, creation, combined conditions and the already-succeeded modification exception are excluded. No network call, storage or state change occurs; this does not test your API.
Strong and weak ETag comparison serve different purposes
If-Match requires strong comparison: neither tag may start with W/. If-None-Match uses weak comparison, matching the opaque values regardless of W/. Values remain case-sensitive. The * wildcard checks representation existence here, not a particular version.
| Current tag | Received tag | Strong comparison | Weak comparison |
|---|---|---|---|
| "v1" | "v1" | Matches | Matches |
| "v1" | W/"v1" | Does not match | Matches |
| W/"v1" | W/"v1" | Does not match | Matches |
| "v1" | "v2" | Does not match | Does not match |
| "v1" | "V1" | Does not match | Does not match |
Simulate an HTTP decision without contacting a server
The six parameters yield 432 combinations. Requiring a conditional field and selecting 204 for successful PUT are policies of this fictional scenario. Requiring any condition does not prevent every lost update: If-Match: * compares no version.
Model decision :
304: If-None-Match finds a weak match for GET or HEAD. Reuse the stored representation under cache rules with the revalidation metadata.
304 and 204: no response content.
Request excerpt
GET /demo/resource HTTP/1.1
Host: api.example.test
If-None-Match: W/"v1"Response excerpt
HTTP/1.1 304 Not Modified
Date: Thu, 22 Oct 2026 00:00:00 GMT
ETag: "v1"
Cache-Control: private, no-cacheFictional HTTP/1.1 excerpts for reading: bodies are omitted even where allowed. api.example.test is an example domain. The date is fixed. This model does not update the ETag after PUT; the separate walkthrough follows successive versions.
Ten reproducible situations
| Fictional situation | Condition and expected outcome | Interpretation |
|---|---|---|
| Read using a weak tag | GET · "v1"Access allowed · Conditional field optional | W/"v1" and "v1" match weakly. |
| Different client version | GET · "v1"Access allowed · Conditional field optional | The client needs the selected representation. |
| HEAD revalidation | HEAD · "v1"Access allowed · Conditional field optional | The status can be 304; the response has no content. |
| Write based on an old version | PUT · "v2"Access allowed · Conditional field optional | Read again and resolve the conflict before retrying. |
| Weak tag with If-Match | PUT · "v1"Access allowed · Conditional field optional | Strong comparison rejects a weak tag. |
| Required condition absent on PUT | PUT · "v1"Access allowed · Conditional field required | 428 follows the policy announced by this API. |
| Access denied despite matching tag | GET · "v1"Access denied · Conditional field optional | Authorisation precedes HTTP conditions. |
| Write on the correct version | PUT · "v1"Access allowed · Conditional field required | The model accepts PUT and selects a 204 success. |
| If-None-Match: * on existing data | PUT · "v1"Access allowed · Conditional field optional | The wildcard matches any existing representation. |
| If-Match: * on existing data | PUT · W/"v1"Access allowed · Conditional field required | The wildcard passes even with a weak current tag: it does not protect a version. |
Four rules for a personalised response
| Response field | HTTP effect within this scope | Evidence to retain |
|---|---|---|
| Cache-Control: no-cache | Unqualified no-cache permits storage, but any reuse needs successful validation with the origin server. | Observe a conditional round trip; do not read no-cache as a storage prohibition. |
| Cache-Control: no-store | Forbids storage by private and shared HTTP caches. It is not a general privacy guarantee. | Also review logs, history, screenshots and application storage. |
| Cache-Control: private | Unqualified private forbids storage by a shared cache; a private cache may store under the other constraints. | Distinguish browser, proxy and CDN. A directive does not replace access checks. |
| Vary | Adds the named request fields to selection of a stored response. It does not decide who may access a resource. | Test relevant variants. Do not assume a cookie or Authorization automatically prevents all caching. |
Useful API acceptance evidence
- Expected request and status: method, test resource, access rights, conditional field and current ETag. Use fictional data and remove secrets.
- Observed response: status, ETag, Date, Cache-Control, Vary and no content for HEAD, 204 or 304. A 304 must carry the required metadata that would have accompanied the 200.
- Concurrency: verify that a stale write fails without changing the resource; retain the conflict-resolution decision. Do not blindly replace the ETag and resend the same write.
Follow the two-client conflict →
Primary references and limits
The standards define HTTP conditions and caching. The ten cases, laboratory and two-client walkthrough are original illustrations. Displayed results are calculated by this local model, not measurements of this site or your infrastructure.
- IETF · RFC 9110 — HTTP Semantics · June 2022 · STD 97
§8.8.3.2; §13.1.1–13.1.2; §13.2; §15.3.5; §15.4.5 - IETF · RFC 9111 — HTTP Caching · June 2022 · STD 98
§4.1; §4.3; §5.2.2.4–5.2.2.5; §5.2.2.7 - IETF · RFC 6585 — Additional HTTP Status Codes · April 2012 · Standards Track
§3 · 428 Precondition Required
References reviewed
Официальные ссылки
Ссылки подтверждают метод. Адаптируйте проверки к вашему контексту; они не являются сертификацией. Оригинальные названия ссылок и исходные документы могут быть на другом языке.
Источники проверены .
