Ресурсы · 63

HTTP-кэширование: защита персонализированных ответов

Разделите общий, частный и прикладной кэш, проверьте ключи, повторную проверку и аннулирование после изменения прав доступа.

Обновлено · 6 min

Пустой защищённый коридор серверов и сетевого оборудования Редакционная иллюстрация, созданная с помощью ИИ

Чего помогает достичь это руководство

  • Слои инвентаризации
  • Выбор срока хранения
  • Проверка ключей
  • Повторная проверка и изменение

Быстрая проверка

  • Означает ли отсутствие кэша, что ничего не сохраняется?
  • Защищает ли Vary права доступа?
  • Следует ли кэшировать каждый API?

Пошаговый метод

  1. 1

    Слои инвентаризации

    Перечислите кэши браузера, CDN, прокси, сервис-воркера и приложения. Классифицируйте публичные и персонализированные ответы. Политика HTTP не описывает автоматически кэширование, реализованное в коде.

    Результат: диаграмма слоев и владельцев.

  2. 2

    Выбор срока хранения

    RFC 9111 различает директивы: no-cache требует проверки перед повторным использованием, no-store запрещает соответствующее хранилище HTTP, а unqualified private исключает общее хранилище. Ни одна из них сама по себе не гарантирует конфиденциальность системы.

    Результат: политика хранения для каждого ответа.

  3. 3

    Проверка ключей

    Проверка метода, URI и измерений, изменяющих представление. Vary касается полей запроса; Это не авторизация. Необходимо проверить пропущенные языковые параметры, согласование формата и контекст учетной записи на уровне приложения.

    Результат: ключи и тесты разделения.

  4. 4

    Повторная проверка и изменение

    Тестирование новых и устаревших ответов, обновлений данных и отозванных прав. Проверка ETag, условной проверки и поведения при недоступности источника. Ранее правильный ответ может стать конфиденциальным после отзыва.

    Результат: трассировка до и после.

  5. 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.

Вымышленная сетевая лаборатория без людей: оборудование на тёмном столе с янтарной подсветкой. Редакционная иллюстрация, созданная с помощью ИИ
Generated conceptual scene: a fictional empty network laboratory. It shows neither a real facility nor a protocol measurement.

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.

Strong and weak ETag comparison serve different purposes
Current tagReceived tagStrong comparisonWeak comparison
"v1""v1"MatchesMatches
"v1"W/"v1"Does not matchMatches
W/"v1"W/"v1"Does not matchMatches
"v1""v2"Does not matchDoes not match
"v1""V1"Does not matchDoes 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

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-cache

Fictional 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

Ten reproducible situations
Fictional situationCondition and expected outcomeInterpretation
Read using a weak tagGET · "v1"
If-None-Match: W/"v1" → 304

Access allowed · Conditional field optional

W/"v1" and "v1" match weakly.
Different client versionGET · "v1"
If-None-Match: "v2" → 200

Access allowed · Conditional field optional

The client needs the selected representation.
HEAD revalidationHEAD · "v1"
If-None-Match: "v1" → 304

Access allowed · Conditional field optional

The status can be 304; the response has no content.
Write based on an old versionPUT · "v2"
If-Match: "v1" → 412

Access allowed · Conditional field optional

Read again and resolve the conflict before retrying.
Weak tag with If-MatchPUT · "v1"
If-Match: W/"v1" → 412

Access allowed · Conditional field optional

Strong comparison rejects a weak tag.
Required condition absent on PUTPUT · "v1"
none → 428

Access allowed · Conditional field required

428 follows the policy announced by this API.
Access denied despite matching tagGET · "v1"
If-None-Match: "v1" → 403

Access denied · Conditional field optional

Authorisation precedes HTTP conditions.
Write on the correct versionPUT · "v1"
If-Match: "v1" → 204

Access allowed · Conditional field required

The model accepts PUT and selects a 204 success.
If-None-Match: * on existing dataPUT · "v1"
If-None-Match: * → 412

Access allowed · Conditional field optional

The wildcard matches any existing representation.
If-Match: * on existing dataPUT · W/"v1"
If-Match: * → 204

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

Four rules for a personalised response
Response fieldHTTP effect within this scopeEvidence to retain
Cache-Control: no-cacheUnqualified 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-storeForbids storage by private and shared HTTP caches. It is not a general privacy guarantee.Also review logs, history, screenshots and application storage.
Cache-Control: privateUnqualified 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.
VaryAdds 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.

References reviewed

Официальные ссылки

Ссылки подтверждают метод. Адаптируйте проверки к вашему контексту; они не являются сертификацией. Оригинальные названия ссылок и исходные документы могут быть на другом языке.

Источники проверены .