mitmario.dev

Eingaben sind nie vertrauenswürdig

Node.js Sandbox 4 Min Lesezeit 3 BeispieleLektion 1 von 8

?rolle=admin an eine Adresse zu hängen, kostet keine Mühe und keine Berechtigung. Eine Route, die diese Angabe glaubt, macht jeden zum Admin, der es einmal ausprobiert. Was in einer Anfrage steht, hat ihr Absender geschrieben, jedes Byte davon. Er hätte genauso gut etwas anderes schreiben können.

Was an einer Anfrage vom Aufrufer kommt

Beim Wort Eingabe denkt man zuerst an die Formularfelder. Die sind nur ein kleiner Teil davon.

Alles, was der Aufrufer bestimmt
import express from "express";

const app = express();
app.use(express.urlencoded({ extended: true }));

app.all("/konto/47", (req, res) => {
  // Nichts davon hat der Server bestimmt. Alles kam mit der Anfrage,
  // und deshalb steht hier alles in der Antwort.
  res.type("text/plain").send(
    [
      `Methode        ${req.method}`,
      `Pfad           ${req.path}`,
      `Query          ${JSON.stringify(req.query)}`,
      `Content-Type   ${req.headers["content-type"]}`,
      `Cookie         ${req.headers.cookie}`,
      `Referer        ${req.headers.referer}`,
      `User-Agent     ${req.headers["user-agent"]}`,
      `X-Rolle        ${req.headers["x-rolle"]}`,
      `Rumpf          ${JSON.stringify(req.body)}`,
    ].join("\n") + "\n"
  );
});

app.listen(3000);

Der Server nimmt eine einzige Anfrage entgegen und schreibt in die Antwort, was daran angekommen ist. Neun Zeilen, und keine davon hat der Server bestimmt. Es sind die Methode, der Pfad, jeder Query-Parameter, der Content-Type, das Cookie, der Referer, der User-Agent, eine frei erfundene Kopfzeile namens X-Rolle und der Rumpf. Dazu kommen noch die Länge und die Reihenfolge. Nichts davon ist geprüft, nur weil es angekommen ist.

Im Reiter Browser siehst du, was der eigene Aufruf des Browsers mitgebracht hat. Der Befehl mit X-Rolle: chef in der Befehlsleiste schickt einen eigenen Parameter, zwei eigene Kopfzeilen und ein Cookie mit, und im Terminal steht eine andere Liste. Drei Zeilen darin sehen aus wie Angaben, die jemand anderes als der Aufrufer gemacht hat:

  • Der Referer soll sagen, von welcher Seite jemand kommt. Geschrieben hat ihn der Aufrufer, und nach diesem Befehl steht darin eine Adresse, die es gar nicht gibt.
  • Der User-Agent nennt das Programm, als das sich der Aufrufer ausgibt.
  • Ein Cookie namens sid sieht aus wie eine Sitzungskennung. Eine ist es erst, wenn der Server sie selbst ausgestellt hat, und sid=ich-bin-die-chefin hat er nie ausgestellt.

Dahinter steckt der Gedanke „Das schickt ja mein Frontend so“. Das stimmt und hilft nichts, denn zwischen dem Frontend und dem Server steht nichts, was das erzwingt. Ein curl-Aufruf, die Entwicklerwerkzeuge des Browsers oder ein Skript mit zwanzig Zeilen kommen an derselben Stelle an, ohne das Formular je gesehen zu haben. Das Frontend macht ehrlichen Nutzern das Leben leichter. Aufhalten kann es niemanden.

Aufzählen, was erlaubt ist

Eine Liste dessen, was erlaubt ist, heißt Allowlist, eine Liste dessen, was verboten ist, Blocklist.

Blocklist gegen Allowlist
// Zwei Wege, einen Formatwunsch zu prüfen. Der eine zählt auf, was
// verboten ist, der andere, was erlaubt ist.
const VERBOTEN = [".exe", ".sh", ".bat"];
const ERLAUBT = ["text", "csv"];

function mitBlocklist(wunsch) {
  return VERBOTEN.some((endung) => wunsch.endsWith(endung)) ? "abgewiesen" : `angenommen: ${wunsch}`;
}

function mitAllowlist(wunsch) {
  return ERLAUBT.includes(wunsch) ? `angenommen: ${wunsch}` : "abgewiesen";
}

for (const wunsch of ["csv", "bericht.exe", "bericht.EXE", "bericht.exe.", "bericht.cmd", "../../etc/passwd"]) {
  console.log(`${wunsch.padEnd(20)} Blocklist: ${mitBlocklist(wunsch).padEnd(28)} Allowlist: ${mitAllowlist(wunsch)}`);
}

Die Blocklist kennt drei verbotene Endungen, die Allowlist zwei erlaubte Werte. Die Blocklist fängt einen der fünf Angriffe. Für die vier anderen braucht es keine Kunststücke. Es reichen Großschreibung, ein Punkt am Ende, eine Endung, an die niemand gedacht hat, und ein Pfad, der gar keine Datei im eigenen Ordner meint.

Für jeden dieser Fälle lässt sich eine Regel nachschieben, und beim nächsten Mal fällt jemandem der übernächste ein. Das Spiel kannst du nicht gewinnen, denn die Liste tritt gegen eine unendliche Menge an.

Die Allowlist tritt gegen zwei Werte an. Sie weist alles ab, was sie nicht kennt, auch das, woran niemand gedacht hat. Muss sie später wachsen, merkst du das sofort, weil etwas Erlaubtes abgewiesen wird. Bei einer Blocklist merkst du gar nichts.

Dieselbe Regel gilt für Felder. Wer den ganzen Rumpf einer Anfrage in ein Datenbankobjekt kippt, hat gerade jedem Aufrufer erlaubt, ein Feld mitzuschicken, an das niemand gedacht hat. rolle, zum Beispiel.

Eine Zahl ist erst eine Zahl, wenn du sie geprüft hast

Query-Parameter kommen als Text an. Aus Text wird schnell eine Zahl, und dabei geht mehr schief, als es aussieht.

Die Zahl, die keine ist
import express from "express";

const app = express();

app.get("/seite", (req, res) => {
  const roh = req.query.nr;
  const zahl = Number(roh ?? 1);
  const geprueft = Number.isInteger(zahl) && zahl >= 1 && zahl <= 3;
  res.type("text/plain").send(`${JSON.stringify(roh)} wird mit Number() zu ${zahl}, geprüft: ${geprueft}\n`);
});

app.listen(3000);

Gutartig sind nur ?nr=2 und die Anfrage ganz ohne Nummer. Bei allen anderen hilft Number() allein in keinem Fall. Eine negative Zahl bleibt eine Zahl. "abc" wird zu NaN, und NaN ist weder kleiner noch größer als irgendetwas. Ein if (zahl > 3), das zu große Seiten abweisen soll, lässt es still durch. "2.5" ist eine gültige Zahl und trotzdem keine Seitennummer. "1e3" ist tausend, geschrieben von jemandem, der etwas vorhat.

Ein leerer Wert wird zu 0 und nicht zu NaN. Das ist der unangenehmste Fall, weil die Null wie eine echte Zahl aussieht.

Derselbe Parameter zweimal in der Adresse ergibt in Express ein Array statt eines Textes, und Number() macht daraus NaN. Wer auf dem Array .trim() aufruft, bekommt einen TypeError, und Express antwortet mit 500.

Die Prüfung, die alle acht richtig einordnet, steht im Code: Number.isInteger(zahl) && zahl >= 1 && zahl <= 3. Sie lässt die drei Seiten durch, die es gibt, und sonst nichts. Für Zahlen ist das dieselbe Allowlist, nur als Bereich geschrieben.

Die Systemgrenze

Geprüft wird an der Systemgrenze (englisch trust boundary), also an der Stelle, an der etwas von außen hereinkommt. Dort wird jede Eingabe einmal geprüft, und dahinter arbeitet der Code mit dem Ergebnis, statt in jeder Funktion dieselbe Frage noch einmal zu stellen. Eine Prüfung weiter innen kommt zu spät, wenn vorher schon jemand mit dem ungeprüften Wert gearbeitet hat.

An der Grenze kommt zuerst die Frage, wer da fragt. Dann, ob er das darf, und zuletzt, ob sein Wunsch Sinn ergibt. Wer die Reihenfolge dreht, prüft Zahlen für jemanden, den er noch gar nicht kennt.

In der Aufgabe glaubt die Route /bericht dem Aufrufer alles, was er in die Adresszeile schreibt.

Zum Mitnehmen

Methode, Pfad, Kopfzeilen, Cookie und Rumpf einer Anfrage hat ihr Absender geschrieben, auch wenn sie nach dem eigenen Frontend aussehen. Geprüft wird einmal an der Systemgrenze, gegen eine Liste dessen, was erlaubt ist.

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 3 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe, dein Code läuft auf einem Server

    Öffnet sich mit dem Basis Konto.