Blog ·
Wie die lokale Verbindung geschützt ist
Die Oberfläche von Blocknotik ist eine Webseite, die das Programm unter 127.0.0.1 ausliefert. Andere Rechner erreichen diese Adresse nicht – aber jede Website, die in Ihrem Browser offen ist, kann es versuchen. Eine Seite irgendwo im Netz kann Ihren Browser anweisen, Anfragen an http://127.0.0.1:41873/… zu schicken. Würde das lokale Programm darauf antworten, könnte diese Seite Ihre Notizen lesen oder ändern.
Das ist eine bekannte Klasse von Problemen lokaler Server, deshalb wurde Blocknotik von der ersten Zeile an mit Blick darauf gebaut. Das hier ist umgesetzt.
1. Nur auf 127.0.0.1 lauschen
Der Server bindet sich an die Loopback-Adresse, nicht an alle Netzwerkschnittstellen. Niemand sonst in Ihrem WLAN oder Büronetz kann sich verbinden, ganz ohne Firewall-Regeln. Der Port wird bei jedem Start zufällig gewählt, sofern Sie keinen festlegen.
2. Ein Sitzungsschlüssel, den andere Seiten nicht haben
Beim Start erzeugt das Programm einen zufälligen 256-Bit-Schlüssel und öffnet den Browser unter /auth?token=…. Diese Adresse legt den Schlüssel in einem Cookie ab (HttpOnly, SameSite=Strict) und leitet auf die Hauptseite weiter – der Schlüssel verschwindet so aus der Adresszeile.
Die Hauptseite wird nur ausgeliefert, wenn dieses Cookie vorhanden ist. Sie enthält den Schlüssel in einem <meta>-Tag, und ihr Skript schickt ihn bei jeder API-Anfrage in einem eigenen Header mit, X-Blocknotik-Token.
Der entscheidende Punkt: Die API ignoriert das Cookie und akzeptiert nur den Header. Eine fremde Seite kann Ihren Browser dazu bringen, bei einer Anfrage Cookies mitzuschicken, aber sie kann einer Anfrage an einen anderen Ursprung ohne dessen ausdrückliche Erlaubnis (CORS) keine eigenen Header hinzufügen – und Blocknotik erteilt diese Erlaubnis nie. Eine gefälschte Anfrage von einer anderen Seite kommt also ohne Schlüssel an und erhält 401.
3. Prüfen, wer fragt
Jede Anfrage durchläuft drei weitere Prüfungen:
- Host. Der
Host-Header muss127.0.0.1:PORToderlocalhost:PORTlauten. Das verhindert DNS-Rebinding, bei dem eine Domain eines Angreifers auf127.0.0.1zeigt, damit der Browser sie als dieselbe Website behandelt. - Origin. Gibt der Browser an, woher eine Anfrage kommt, muss das die Blocknotik-Seite selbst sein.
- Fetch-Metadaten. Anfragen, die der Browser als
cross-sitekennzeichnet, werden abgewiesen.
Anfragen, die etwas ändern, müssen außerdem JSON oder ein Datei-Upload sein. Ein einfaches HTML-Formular auf einer anderen Seite kann nur text/plain oder formularkodierte Daten senden und wird deshalb abgewiesen, bevor alles andere überhaupt eine Rolle spielt.
4. Pfade können den Ordner nicht verlassen
Jeder Notizname, der von der Seite kommt, wird geprüft, bevor er dem Dateisystem nahekommt: Er muss ein relativer Pfad mit der Endung .md sein, ohne .., ohne versteckte Ordner, ohne Zeichen oder Namen, die Windows besonders behandelt. Nach dem Zusammensetzen mit dem Notizordner löst das Programm symbolische Links auf und prüft erneut, ob das Ergebnis noch darin liegt. ZIP-Archive durchlaufen beim Import dieselbe Bereinigung, sodass ein Archiv mit ../../irgendwas nichts außerhalb des Ordners schreiben kann.
5. Aus Notizen wird nichts ausgeführt
Das Programm wandelt Markdown selbst in HTML um und maskiert dabei jedes Stück Text. In einer Notiz geschriebenes HTML erscheint als Text. Links entstehen nur für Adressen mit http, https und mailto; javascript:- und data:-Links fallen weg. Bilder werden nur aus dem Notizordner geladen.
Dazu trägt jede Antwort eine strenge Content-Security-Policy: Skripte nur vom Programm selbst, keine Inline-Skripte, keine Verbindungen anderswohin, keine Einbettung in Frames. Selbst wenn etwas am Renderer vorbeirutschte, würde der Browser es nicht ausführen und keine Daten anderswohin schicken.
Wovor es nicht schützt
Programme, die unter Ihrem eigenen Benutzerkonto laufen, können Ihre Notizen direkt von der Festplatte lesen, und sie könnten den Sitzungsschlüssel aus der Konsolenausgabe des Programms lesen. Das ist die übliche Grenze jeder Desktop-Anwendung: Schutz vor anderen Benutzern und anderen Websites, nicht vor Software, die Sie schon hereingelassen haben.
Getestet, nicht nur beschrieben
Die Testsuite schickt Anfragen ohne Schlüssel, mit falschem Schlüssel, nur mit dem Cookie, mit fremdem Host, fremdem Origin, mit text/plain-Inhalt und mit Notiznamen wie ../x.md und .trash/x.md und prüft, dass jede davon abgewiesen wird. Der Browser-Durchlauf mit dem Linux-Build wiederholt die wichtigsten davon am echten Programm. Der Code steht in server.go und store.go im Quellcode-Archiv.