käytännön oppaat

Määritä HTTP-välimuisti paljastamatta yksityisiä tietoja

Välimuisti auttaa vain, kun uudelleenkäytetty vastaus on sopiva vierailijalle ja pääsyajalle. Jokaisen resurssin yksi käytäntö voi piilottaa päivityksen tai paljastaa henkilökohtaisen vastauksen.

Katso menetelmä

Kuvitus — Määritä HTTP-välimuisti paljastamatta yksityisiä tietoja
Tekoälyllä luotu kuvitus

Luokittele vastaukset ennen kuin valitset eliniän

Inventaario julkiset sivut, staattiset resurssit, API-vastaukset, tilit ja vahvistukset. Tallenna, muuttuuko kukin käyttäjän, kielen tai parametrin mukaan. Tunnista selain-, välittäjä- ja CDN-välimuistit. Tilisivun ei pitäisi periä julkisen valokuvan politiikkaa vain siksi, että tätä käytäntöä on helppo soveltaa.

erottaa tuoreus luvasta tallentaa vastaus. MDN selittää, että ei-välimuisti vaatii uudelleenvalidointia, kun taas ei-kauppa ei vaadi tallennusta. Yksityinen rajoittaa tallennustilan yksityisiin välimuistiin. Pelkkä eväste ei tee vastausta automaattisesti yksityiseksi.

Suunnittele kuinka päivitys tulee näkyviin

Kirjoita päivityssääntö jokaiselle perheelle. Jos haluat versioidun tiedoston, varmista, että uusi sivu pyytää uutta URL-osoitetta. Jos haluat julkisen sivun, jolla on vakaa osoite, kuvaile uudelleenvalidointi tai tyhjennys. Pitkä käyttöikä ilman korvausmenettelyä siirtää ongelman vain seuraavaan sisällön muutokseen.

Valitse käytännön esimerkki: hinnan korjaus, aukioloajat tai korvattu asiakirja. Tallenna, kun alkuperä muuttuu, ja tarkasta sitten istunto, joka on jo käynyt sivulla. Pelkästään uusi selain ei kata palaavaa vierailijaa, joka säilyttää aikaisemman vastauksen.

Uudelleenvalidoinnissa selain voi lähettää tallennetun kopion ETag-arvon If-None-Match-otsakkeessa. Jos esitysmuoto vastaa yhä arvoa, 304-vastaus sallii tallennetun rungon käytön eikä lähetä uutta sivurunkoa. Jos esitysmuoto on muuttunut, kokonainen 200-vastaus voi toimittaa sisällön ja uuden validaattorin. Pelkkä tilakoodi ei siis kuvaa vierailijan lopulta näkemää sisältöä.

Jos ensimmäinen vastaus sisältää Last-Modified-kentän, kopioi sen päivämäärä sellaisenaan If-Modified-Since-kenttään uudessa GET-pyynnössä samaan URL-osoitteeseen. Vastaus 304 kertoo, ettei palvelimen muutosaika ole lähetettyä päivämäärää uudempi. Jos kaksi versiota tarjotaan saman sekunnin aikana, päivämäärä voi pysyä samana sisällön muuttumisesta huolimatta. Kun tarkkuudella on merkitystä, käytä versiot erottavaa ETag-tunnistetta. Jos pyynnössä on molemmat ehtokentät, If-None-Match on ensisijainen.

Taulukon kuvitteelliset validaattorit demo-v1 ja demo-v2 erottavat vaiheet; ne eivät ole tämän sivuston mittauksia. Säilytä yhdessä ehdollinen pyyntö, vastaus, käytetty kopio ja näkyvä korjaus. ETag on palvelimen tuottama läpinäkymätön tunniste, ei välttämättä tiiviste tai päivämäärä. Testaa myös Takaisin: historia voi palauttaa tilannekuvan HTTP-välimuistista erillisellä mekanismilla.

Vieritä taulukkoa vaakasuunnassa nähdäksesi kaikki sarakkeet. Siirrä näppäimistöllä kohdistus taulukkoon ja käytä nuolinäppäimiä.

Kuvitteellinen esimerkki: uudelleenvalidoinnista näkyvään sisältöön
TestitilanneYhdistettävä viestinvaihtoHyödyllinen näyttö
Ensimmäinen luku200, runko ja ETag demo-v1.Alkukopio sisältää odotetun version.
Uudelleenvalidointi ilman muutostaIf-None-Match demo-v1, sitten 304.Tallennettua runkoa käytetään uudelleen; uutta runkoa ei vastaanoteta.
Esitysmuoto on muuttunutIf-None-Match demo-v1, sitten 200 ja demo-v2.Uusi runko vastaanotetaan ja korjaus todella näkyy.
Yksin havaittu 304-vastausVastaus on yhdistettävä tallennettuun kopioon.Pelkkä koodi ei osoita sisällön palautumista tai oikean version näyttämistä.

Testaa eri identiteettejä ja tiloja

Vertaa testiympäristössä anonyymiä käyntiä, kahta erillistä tiliä, uloskirjautumista ja takaisinnavigointia. Tarkista näytettävä sisältö ja vastaanotetut otsikot pelkän hosting-kokoonpanon sijaan. Käytä synteettisiä testitietueita oikeiden henkilökohtaisten asiakirjojen sijaan.

Sisällytä asiaankuuluva kieli, laite, suodatin ja virhetilat. Säilytä kunkin testin URL-osoite, istunnon tila, odotettu vastaus ja tulos. Kun personointi kulkee jaetun välimuistin läpi, pyydä infrastruktuurin omistajaa tarkistamaan välimuistin avaimet ja poissulkemiset.

Jatka palautusmenettelyä

Asiakirja, joka voi tyhjentää välimuistin, tarkistaa sen vaikutuksen ja palauttaa aiemman kokoonpanon. Laaja tyhjennys voi tilapäisesti vähentää välimuistin etuja, joten valmistele välttämättömien sivujen tarkistus leikkauksen jälkeen.

Tarkista käytäntö, kun asiakastilit, kauppa, kieli tai CDN otetaan käyttöön. Hyödyllinen tulos on vastaus-politiikka-testi-omistajamatriisi. Pelkästään suorituskykypisteet eivät osoita tuoreutta tai eristäytymistä käyttäjien välillä.

ensisijainen dokumentaatio: MDN : HTTP-välimuisti.

Estä jaettua välimuistia tarjoamasta väärää versiota.

Kuvitteellinen tapaus: yksi URL tarjoaa kaksi muotoa otsakkeen mukaan. Testaa molemmat oikean välimuistin kautta ja tarkista vaihtelun avain, tarvittaessa Vary. Toimitukselliset versiot voivat vaatia eri URL:t. Nimenomaisesti valitun version tulee säilyä saatavilla.

  • Jokainen pyyntö saa oikean version myös toisen jälkeen välimuistin ollessa käytössä.

Erota henkilökohtaiset välimuistivastaukset

Kaksi värimerkeillä erotettua kannettavaa reitittimen vieressä
Tekoälyllä luotu kuvitus · Tarkastele kahden testi-istunnon sisältöjä erikseen.

Ehdotettu esimerkki: henkilökohtainen vahvistus kulkee jaetun välimuistin kautta. Jokaisen istunnon vastaanottama sisältö on tarkistettava.

Käytä kahta erillistä testi-istuntoa. Vertaa pyyntöjä, otsakkeita ja sisältöä; yleinen asetus ei yksin todista havaittua erottelua.

  • Avaa kaksi erillistä istuntoa
  • Vertaa otsakkeita ja sisältöä
  • Kirjaa havaittu erottelu

viiteasiakirjat

Sisältö päivitetty

Aiheen dokumentoidut viitekohdat

Aiheen dokumentoidut viitekohdat
ViiteArvo tai syntaksiSoveltamisala
HTTP · 304
If-None-Match → 304GET- tai HEAD-pyynnössä muuttumatonta esitystä voidaan käyttää uudelleen lähettämättä sisältöä uudestaan.
MDN · Vary
Vary: Accept-LanguageJos sama URL tuottaa eri vastauksia Accept-Language-otsakkeen mukaan, Vary ilmoittaa valintaperusteen välimuistille. Säilytä arvo yhtenäisenä 200- ja 304-vastauksissa. Erilliset kieli-URL:t eivät edellytä tätä otsaketta vain monikielisyyden vuoksi.
HTTP · If-Match
If-Match: "r7" → 412If-Match vertaa vahvaa tunnistetta ennen kirjoitusta. Esimerkin sopimuksessa vanhentunut versio saa 412-vastauksen; luonnos säilytetään muutosten vertailuun.

Päivämäärät kertovat lähteiden tarkistamisesta. Tiedot eivät ole sivuston auditointi tai yleinen vaatimustenmukaisuusvakuutus.

Lue välimuistin uudelleenvahvistus

Vertaa vaihdettua runkoa ja uudelleenkäytettyä kopiota. Katkelmat näyttävät validaattorit ja sisällön pelkän tilakoodin lisäksi.

Katkelmat ovat puutteellisia ja käyttävät esimerkkiosoitteita. Koe luo Response-olion muistiin: se ei ota yhteyttä palvelimeen eikä simuloi verkkoa, välimuistia tai liiketoimintakäsittelyä.

200Uusi kokonainen esitys
Merkitys
Tässä katkelmassa palvelin vastaa ehdolliseen GET-pyyntöön JSON-rungolla ja demo-v2-validaattorilla.
Tarkistettava asia
Vertaa If-None-Match-, ETag- ja rungon revisiotietoja. Paikallinen koe jäsentää tämän esimerkin JSONin.
Huomioitavaa
Tila 200 ei takaa kelvollista JSONia tai oikeita liiketoimintatietoja. Onnistunut jäsentäminen ei vahvista omien tietojesi rakennetta.
Kuvitteellisen viestinvaihdon katkelma
GET /demo/catalogue
If-None-Match: "demo-v1"

HTTP/1.1 200 OK
ETag: "demo-v2"
Content-Type: application/json

{"revision":"demo-v2"}

304Kopio vahvistettu, ei uutta runkoa
Merkitys
304 vastaa ehdolliseen pyyntöön: tallennettua esitystä voi käyttää uudelleen. Se ei toimita uutta runkoa.
Tarkistettava asia
Vertaa lähetettyä validaattoria saatavilla olevaan demo-v2-kopioon. Tulkinta riippuu myös tallennetusta kopiosta.
Huomioitavaa
Koe luo yksittäisen Response 304 -olion, ei HTTP-välimuistia. Todellisessa fetch-haussa selain voi palauttaa tallennetun vastauksen: verkon ja skriptin tilakoodit voivat erota.
Kuvitteellisen viestinvaihdon katkelma
GET /demo/catalogue
If-None-Match: "demo-v2"

HTTP/1.1 304 Not Modified
ETag: "demo-v2"

Tekniset lähteet : RFC 9110 §15 · MDN · Response.ok · MDN · Response.json() · WHATWG · Fetch · .

toiminnallinen validointimatriisi, joka mukautuu projektiin

Nämä ehdotetut kontrollit käyttävät kuvitteellisia tapauksia. Päätä, mitä käyttäytymistä tiimin kanssa odotetaan, kirjoita tulos muistiin ja määritä ratkaisemattomia eroja ennen julkaisemista.

Vieritä taulukkoa vaakasuunnassa nähdäksesi kaikki sarakkeet. Siirrä näppäimistöllä kohdistus taulukkoon ja käytä nuolinäppäimiä.

testitapaukset, odotetut tulokset ja hyödyllisiä todisteita
Asiaodotettu tulostodiste säilyttää
ennallaanMainostetut käytännöt ja ehdolliset vastaukset pysyvät johdonmukaisina kaikissa pyynnöissä.Otsikot, validaattori ja tila molemmista pyynnöistä, selaimen tila tallennettuna.
Muutettu julkinen sisältöKorjattu versio saapuu määritellyissä tuoreusolosuhteissa.Vanhaa ja uutta sisältöä, pyyntöaikaa ja vastaanotetut otsikot.
Kaksi testitiliäHenkilökohtaista vastausta ensimmäiselle tilille ei koskaan toimiteta toiselle.kunkin synteettisen tilin vastaanottamat yksittäiset pyynnöt ja sisältö.
Kirjaudu ulos ja mene takaisinArkaluonteinen näytön käyttäytyminen vastaa dokumentoitua luottamuksellisuusvaatimusta.Täydellinen selainjärjestys ja nimenomaisesti tallennetut rajoitukset.

Usein kysyttyjä kysymyksiä

Ovatko välimuistin ja kaupan ilman tahtia vastaavia?

Ei. Ensimmäinen vaatii validoinnin ennen uudelleenkäyttöä; toinen pyytää, että vastausta ei tallenneta. Valitse sisällön ja välimuistien mukaan ja testaa sitten matkat.

Pitäisikö jokaisen resurssin jakaa yksi välimuisti?

Yksittäinen käyttöikä jättää huomioimatta erot versioidun julkisen omaisuuden, toimituksellisten sivujen, hintojen ja henkilökohtaisten vastausten välillä. Luokittele vastaukset, määritä niiden päivitysprosessi ja testaa sisäänkirjautuneita tiloja ennen eliniän valitsemista.