Resurssit · 63

HTTP-välimuisti: suojaa mukautettuja vastauksia

Erota jaetut, yksityiset ja sovellusvälimuistit, tarkista avaimet, uudelleenvahvistus ja mitätöinti käyttöoikeuksien muutosten jälkeen.

Päivitetty · 6 min

Tyhjä suojattu palvelin- ja verkkokäytävä Tekoälyllä luotu toimituksellinen kuvitus

Mitä tämä opas auttaa saavuttamaan

  • Varastotasot
  • Säilytyksen valinta
  • Avainten tarkastus
  • Harjoitus uudelleenvalidointi ja muutos

Pikatarkistus

  • Tarkoittaako välimuistin puuttuminen, että mitään ei säilytetä?
  • Suojaako Vary käyttöoikeuksia?
  • Pitäisikö jokainen API tallentaa välimuistiin?

Vaiheittainen menetelmä

  1. 1

    Varastotasot

    Listaa selaimen, CDN:n, välityspalvelimen, palvelutyöntekijän ja sovelluksen välimuistit. Luokittele julkiset ja personoidut vastaukset. HTTP-käytäntö ei automaattisesti kuvaa koodissa toteutettua välimuistia.

    Toimitettava: tasot ja omistajat -kaavio.

  2. 2

    Säilytyksen valinta

    RFC 9111 erottaa direktiivit: välimuistin puuttuminen vaatii validoinnin ennen uudelleenkäyttöä, tallennuskielto estää asiaankuuluvan HTTP-tallennuksen ja määrittelemätön yksityinen sulkee pois jaetun tallennuksen. Mikään yksinään ei takaa järjestelmän luottamuksellisuutta.

    Toimitettava: säilytyskäytäntö vastauksen mukaan.

  3. 3

    Avainten tarkastus

    Tarkista menetelmä, URI ja ulottuvuudet, jotka muuttavat esitystä. Vaihtelee pyyntökenttien osalta; se ei ole valtuutusta. Etsi puuttuvaa kieltä, muotoneuvottelua ja tilin kontekstia sovelluskerroksissa.

    Toimitus: avaimet ja erottelutestit.

  4. 4

    Harjoitus uudelleenvalidointi ja muutos

    Testaa uusia ja vanhentuneita vastauksia, datapäivityksiä ja peruutettuja oikeuksia. Tarkista ETag, ehdollinen validointi ja alkuperän saatavuushäiriö. Aiemmin oikeasta vastauksesta voi tulla arkaluontoinen peruutuksen jälkeen.

    Toimitettava: ennen ja jälkeen -jäljet.

  5. 5

    Toisto kahdella tilillä.

    Käytä kuvitteellisia identiteettejä ja merkkejä. Vaihtoehtoiset pyynnöt samaan URI:in lämpimien ja kylmien välimuistien avulla. Tarkista uloskirjautuminen, suorat linkit ja lokikirjaus tallentamatta oikeita tokeneita.

    Toimitettava: negatiiviset testit ja mitätöintistrategia.

Mittaa myös välimuistitiedon ajantasaisuutta

Kuvitteellinen esimerkki: tiedot eivät kuvaa asiakasta tai havaittua tulosta.

Tilanne

Kaksi lukupyyntöä ovat nopeita, mutta toinen näyttää vanhaa saatavuutta vielä lähteen muuttumisen jälkeen.

Tarkista

Vertaa arvoa, versiota, lukupaikkaa ja muutoksesta kulunutta aikaa. Testaa mitätöinti, vanheneminen ja lähteen käyttö järjestelmäsopimuksen mukaisesti.

Toimi

Määritä hyväksyttävä vanhentuneisuus käyttötavoittain ja seuraa eroja. Pienempi viive ei osoita toimitetun tiedon johdonmukaisuutta.

Uudelleenkäytettävä laskentataulukko

Täytä valtuutetut havaintosi. Nämä kentät ovat työskentelymalli, eivät havaittuja tuloksia.

KenttäKirjattavat tiedot
VastausJulkinen vai personoitu; ulottuvuudet
KerrosVälimuisti, omistaja ja avain
KäytäntöSäilytys, tuoreus ja validointi
KokeiluKuvitteellinen tili, muutos ja havainnointi

Kuvitteellinen esimerkki

Havainnollistava tilanne

Kuvitteellinen esimerkki: CDN käyttää profiilivastausta uudelleen samalla URI:lla kahdelle testitilille.

Päätös ja odotettu näyttö

Skenaario havaitsee vuodon, tutkii käytäntöä ja avaimia ja toistaa sitten korjauksen ja käyttöoikeuden peruuttamisen jälkeen.

Mekanismien erottaminen

MekanismiTarkoitusVahvistus tai rajoitus
ei välimuistiaSalli tallennus vaaditulla validoinnillaÄlä lue sitä ei-tallennustilana
Määrittelemätön yksityinenSulje pois jaettu välimuistiÄlä lue sitä luottamuksellisuustakuuna
ei tallennustilaaEstä asiaankuuluva HTTP-tallennustilaTarkista sovellusvälimuistit ja historia erikseen

Johdon indikaattorit

IndikaattoriMitä se mittaaEnsimmäinen toimenpide
Tilien erotteluEi merkintää toiselta tililtäTarkista runko, linkit ja metatiedot
Ikä ja validointiUudelleenkäyttö käytäntöjen mukaisestiTestin vanheneminen ja ei-käytettävä alkuperä
MitätöintiviiveAika korjattuun esitykseenNimeä jokainen kerros, jos se on edelleen vanhentunut

Yleisiä virheitä

  • Älä lue sitä ei-tallennustilana
  • Älä lue sitä luottamuksellisuustakuuna
  • Tarkista sovellusvälimuistit ja historia erikseen

Usein kysytyt kysymykset

Tarkoittaako välimuistin puuttuminen, että mitään ei säilytetä?

Ei. Se vaatii validoinnin ennen uudelleenkäyttöä; se ei estä tallennusta kuten ei-tallennustila.

Suojaako Vary käyttöoikeuksia?

Ei. Se osallistuu esityksen valintaan; valtuutus pysyy erillisenä.

Pitäisikö jokainen API tallentaa välimuistiin?

Ei. Hyödyt riippuvat kustannuksista, tuoreudesta ja riskistä. Arkaluontoiset vastaukset voivat oikeuttaa jaettujen välimuistien välttämisen.

ETag, HTTP-välimuisti ja samanaikaiset muutokset

Tämän kieliversion tarkemmat lähdekuvaukset ovat englanniksi.

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.

Kuvitteellinen tyhjä verkkolaboratorio, laitteita tummalla meripihkanvärisesti valaistulla pöydällä. Tekoälyllä luotu toimituksellinen kuvitus
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

Viralliset viitteet

Viitteet tukevat menetelmää. Sovita tarkastukset kontekstiisi; ne eivät ole sertifiointia. Alkuperäiset viitteiden otsikot ja lähdeasiakirjat voivat olla toisella kielellä.

Lähteet tarkistettu .