Abschnitt 13 · Lektion 3
Cookies
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.
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.
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.
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.
HttpOnlynimmt dem JavaScript im Browser den Zugriff,document.cookiesieht 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.Secureheiß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=Laxlässt das Cookie weg, wenn eine fremde Seite etwas an deinen Server schickt, ein Formular per POST, einfetch, ein Bild, ein eingebetteter Rahmen. Nur wer von dort einem gewöhnlichen Link folgt, bringt es mit.Strictlässt es auch dann weg,Laxist der brauchbare Mittelweg. Ohne Angabe entscheidet jeder Browser selbst, und sie entscheiden verschieden. Deshalb schreibe ich es immer hin.Max-Agegibt eine Lebensdauer in Sekunden. Inres.cookie()heißt die OptionmaxAgeund rechnet in Millisekunden, deshalb steht im Beispiel3600000für eine Stunde. Wer3600schreibt, bekommtMax-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.
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, kostenlosZu 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.