# Subresource Integrity

## Hvad det er

Subresource Integrity lader en side sige på forhånd, præcis hvilke bytes et script eller et stilark skal indeholde, og får browseren til at kassere filen, hvis det, der kommer frem, er anderledes. Det forkortes som regel til SRI. Siden skriver en kryptografisk hashværdi af filen i en `integrity`-attribut på det `script`- eller `link`-element, der henter den. Når svaret kommer, kører browseren den samme hashfunktion over de bytes, den har modtaget, og sammenligner resultatet med værdien på elementet. Er de ens, kører filen eller styler siden som normalt. Er de forskellige, behandler browseren svaret som en netværksfejl: scriptet bliver aldrig kørt, og stilarket bliver aldrig anvendt.

Værdien består af navnet på en hashfunktion, en bindestreg og selve hashværdien i base64. Én kommando over den færdige fil laver den, og kører man den to gange, ser man, hvor lidt der skal til for at ændre svaret:

```text
$ printf "alert('Hello, world.');" > hello.js
$ openssl dgst -sha384 -binary hello.js | openssl base64 -A
H8BRh8j48O9oYatfu5AZzq6A9RINhZO5H16dQZngK7T62em8MUt1FLm52t+eX6xO
$ echo >> hello.js
$ openssl dgst -sha384 -binary hello.js | openssl base64 -A
qu8P7hCLFcBpas8BOnGmaANCkfXJIpFttDEaxOj0Pq9H6Q8NYjsMb+PVqwuJygVe
```

Med `sha384-` foran er det første output attributtens værdi for det lille script på én linje. Et enkelt linjeskift tilføjet til sidst giver en hashværdi, der intet har til fælles med den første, og en browser med den første værdi ville afvise den anden fil.

Specifikationen kender tre hashfunktioner, SHA-256, SHA-384 og SHA-512, alle fra SHA-2-familien, og kalder SHA-384 et godt udgangspunkt i skrivende stund. En attribut kan rumme flere hashværdier adskilt af mellemrum. Browseren vælger den stærkeste funktion blandt dem og godtager filen, når den stemmer med en hvilken som helst værdi lavet med den funktion. Det lader en side skifte til en stærkere algoritme eller godtage to udgaver af et bibliotek under et skifte, uden et tidsrum hvor siden kun bærer forkerte værdier.

Attributten findes på `script` og `link`, og samme værdi kan følge med i en `Link`-header i svaret, der forudindlæser en fil. Specifikationens gældende tekst er anden udgave, et W3C Working Draft fra arbejdsgruppen Web Application Security. Første udgave blev en W3C-anbefaling i 2016.

## Hvorfor det betyder noget

En side, der henter et bibliotek fra et content delivery network eller fra en hvilken som helst vært, som ejerne ikke selv driver, giver den vært magt til at køre kode på siden. HTTPS beskytter filen på vej over nettet, men siger intet om, hvad værten valgte at sende i første omgang. Bliver der brudt ind i CDN'ets lager, bliver en konto, der udgiver til det, overtaget, eller bliver filen bag en velkendt adresse skiftet ud i stilhed, så kører hver side, der henter den, den nye kode med sidens fulde myndighed. Sidens egen kode har ingen mulighed for at se forskel.

SRI flytter den beslutning tilbage til siden. Hashværdien beregnes af sitets ejer over en fil, de har læst eller bygget, og den rejser inde i siden fra sitets egen server. En vært, der sender noget andet, får sin fil afvist i stedet for kørt. Siden mister en funktion, indtil nogen kigger efter, og det er en synlig fejl med en åbenlys årsag i stedet for en andens kode, der kører i stilhed.

Hashværdien låser også en version fast. En adresse som `/lib/latest.js` kan begynde at levere en ny udgave under en side når som helst, men hashværdien følger ikke med. En opgradering, ejeren aldrig valgte, bliver til en afvisning på ét bestemt element, meldt via en error-hændelse.

Det er værd at være præcis om, hvad SRI ikke gør. Den tjekker en fil mod en hashværdi, men den vurderer ikke, om filen er sikker. En hashværdi af et bibliotek, der allerede indeholder en fjendtlig linje, beskytter trofast den fjendtlige linje. Den lader inline-script være, for det er en opgave for en Content Security Policy. Og den stoler på den side, der bærer værdien, så selve siden skal stadig nå frem uændret.

## Sådan ser det ud i praksis

Dette site bruger det på sit eget stilark. Sikkerhedssiden nævner Subresource Integrity på stilarket: bundtet får et fingeraftryk og en hash, når sitet bygges, så læserens browser kan verificere, at det kom frem uændret. Der offentliggøres ingen JavaScript, som kan køres, og der er ingen tredjepartsforespørgsler. En læser, der tæller værterne i browserens netværksfane, finder én, sitets egen.

Kolofonen beskriver den samme fil fra byggets side, som ét CSS-bundt, samlet og fingeraftrykt ved bygning og leveret med en SRI-hash. Fingeraftrykket lægger en hash af filens indhold ind i dens navn, så et ændret stilark får en ny adresse, og en browser aldrig forveksler en gammel kopi i cachen med den gældende. Integritetsværdien lader samtidig browseren tjekke de bytes, der ligger bag adressen. Bygget laver begge dele ud fra de samme bytes i samme trin, så hver udgivelse sender stilarket og dets hashværdi af sted sammen, og den hyppigste fejl nedenfor, en fil der ændres efter hashingen, har meget lidt plads til at opstå.

## Hvor det går galt

Noget mellem buildet og browseren omskriver filen. Et CDN, der minificerer scripts, en proxy, der indsætter noget i svarindholdet, eller et udrulningstrin, der omskriver en fil efter hashberegningen, ændrer indholdets bytes, og browseren afviser resultatet, selv om ingen har angrebet noget. Genkomprimering med gzip eller Brotli, som bevarer indholdet, skaber ikke den uoverensstemmelse: kontrollen bruger det afkodede svarindhold, ikke de komprimerede bytes, der sendes over netværket. Specifikationen lægger ansvaret hos mellemled, der ændrer indholdet: de skal holde hashværdien i trit med det, de leverer, eller levere originalen urørt, og den server, der leverer filen, bør sende `Cache-Control: no-transform` for at bede dem lade den være. Den sikre rækkefølge er at tage hashværdien til sidst, over præcis de bytes i det afkodede indhold, som browseren kontrollerer.

En fil fra en anden oprindelse kommer uden CORS. Specifikationen kræver, at et integritetstjek af en fil fra en anden oprindelse bruger CORS, og kalder et forsøg uden det en logisk fejl. Elementet kan for eksempel bruge `crossorigin="anonymous"`, og værten skal svare med en header, der tillader deling af filen. `crossorigin="use-credentials"` bruger også CORS, med serverheadere, der udtrykkeligt tillader den forespørgende oprindelse og legitimationsoplysninger. Uden en CORS-forespørgsel og en tilsvarende politik på serveren blokerer browseren filen i stedet for at indlæse den uden kontrol. Reglen beskytter andre sites: uden den kunne en angriber indlæse et privat svar med en gættet hashværdi og ud fra udfaldet lære for eksempel, om læseren er logget ind dér.

Hashværdien kommer over almindelig HTTP. SRI beskytter en side mod en kompromitteret filvært, aldrig mod nogen på netværksvejen. På en side, der leveres uden HTTPS, kan den, der kan omskrive filen undervejs, lige så godt omskrive eller slette hashværdien i siden, så specifikationen anbefaler kun at levere integritetsdata til en sikker kontekst.

Hashfunktionen er en, browseren springer over. Specifikationen kender kun SHA-256, SHA-384 og SHA-512 og anbefaler, at browsere afviser kendt svage funktioner som MD5 og SHA-1. Overraskelsen er, hvad der sker med en værdi uden for den liste: browseren ignorerer den, og en attribut, der kun består af ignorerede værdier, regnes for slet ikke at have nogen metadata, så filen indlæses ukontrolleret. Et byggeværktøj, der kan lave fingeraftryk med MD5, som Hugos kan, gør det let at sende sådan en værdi ud ved et uheld.

En afvist fil trækker siden med sig. Når tjekket fejler, sender browseren en error-hændelse på elementet, og scriptet eller stilarket mangler simpelthen. For et bibliotek, siden ikke kan køre uden, foreslår specifikationen at fange hændelsen og hente en reservekopi fra en betroet, om end langsommere, kilde, fx sitets egen server. Uden en sådan reserve virker beskyttelsen som tiltænkt, og læseren får alligevel en ødelagt side.

Kun de elementer, der bærer en hashværdi, bliver tjekket. En `integrity`-attribut på ét script siger intet om det næste, som nogen tilføjer uden, og en gennemgang af de scripts, der har en, afslører aldrig det, der mangler den. Udkastet tilføjer en svarheader, der dækker det fra serverens side. `Integrity-Policy` med `blocked-destinations=(script)` blokerer hvert eksternt script, der kommer uden integritetsdata, og `Integrity-Policy-Report-Only` lister dem først, så de kan rettes, før noget bliver blokeret.

## Læs mere
* Subresource Integrity — det gældende udkast med verifikationsalgoritmen, `Integrity-Policy`-headerne og noterne om proxyer, almindelig HTTP og lækager på tværs af oprindelser.
* Subresource Integrity, W3C-anbefaling 2016 — første udgave, den stabile anbefaling, som udkastet voksede ud af.
* Fetch Standard — hvor en forespørgsels integritetsdata tjekkes mod svarets indhold, og CORS-protokollen, som et tjek på tværs af oprindelser afhænger af.
* Hugo: resources.Fingerprint — hvordan en statisk sitegenerator laver fingeraftryk af en fil ved bygning og giver den tilhørende integritetsværdi tilbage.
* FIPS 180-4, Secure Hash Standard — den amerikanske føderale standard, der definerer SHA-256, SHA-384 og SHA-512.

=> /da/security/ Sikkerhedssiden
=> /da/credits/ Kolofonen
=> https://www.w3.org/TR/SRI/ Subresource Integrity
=> https://www.w3.org/TR/2016/REC-SRI-20160623/ Subresource Integrity, W3C-anbefaling 2016
=> https://fetch.spec.whatwg.org/ Fetch Standard
=> https://gohugo.io/functions/resources/fingerprint/ Hugo: resources.Fingerprint
=> https://csrc.nist.gov/pubs/fips/180-4/upd1/final FIPS 180-4, Secure Hash Standard

=> https://engineer.company/da/glossary/sri/ Denne side på nettet
