Programma Les 73 van 156 · Derden op je eigen site
Derden op je eigen site

Subresource Integrity

Waarom dit ertoe doet Wanneer je https://cdn.example/lib.js inbedt, vertrouw je op degene die die server vandaag en elke dag daarna beheert. Als het wordt gehackt, of als het bestand stilletjes wordt gewijzigd, voeren je bezoekers de nieuwe code op je site uit. Subresource Integrity zorgt ervoor dat de browser elke versie weigert die je niet hebt goedgekeurd.

Denk aan een verzegeling op een medicijnfles die breekt bij manipulatie. Je controleert de verzegeling voordat je iets doorslikt. Als deze gebroken is, neem je het niet, ongeacht wie het in het schap heeft gezet.

Subresource Integrity (SRI): een integrity attribuut op een <script> of <link rel="stylesheet"> tag die een hash bevat van het exacte bestand dat je verwacht. De browser hasht wat het downloadt en weigert het bestand te gebruiken als de hashes verschillen.

Hash: een functie die elke data omzet in een korte vingerafdruk met een vaste grootte. Dezelfde bytes geven altijd dezelfde vingerafdruk; verander één byte en de vingerafdruk verandert volledig. SHA-384 is de hash die het meest wordt gebruikt voor SRI.

Hoe de tag eruitziet

<script src="https://cdn.example/lib.js"
        integrity="sha384-iht3RcshTShmtRmXjSLQ8CjUTiVO41jHRJzgK44j1lSJHvfC4YAeuY4ZOoMtzhi5"
        crossorigin="anonymous"></script>

De waarde is de naam van het algoritme, een streepje, dan de hash geschreven in Base64 (een manier om bytes te schrijven met letters, cijfers, + en /). Het crossorigin="anonymous" deel is nodig voor bestanden van een andere site: de browser haalt ze op zonder cookies en de server moet dit toestaan met een Access-Control-Allow-Origin header, anders kan de controle niet draaien en wordt het bestand geblokkeerd. SRI werkt in alle belangrijke browsers (gecontroleerd oktober 2026).

Eén berekenen in Python

import base64, hashlib
data = b"console.log('hi')"
digest = hashlib.sha384(data).digest()          # 48 raw bytes
print("sha384-" + base64.b64encode(digest).decode("ascii"))

hashlib.new(name, data) doet hetzelfde voor elk algoritme dat door naam wordt gegeven, zoals "sha256" of "sha512". Let op .digest() (ruwe bytes, wat SRI wil) versus .hexdigest() (hex tekst, wat hier fout zou zijn).

Hoe de browser het controleert

  1. Splits het attribuut op spaties. Je mag meerdere hashes opsommen, bijvoorbeeld bij het wisselen van bestandsversies.
  2. Houd alleen tokens met een algoritme dat het kent vast: sha256, sha384, sha512. Negeer de rest. (Een token kan eindigen op ?options; laat dat deel weg.)
  3. Als er niets bruikbaars overblijft, doet het geen enkele check en gebruikt het bestand. Een typefout schakelt sha385-...daarom stilzwijgend de bescherming uit. Test altijd of een verkeerde hash het bestand echt blokkeert.
  4. Anders neem je het sterkste algoritme dat aanwezig is (sha512 verslaat sha384 verslaat sha256) en kijk je alleen naar tokens met dat algoritme. Als een van deze overeenkomt met de hash van het bestand, wordt het bestand gebruikt; als geen van deze overeenkomt, wordt het geblokkeerd.

Een veelvoorkomende misvatting: "SRI houdt het bestand privé". Het verbergt niets, en de derde partij ziet de aanvraag nog steeds. SRI garandeert alleen dat de code de code is die je hebt goedgekeurd. Het kan ook niet werken voor bestanden die constant veranderen, zoals een advertentiescript; voor die bestanden is het eerlijke antwoord vaak om ze niet in te bedden.

In andere talen
# Shell (OpenSSL)
openssl dgst -sha384 -binary lib.js | openssl base64 -A
// JavaScript (Node)
const crypto = require("crypto");
const sri = "sha384-" + crypto.createHash("sha384").update(fs.readFileSync("lib.js")).digest("base64");
// Go
sum := sha512.Sum384(data)
sri := "sha384-" + base64.StdEncoding.EncodeToString(sum[:])
// PHP
$sri = 'sha384-' . base64_encode(hash('sha384', $data, true));
// C#
var sri = "sha384-" + Convert.ToBase64String(SHA384.HashData(data));

Bundlers kunnen SRI voor je toevoegen (bijvoorbeeld de webpack-subresource-integrity plugin).

Samenvatting

  • SRI koppelt een ingebed script of stylesheet aan de exacte bytes die je hebt goedgekeurd.
  • De waarde is algorithm-Base64(hash), en cross-site bestanden hebben ook crossorigin="anonymous" nodig.
  • De browser gebruikt alleen het sterkste algoritme uit de lijst, en een attribuut zonder bruikbare inhoud betekent geen controle.
Jij bent aan de beurt

Schrijf drie functies:

  1. sri_hash(data, algorithm="sha384"): data zijn bytes. Geef de SRI-waarde terug: de naam van het algoritme, een koppelteken en de Base64 van de raw digest (gebruik hashlib.new(algorithm, data).digest() en base64.b64encode).
  2. verify_sri(data, integrity): check data zoals een browser dat doet. Split integrity op witruimte; houd tokens waarvan het deel voor de eerste - is sha256, sha384 of sha512 en waarvan de waarde niet leeg is, en gooi alles vanaf een ? weg. Als er niets wordt behouden, return True (no check). Gebruik anders alleen het sterkste algoritme dat aanwezig is en return True als een van de waarden overeenkomt met de hash van de data in dat algoritme, anders False.
  3. script_tag(url, data): retourneer exact <script src="URL" integrity="VALUE" crossorigin="anonymous"></script> met de sha384 waarde voor data.
Print de tag voor de oefenbibliotheek aan het einde. Tests gebruiken willekeurige data.

Een probleem ontdekt in deze les? Meld het · Vraag naar deze les

Deze oefening opent binnenkort

Maak de les ervoor af voordat deze wordt ontgrendeld. De hele cursus is gratis, geen account nodig, en je kunt deze les nu lezen.