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
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
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
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
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
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
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 |
|---|---|
| Vastaus | Julkinen vai personoitu; ulottuvuudet |
| Kerros | Välimuisti, omistaja ja avain |
| Käytäntö | Säilytys, tuoreus ja validointi |
| Kokeilu | Kuvitteellinen 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
| Mekanismi | Tarkoitus | Vahvistus tai rajoitus |
|---|---|---|
| ei välimuistia | Salli tallennus vaaditulla validoinnilla | Älä lue sitä ei-tallennustilana |
| Määrittelemätön yksityinen | Sulje pois jaettu välimuisti | Älä lue sitä luottamuksellisuustakuuna |
| ei tallennustilaa | Estä asiaankuuluva HTTP-tallennustila | Tarkista sovellusvälimuistit ja historia erikseen |
Johdon indikaattorit
| Indikaattori | Mitä se mittaa | Ensimmäinen toimenpide |
|---|---|---|
| Tilien erottelu | Ei merkintää toiselta tililtä | Tarkista runko, linkit ja metatiedot |
| Ikä ja validointi | Uudelleenkäyttö käytäntöjen mukaisesti | Testin vanheneminen ja ei-käytettävä alkuperä |
| Mitätöintiviive | Aika korjattuun esitykseen | Nimeä 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.
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
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 .
