{"canonical_url":"https://engineer.company/nb/glossary/sri/","content_markdown":"# Subresource Integrity\n\n## Hva det er\n\nSubresource Integrity er en mekanisme der en side på forhånd oppgir nøyaktig\nhvilke byte et skript eller et stilark skal inneholde, og der nettleseren kaster\nfilen hvis det som kommer fram, er noe annet. Til daglig forkortes det til SRI.\nSiden skriver et kryptografisk sammendrag av filen inn i et `integrity`-attributt\npå `script`- eller `link`-elementet som laster den. Når svaret kommer, kjører\nnettleseren den samme hashfunksjonen over bytene den fikk, og sammenligner\nresultatet med verdien på elementet. Er de like, kjører skriptet eller virker\nstilarket på siden som vanlig. Er de ulike, behandler nettleseren svaret som en\nnettverksfeil: skriptet blir aldri utført, og stilarket blir aldri brukt.\n\nVerdien består av navnet på en hashfunksjon, en bindestrek og sammendraget i\nbase64. Én kommando over den ferdige filen lager den, og to kjøringer viser hvor\nlite som skal til for å endre svaret:\n\n```text\n$ printf \"alert('Hello, world.');\" \u003e hello.js\n$ openssl dgst -sha384 -binary hello.js | openssl base64 -A\nH8BRh8j48O9oYatfu5AZzq6A9RINhZO5H16dQZngK7T62em8MUt1FLm52t+eX6xO\n$ echo \u003e\u003e hello.js\n$ openssl dgst -sha384 -binary hello.js | openssl base64 -A\nqu8P7hCLFcBpas8BOnGmaANCkfXJIpFttDEaxOj0Pq9H6Q8NYjsMb+PVqwuJygVe\n```\n\nMed `sha384-` foran er den første linjen med utdata verdien attributtet skal ha\nfor det enlinjes skriptet. Ett linjeskift lagt til på slutten gir et sammendrag\nsom ikke har noe til felles med det første, og en nettleser som holder det\nførste, ville avvise den andre filen.\n\nSpesifikasjonen kjenner tre hashfunksjoner, SHA-256, SHA-384 og SHA-512, alle\nfra SHA-2-familien, og omtaler SHA-384 som et godt utgangspunkt da teksten ble\nskrevet. Et attributt kan liste flere sammendrag atskilt med mellomrom.\nNettleseren velger den sterkeste funksjonen blant dem og godtar filen når den\nstemmer med ett av sammendragene laget med den funksjonen. Slik kan en side gå\nover til en sterkere algoritme, eller godta to utgivelser av et bibliotek mens\nde byttes, uten et tidsrom der siden bare bærer feil verdier.\n\nAttributtet finnes på `script` og `link`, og den samme verdien kan følge med i\nen `Link`-header i svaret som forhåndslaster en fil. Gjeldende tekst er andre\nutgave, et W3C-arbeidsutkast fra Web Application Security Working Group. Den\nførste utgaven ble en W3C-anbefaling i 2016.\n\n## Hvorfor det er viktig\n\nEn side som laster et bibliotek fra et CDN, eller fra en hvilken som helst vert\neierne ikke selv drifter, gir den verten makt til å kjøre kode på siden. HTTPS\nbeskytter filen på veien over nettet, men sier ingenting om hva verten valgte å\nsende i utgangspunktet. Blir lagringen hos CDN-et brutt opp, blir en konto som\npubliserer dit, overtatt, eller blir filen bak en kjent adresse byttet ut i det\nstille, kjører hver side som tar den med, den nye koden med hele sidens\nmyndighet. Sidens egen kode har ingen måte å merke forskjellen på.\n\nSRI flytter den avgjørelsen tilbake til siden. Sammendraget lages av eieren av\nnettstedet over en fil de har lest eller bygd selv, og det reiser inne i siden,\nfra nettstedets egen server. En vert som leverer noe annet, får filen sin avvist\ni stedet for kjørt. Siden mister en funksjon til noen ser på den, en synlig feil\nmed en åpenbar årsak, og slipper å kjøre andres kode uten at noen merker det.\n\nSammendraget låser også en versjon. En adresse som `/lib/latest.js` kan når som\nhelst begynne å levere en ny utgivelse under en side, og det kan ikke\nsammendraget følge etter. En oppgradering eieren aldri valgte, blir en avvisning\npå ett bestemt element, meldt gjennom en feilhendelse.\n\nDet lønner seg å være presis om hva SRI lar være. Mekanismen sjekker en fil mot\net sammendrag og vurderer aldri om filen er trygg. Et sammendrag av et bibliotek\nsom allerede inneholder en fiendtlig linje, beskytter den fiendtlige linjen\ntrofast. Skript skrevet rett inn i siden faller utenfor, og der er det en\nContent Security Policy som gjør jobben. Og mekanismen\nstoler på siden som bærer sammendraget, så selve siden må fortsatt komme fram\nuendret.\n\n## Slik ser det ut i praksis\n\nDette nettstedet bruker det på sitt eget stilark.\n[Siden om hvordan vi arbeider sikkert](/nb/security/) lister Subresource\nIntegrity på stilarket: pakken får et fingeravtrykk og en hash når nettstedet\nbygges, slik at nettleseren til leseren kan bekrefte at den kom fram uendret.\nIngen kjørbar JavaScript publiseres, og ingen forespørsler går til tredjeparter.\nEn leser som teller vertene i nettverkspanelet i nettleseren, finner én,\nnettstedets egen.\n\n[Kolofonen](/nb/credits/) beskriver den samme filen sett fra bygget, som én\nCSS-pakke satt sammen og merket med et fingeravtrykk ved bygging og levert med\nen SRI-hash. Fingeravtrykket legger en hash av innholdet inn i filnavnet, så et\nendret stilark får en ny adresse, og en nettleser tar aldri feil av en gammel\nkopi i hurtigbufferen og den gjeldende. Integritetsverdien lar nettleseren\nsjekke bytene bak den adressen. Bygget lager begge deler fra de samme bytene i\ndet samme trinnet, så hver utgivelse leverer stilarket og sammendraget sammen,\nog den vanligste feilen beskrevet nedenfor, en fil som endres etter at den ble\nhashet, har svært lite rom til å skje.\n\n## Hvor det går galt\n\n**Et ledd mellom bygget og nettleseren skriver om filen.** Et CDN som\nminifiserer skript, en proxy som setter noe inn i svarinnholdet, eller et steg i\nproduksjonssettingen som skriver om en fil etter at sammendraget ble tatt,\nendrer bytene i innholdet, og nettleseren avviser resultatet selv om ingen har\nangrepet noe. Ny komprimering med gzip eller Brotli som bevarer innholdet,\nskaper ikke dette avviket: kontrollen bruker svarets dekodede innhold, ikke de\nkomprimerte bytene som sendes over nettet. Spesifikasjonen legger ansvaret på\nmellomledd som endrer innholdet: de må holde sammendraget i takt med det de\nleverer, eller levere originalen urørt, og opphavet bør sende\n`Cache-Control: no-transform` for å be dem la filen være. Den pålitelige\nrekkefølgen er å ta sammendraget sist, over nøyaktig de bytene i det dekodede\ninnholdet som nettleseren vil kontrollere.\n\n**En fil fra et annet opphav kommer uten CORS.** Spesifikasjonen krever at en\nintegritetssjekk av en fil fra et annet opphav bruker CORS, og kaller et forsøk\nuten det en logisk feil. Elementet kan for eksempel bruke\n`crossorigin=\"anonymous\"`, og verten må svare med en header som tillater deling\nav filen. `crossorigin=\"use-credentials\"` bruker også CORS, med serverheadere\nsom uttrykkelig tillater opphavet til forespørselen og legitimasjon. Uten en\nCORS-forespørsel og en tilsvarende serverpolicy blokkerer nettleseren filen\nheller enn å laste den usjekket. Regelen beskytter andre nettsteder. Fantes den\nikke, kunne en angriper laste et privat svar med et gjettet sammendrag og lære\nnoe av utfallet, f.eks. om leseren er logget inn der.\n\n**Et sammendrag som kommer over ukryptert HTTP.** SRI beskytter en side mot en\nkompromittert vert for filer, aldri mot noen på nettverksveien. På en side\nlevert uten HTTPS kan den som kan skrive om filen underveis, like godt skrive om\neller slette sammendraget i siden, så spesifikasjonen anbefaler å levere\nintegritetsdata bare til en sikker kontekst.\n\n**En hashfunksjon nettleseren hopper over.** Spesifikasjonen kjenner bare\nSHA-256, SHA-384 og SHA-512 og anbefaler at nettlesere avviser kjent svake\nfunksjoner som MD5 og SHA-1. Overraskelsen er hva som skjer med en verdi utenfor\nden listen: nettleseren overser den, og et attributt som bare består av oversette\nverdier, regnes som om det ikke bar noen data i det hele tatt, så filen lastes\nusjekket. Et byggverktøy som kan lage fingeravtrykk med MD5, slik Hugo kan, gjør\ndet lett å sende dette ut ved et uhell.\n\n**En avvist fil som tar siden med seg i fallet.** Når sjekken feiler, sender\nnettleseren en feilhendelse på elementet, og skriptet eller stilarket er rett og\nslett borte. For et bibliotek siden ikke klarer seg uten, foreslår\nspesifikasjonen å fange hendelsen og laste en reservekopi fra en kilde du stoler\npå, om enn tregere, f.eks. nettstedets egen server. Mangler en slik reserve,\nvirker beskyttelsen som tenkt, og leseren får likevel en ødelagt side.\n\n**En sjekk som bare dekker elementene med et sammendrag.** Et\nintegritetsattributt på ett skript sier ingenting om det neste noen legger til\nuten, og en gjennomgang av skriptene som har ett, vil aldri avsløre det som\nmangler. Utkastet legger til en header i svaret som dekker dette fra\nserversiden. `Integrity-Policy` med `blocked-destinations=(script)` blokkerer\nhvert eksterne skript som kommer uten integritetsdata, og\n`Integrity-Policy-Report-Only` lister dem først, så de kan rettes før noe blir\nblokkert.\n\n## Les mer\n\n- [Subresource Integrity](https://www.w3.org/TR/SRI/)\n  — det gjeldende utkastet, med algoritmen for verifisering,\n  `Integrity-Policy`-headerne og merknadene om proxyer, ukryptert HTTP og\n  lekkasjer på tvers av opphav.\n- [Subresource Integrity, W3C Recommendation 2016](https://www.w3.org/TR/2016/REC-SRI-20160623/)\n  — første utgave, den stabile anbefalingen utkastet vokste ut av.\n- [Fetch Standard](https://fetch.spec.whatwg.org/)\n  — der integritetsdataene i en forespørsel sjekkes mot innholdet i svaret, og\n  CORS-protokollen en sjekk på tvers av opphav er avhengig av.\n- [Hugo: resources.Fingerprint](https://gohugo.io/functions/resources/fingerprint/)\n  — hvordan en statisk nettstedsgenerator lager et fingeravtrykk av en fil ved\n  bygging og gir tilbake den tilhørende integritetsverdien.\n- [FIPS 180-4, Secure Hash Standard](https://csrc.nist.gov/pubs/fips/180-4/upd1/final)\n  — den føderale amerikanske standarden som definerer SHA-256, SHA-384 og\n  SHA-512.\n\n\u003chttps://engineer.company/nb/glossary/sri/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Slik avviser nettleseren et skript eller stilark som er endret etter at sjekksummen ble laget, og hva som ryker når fil og sjekksum glir fra hverandre.","formats":{"gemtext":"https://engineer.company/nb/glossary/sri/index.gmi","gopher":"https://engineer.company/nb/glossary/sri/gophermap","html":"https://engineer.company/nb/glossary/sri/","json":"https://engineer.company/nb/glossary/sri/index.json","markdown":"https://engineer.company/nb/glossary/sri/index.md","pdf":"https://engineer.company/nb/glossary/sri/index.pdf"},"kind":"page","language":"nb","title":"Hva er Subresource Integrity?","url":"https://engineer.company/nb/glossary/sri/","version":1}