mitmario.dev

Cookies

Node.js Sandbox 4 Min Lesezeit 4 BeispieleLektion 3 von 6

Zwei Anfragen desselben Menschen sehen für einen Server aus wie die Anfragen zweier Fremder. HTTP behält nichts. Wer sich auch nur eine Themenwahl merken will, braucht etwas, das bei jeder Anfrage desselben Besuchers wieder mitkommt.

Der Zettel, den der Browser verwahrt

Ein Cookie ist die einfachste Antwort darauf. Der Server hängt an eine Antwort die Kopfzeile Set-Cookie, und der Browser merkt sich das Paar. Ab da schickt er es bei jeder weiteren Anfrage an dieselbe Adresse in der Kopfzeile Cookie wieder mit.

Setzen, zurückbekommen, lesen
import express from "express";

const app = express();

app.get("/einstellen", (req, res) => {
  res.cookie("thema", "dunkel", { httpOnly: true, sameSite: "lax" });
  res.end();
});

app.get("/", (req, res) => {
  // Roh kommt alles in einer einzigen Kopfzeile an.
  const roh = req.headers.cookie ?? "";

  const cookies = Object.fromEntries(
    roh
      .split(";")
      .map((teil) => teil.trim().split("="))
      .filter((paar) => paar.length === 2)
  );

  res.type("text/plain").send(
    `req.headers.cookie: ${req.headers.cookie}\n` +
      `zerlegt:            ${JSON.stringify(cookies)}\n` +
      `cookies.thema:      ${cookies.thema}\n`
  );
});

app.listen(3000);

Gesetzt wird mit res.cookie(name, wert, optionen). Gelesen wird hier von Hand, und daran ist nichts Besonderes. req.headers.cookie ist ein Text mit allen Cookies, getrennt durch Strichpunkte, und ein split mit einem trim macht ein Objekt daraus.

Für einfache Werte wie dunkel reichen diese paar Zeilen. Steht im Wert selbst ein =, fällt das Cookie am paar.length === 2 durch, und kodierte Zeichen wie %20 bleiben kodiert. Für solche Werte gibt es Pakete, die beim Zerlegen auch daran denken.

Der Befehl mit sid=abc123; thema=dunkel; sprache=de schickt drei Cookies, und nur eins davon gehört zu dieser Route. Ein Browser sammelt sie mit der Zeit. Deshalb sucht die Route sich das richtige heraus, statt die Zeile als Ganzes zu vergleichen. curl schickt die Kopfzeile nur mit, weil sie im Befehl steht. Ein Browser merkt sich den Zettel von selbst, und im Reiter Browser läuft ein echter Browser.

Der Zettel, den dein eigener Browser behält
import express from "express";

const PORT = Number(process.env.PORT ?? 3000);

const app = express();
const THEMEN = { hell: ["#ffffff", "#111111"], dunkel: ["#111111", "#f5f5f5"] };

function leseCookies(kopf) {
  return Object.fromEntries(
    (kopf ?? "")
      .split(";")
      .map((teil) => teil.trim().split("="))
      .filter((paar) => paar.length === 2)
  );
}

app.get("/einstellen", (req, res) => {
  const thema = req.query.thema;
  if (THEMEN[thema]) res.cookie("thema", thema, { httpOnly: true, sameSite: "lax" });
  res.redirect(303, "/");
});

app.get("/", (req, res) => {
  const thema = leseCookies(req.headers.cookie).thema ?? "hell";
  const [grund, schrift] = THEMEN[thema] ?? THEMEN.hell;

  res.send([
    "<!doctype html>",
    '<meta charset="utf-8">',
    "<title>Thema</title>",
    `<body style="background:${grund};color:${schrift};font-family:sans-serif">`,
    `<h1>Aktives Thema: ${thema}</h1>`,
    `<p>Dein Browser hat geschickt: <code>${req.headers.cookie ?? "gar nichts"}</code></p>`,
    '<p><a href="/einstellen?thema=hell">hell</a> · <a href="/einstellen?thema=dunkel">dunkel</a></p>',
  ].join("\n"));
});

app.listen(PORT);

Ein Klick auf „dunkel“ färbt die Seite dunkel, und darunter siehst du, was dein Browser geschickt hat. Nach Seite neu laden bleibt sie dunkel, denn das Cookie geht bei jeder Anfrage wieder mit.

Alles Weitere steht in derselben Zeile

Was Set-Cookie außer Name und Wert noch trägt, sind Anweisungen an den Browser. Sie sagen ihm, wie er mit dem Zettel umgehen soll.

Dieselbe Zeile mit vier Einstellungen
import express from "express";

const app = express();

const faelle = [
  ["ohne Attribute      ", {}],
  ["HttpOnly, SameSite  ", { httpOnly: true, sameSite: "lax" }],
  ["dazu Secure, Strict ", { httpOnly: true, secure: true, sameSite: "strict" }],
  ["mit einer Stunde    ", { httpOnly: true, sameSite: "lax", maxAge: 3600000 }],
];

faelle.forEach(([, optionen], i) => {
  app.get(`/fall-${i}`, (req, res) => {
    res.cookie("thema", "dunkel", optionen);
    res.end();
  });
});

app.listen(3000);

Diese Antworten haben keinen Rumpf, alles Wichtige steht in der Kopfzeile. Im Terminal zeigt curl -si sie für /fall-0 und /fall-3, und mit /fall-1 oder /fall-2 am Ende holt derselbe Befehl die beiden anderen. Jede Angabe darin schützt vor etwas anderem.

  • HttpOnly nimmt dem JavaScript im Browser den Zugriff, document.cookie sieht dieses Cookie dann nicht mehr. Wer über eine Lücke fremdes JavaScript auf deiner Seite ausführen kann, kommt damit trotzdem nicht an das Cookie heran. Von den vier ist das die wichtigste.
  • Secure heißt, nur über HTTPS mitschicken. Ohne diese Angabe wandert das Cookie auch über eine unverschlüsselte Verbindung, und da liest jeder im selben WLAN mit. In den übrigen Beispielen fehlt sie, obwohl sie auch hier nichts stören würde. Auf einem echten Server mit HTTPS gehört sie dazu.
  • SameSite=Lax lässt das Cookie weg, wenn eine fremde Seite etwas an deinen Server schickt, ein Formular per POST, ein fetch, ein Bild, ein eingebetteter Rahmen. Nur wer von dort einem gewöhnlichen Link folgt, bringt es mit. Strict lässt es auch dann weg, Lax ist der brauchbare Mittelweg. Ohne Angabe entscheidet jeder Browser selbst, und sie entscheiden verschieden. Deshalb schreibe ich es immer hin.
  • Max-Age gibt eine Lebensdauer in Sekunden. In res.cookie() heißt die Option maxAge und rechnet in Millisekunden, deshalb steht im Beispiel 3600000 für eine Stunde. Wer 3600 schreibt, bekommt Max-Age=3, also drei Sekunden. Ohne die Angabe lebt das Cookie nur, solange der Browser offen ist.

Im letzten Fall schreibt Express Max-Age und ein daraus errechnetes Expires in die Zeile, und beide stehen vor HttpOnly. Dem Browser ist die Reihenfolge der Angaben egal. Nur wer die ganze Zeile als Text vergleicht, stolpert darüber.

Der Zettel liegt beim Besucher

Was der Server in ein Cookie schreibt, liegt danach beim Besucher, und der kann es umschreiben.

Das Cookie, das der Besucher selbst schreibt
import express from "express";

const app = express();

// So nicht: die Berechtigung steht im Cookie, und das Cookie gehoert
// dem Besucher.
app.get("/intern", (req, res) => {
  const cookies = Object.fromEntries(
    (req.headers.cookie ?? "")
      .split(";")
      .map((teil) => teil.trim().split("="))
      .filter((paar) => paar.length === 2)
  );

  if (cookies.rolle === "admin") {
    return res.type("text/plain").send("Willkommen im Adminbereich");
  }
  res.status(403).type("text/plain").send("Kein Zutritt");
});

app.listen(3000);

Ohne Rolle siehst du im Reiter Browser den Normalfall, „Kein Zutritt“. Mit -H "Cookie: rolle=admin" fragt curl dieselbe Adresse mit einer Rolle, die niemand vergeben hat, und bekommt Willkommen im Adminbereich.

Der Server glaubt, was im Cookie steht, und im Cookie steht, was der Besucher hineinschreibt. In den Entwicklerwerkzeugen des Browsers stehen alle Cookies einer Seite, und den Wert kann man dort einfach ändern, ganz ohne Zusatzprogramm und ohne besonderes Wissen.

Ein Cookie mit rolle=admin beweist also nichts. Es lädt höchstens zum Ausprobieren ein. Dasselbe gilt für preis=0, rabatt=90 und nutzer_id=1. Hinein darf alles, dessen Fälschung dir egal sein kann, also eine Themenwahl, eine Spracheinstellung oder ein weggeklickter Hinweis.

Für alles andere gibt es zwei Wege. Entweder du unterschreibst den Inhalt, und dann fällt jede Änderung auf. Oder im Cookie steht nur eine zufällige Kennung, und die Daten bleiben beim Server. Der zweite Weg ist der übliche.

In der Aufgabe legt ein Server die Wahl zwischen hell und dunkel in einem Cookie ab und liest sie bei jedem Besuch wieder.

Zum Mitnehmen

Ein Cookie hält zwischen zwei Anfragen etwas fest, was der Server sich sonst nicht merkt. HttpOnly, Secure, SameSite und Max-Age sagen dem Browser, wie er damit umgehen soll. Der Besucher kann den Wert jederzeit ändern, also gehört nichts hinein, dessen Fälschung zählt.

Jetzt du

Basis Konto, kostenlos

Zu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.

Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.

In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.

Was in dieser Lektion steckt

  • Artikel mit 4 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe, dein Code läuft auf einem Server

    Öffnet sich mit dem Basis Konto.