8. Authentifizierung und Autorisierung
Bei jeder Anfrage stellen sich zwei getrennte Fragen:
- Wer ist der Benutzer? Das ist die Authentifizierung: Der Benutzer hat sich mit Benutzername und Passwort identifiziert, und jede weitere Anfrage muss belegen, dass sie von ihm stammt;
- Darf er auf diese Seite zugreifen? Das ist die Autorisierung: In der Fallstudie verwaltet nur ein Benutzer mit der Rolle ADMIN die Ärzte und Klienten.
Da der Server zustandslos ist (siehe das Kapitel über Gültigkeitsbereiche), muss der Identitätsnachweis jeder Anfrage beiliegen. Dazu dient ein Token namens JWT (*JSON Web Token*): Nach der Anmeldung erzeugt der Server ein Token, das die Identität des Benutzers enthält, und signiert es mit einem geheimen Schlüssel. Das Token wird in einem Cookie gespeichert; der Browser sendet es bei jeder Anfrage zurück; der Server prüft die Signatur. Der Benutzer kann sein Token lesen, aber nicht ändern: Jede Änderung macht die Signatur ungültig. Das ist dasselbe Prinzip wie bei der [Flask]-Session (Beispiel 20), jedoch mit einem standardisierten Format (RFC 7519), das alle Programmiersprachen verstehen, und mit einem im Token eingebetteten Ablaufdatum.
[Flask] hat keinen integrierten Sicherheitsmechanismus, anders als [Spring] ([Spring Security]) oder [ASP.NET Core]. Es gibt Erweiterungen ([Flask-Login], [Flask-JWT-Extended] ...), aber der Mechanismus ist einfach genug, um mit den Werkzeugen der vorherigen Kapitel von Hand geschrieben zu werden, was den Vorteil hat, dass er transparent bleibt:
- Die Authentifizierung übernimmt eine [before_request]-Funktion (vorheriges Kapitel), die das Token aus dem Cookie holt, prüft und den authentifizierten Benutzer in [g], dem Anfrageobjekt, ablegt;
- die Autorisierung übernehmen Dekoratoren, die auf die Aktionen angewendet werden ([@login_required], [@role_required("ADMIN")]) und wie der Dekorator [@with_language] in Beispiel 12 aufgebaut sind.
Es werden zwei Bibliotheken verwendet, die von der Datei [requirements.txt] der Beispiele installiert werden: [PyJWT], das Token erzeugt und prüft, und [bcrypt], das Passwörter hasht.
8.1. Beispiel 25: Anmeldung, Token, geschützte Seite
8.1.1. Konfiguration: config.py und app.py
Das Token wird mit einem geheimen Schlüssel signiert, der nicht fest im Code stehen darf. Es ist an der Zeit, die Konfiguration vom Code zu trennen:
Eine [Flask]-Konfigurationsdatei ist einfach ein [Python]-Modul: Ihre Variablen in Großbuchstaben werden zu Schlüsseln von [app.config]. [JWT_SECRET] ist der Schlüssel zum Signieren der Token; der Standard verlangt für den verwendeten Algorithmus (HMAC-SHA256) einen Schlüssel von mindestens 256 Bit, also 32 Byte. [JWT_DURATION_MINUTES] ist die Lebensdauer eines Tokens.
- Zeile 21: das Lesen der Konfigurationsdatei, angegeben durch einen Pfad relativ zum Ordner der Anwendung;
- Zeile 22: das Lesen der Umgebungsvariablen , deren Namen mit [FLASK_] beginnen: [FLASK_JWT_SECRET] ersetzt den Schlüssel [JWT_SECRET] der Datei. Der Wert einer Variablen wird, wann immer möglich, als JSON interpretiert ([FLASK_JWT_DURATION_MINUTES=30] ergibt die ganze Zahl 30). In der Produktion stellt die Umgebung den geheimen Schlüssel bereit, und die Datei enthält nur einen Entwicklungswert;
- Zeilen 24–26: die beiden Authentifizierungsservices, von denen der zweite den Schlüssel und die Lebensdauer des Tokens erhält;
- Zeile 32: die Registrierung der [before_request]-Funktion, die das Token liest.
Unter [Linux] oder [macOS] würde die Anwendung wie folgt mit einem anderen Schlüssel gestartet:
und unter [Windows] (PowerShell):
8.1.2. Benutzer: auth/users.py
- Zeilen 9–13: ein Benutzer: sein Login, Name, seine Rolle und der Hash seines Passworts. Ein Server speichert niemals ein Passwort, auch nicht verschlüsselt: Würde die Datenbank gestohlen, wären auch die Passwörter gestohlen (und viele Menschen verwenden überall dasselbe Passwort). Er speichert das Ergebnis einer Hashfunktion, einer Einwegfunktion: Man kann den Hash eines Passworts berechnen, aber aus dem Hash kein Passwort zurückgewinnen. Um ein eingegebenes Passwort zu prüfen, berechnet man seinen Hash und vergleicht ihn mit dem gespeicherten;
- Zeilen 18–19: das Hashen mit dem Algorithmus [bcrypt], der für Passwörter entwickelt wurde. Er hat zwei Besonderheiten. Er ist absichtlich langsam, mit einstellbarer Langsamkeit (der Parameter [rounds] oder Kostenfaktor: 2^10 Berechnungsrunden): einige zehn Millisekunden, für einen Benutzer nicht wahrnehmbar, aber für einen Angreifer, der Milliarden von Passwörtern ausprobieren will, sehr kostspielig. Er verwendet ein Salt: [gensalt] erzeugt zufällig ein Salt, mischt es vor dem Hashen mit dem Passwort und speichert es im Hash selbst; so haben zwei Benutzer mit demselben Passwort unterschiedliche Hashes. [bcrypt] arbeitet mit Bytes: [encode()] wandelt die Zeichenkette in Bytes um ([UTF-8]). Er berücksichtigt nur die ersten 72 Bytes eines Passworts, und Version 5 der Bibliothek weist längere Passwörter zurück (die Fallstudie berücksichtigt das);
- Zeilen 26–28: zwei Testbenutzer, im Arbeitsspeicher abgelegt und in einem Wörterbuch organisiert, das bei der Verarbeitung aufgebaut wird ([{key: value for ...}]). Beispiel 28 und die Fallstudie speichern sie in einer Datenbank.
8.1.3. Der Authentifizierungsservice: auth/service.py
- Zeilen 24–31: die Prüfung von Benutzername und Passwort. [bcrypt.checkpw] hasht das eingegebene Passwort mit dem Salt des gespeicherten Hashs und vergleicht die beiden Hashes. Ein unbekannter Benutzername und ein falsches Passwort liefern dasselbe Ergebnis, [None];
- Zeilen 34–44: das Erzeugen des Tokens. Sein Inhalt ist ein Wörterbuch von Claims über den Benutzer. Einige haben standardisierte Namen: [sub] (*subject*), die Kennung des Benutzers; [iat] (*issued at*), das Erstellungsdatum; [exp] (*expiration*), das Ablaufdatum. Die übrigen sind frei wählbar: hier der Name und die Rolle. [jwt.encode] erzeugt das Token und signiert es mit dem Algorithmus [HS256] (HMAC-SHA256, eine Signatur mit einem gemeinsamen geheimen Schlüssel). Datumsangaben müssen zeitzonenbehaftete Datumsangaben sein: [datetime.now(timezone.utc)];
- Zeilen 48–30: die Prüfung des Tokens. [jwt.decode] prüft die Signatur und das Ablaufdatum und liefert dann die Claims. Jede Auffälligkeit (gefälschtes, abgelaufenes oder fehlerhaftes Token) löst eine Ausnahme aus der Familie [InvalidTokenError] aus. Der Parameter [algorithms] legt die akzeptierten Algorithmen fest: Ohne ihn könnte ein Angreifer ein Token erstellen, das einen anderen Algorithmus (oder gar keinen, [none]) angibt.
8.1.4. Sicherheit: auth/security.py
- Zeilen 13–15: Vor jeder Aktion wird das Token des Cookies geprüft; [g.user] enthält die Claims eines gültigen Tokens oder [None]. Diese Funktion weist nichts zurück: Sie stellt fest, wer der Benutzer ist. Das ist die Authentifizierung;
- Zeilen 20–31: der Dekorator, der einen authentifizierten Benutzer verlangt. Bei einem anonymen Besucher liefert er nicht die Aktion zurück, sondern leitet auf die Anmeldeseite um. Hat der Browser ein Cookie gesendet, bedeutet das, dass das Token ungültig ist (abgelaufen oder gefälscht): Wir nutzen die Gelegenheit, es zu löschen ([delete_cookie] sendet ein leeres, bereits abgelaufenes Cookie).
8.1.5. Die Controller
- Zeilen 20–26: die Anmeldung. Schlägt sie fehl, wird das Formular mit dem eingegebenen Benutzernamen und einer bewusst vagen Meldung erneut angezeigt: Die Angabe „unbekannter Benutzername“ würde einem Angreifer verraten, welche Benutzernamen existieren;
- Zeilen 27–32: Bei Erfolg wird das Token in einem Cookie gespeichert, mit einer Umleitung auf die geschützte Seite (PRG-Muster). Das Cookie ist [httponly]: Das [JavaScript] der Seite kann es nicht lesen, was das Token vor Skript-Injektion (XSS) schützt; es ist [samesite="Lax"]: Der Browser sendet es nicht bei einer POST-Anfrage, die von einer anderen Website stammt, was die Anwendung vor CSRF-Angriffen schützt (Beispiel 18); seine Lebensdauer ([max_age], das ein [timedelta] akzeptiert) entspricht der des Tokens. In der Produktion würden wir bei HTTPS [secure=True] hinzufügen: Das Cookie würde dann nie über eine unverschlüsselte Verbindung gesendet;
- Zeilen 38–41: Das Abmelden löscht das Cookie. Dies ist eine POST-Aktion: Ein einfacher Link auf [/logout], der auf einer anderen Website oder in einem Bild platziert wird, kann den Benutzer nicht ohne sein Wissen abmelden. Beachten Sie eine Einschränkung von Token: Das Token selbst bleibt gültig, bis es abläuft. Wer eine Kopie davon angefertigt hat, könnte es weiterhin verwenden. Deshalb ist ihre Lebensdauer begrenzt.
- Zeile 10: Die Seite ist geschützt;
- Zeile 13: Die Aktion verwendet [g.user] und stellt sicher, dass es nicht [None] ist.
8.1.6. Die Views
- Zeile 8: Das eingegebene Login wird nach einem Fehlschlag erneut angezeigt; der Ausdruck [login or ''] ergibt eine leere Zeichenkette, wenn [login] [None] ist (oder fehlt).
- Zeilen 9–11: der Inhalt des Tokens, zur Veranschaulichung angezeigt;
- Zeilen 14–16: die Abmeldung über ein Formular, das auf einen einzigen Button reduziert ist.
8.1.7. Ausführung
Fordern wir die geschützte Seite [/profile] an, ohne angemeldet zu sein:
Ein falsches Passwort:

Die Anmeldung war erfolgreich. Mit [curl] speichern wir das empfangene Cookie in einer Datei:
Das Token besteht aus drei durch Punkte getrennten Teilen, jeweils Base64-codiert: dem Header, dem Inhalt und der Signatur. Die ersten beiden Teile lassen sich ohne jeden Schlüssel decodieren:
Datumsangaben werden in Sekunden seit dem 1. Januar 1970 ausgedrückt; der Ablaufzeitpunkt liegt eine Stunde nach der Erstellung. Im Browser zeigt die Profilseite denselben Inhalt an:

Ein böswilliger Benutzer ändert sein Token: Er ersetzt im Inhalt die Rolle ***[USER]*** durch ***[ADMIN]***, codiert diesen Teil erneut in Base64 und behält die ursprüngliche Signatur bei. Der Server berechnet die Signatur des geänderten Inhalts neu, die nun nicht mehr übereinstimmt:
Das gefälschte Token wird abgelehnt und gelöscht. Um eine gültige Signatur zu erzeugen, müsste man den geheimen Schlüssel kennen – daher die Bedeutung, ihn geheim zu halten und einen langen, zufälligen Schlüssel zu wählen.
8.2. Beispiel 26: Rollen
Beispiel 26 fügt eine Administrationsseite hinzu, die auf die Rolle ADMIN beschränkt ist. Es werden nur neue oder geänderte Dateien angezeigt.
8.2.1. Ein Dekorator mit Parameter: auth/security.py
- Zeilen 37–47: [@role_required("ADMIN")] hat einen Parameter. Der Ausdruck nach [@] wird zuerst ausgewertet: [role_required("ADMIN")] liefert eine Funktion, [decorator], die der eigentliche Dekorator ist und auf die Aktion angewendet wird. Wir haben also drei verschachtelte Funktionen: [role_required] erhält die Rolle, [decorator] erhält die Aktion, und [protected_action] erhält die Parameter der Anfrage und erledigt die Arbeit. Jede hat Zugriff auf die Variablen der Funktionen, die sie enthalten ([role], [action]);
- Zeile 42: Ein authentifizierter Benutzer, der nicht die verlangte Rolle hat, erhält einen 403-Fehler (*Forbidden*). Das unterscheidet sich deutlich vom anonymen Benutzer, der auf die Anmeldeseite umgeleitet wird: Eine Anmeldung wäre zwecklos, da der Benutzer bereits authentifiziert ist.
8.2.2. Der Controller: controllers/admin.py
- Zeilen 12–14: Dekoratoren werden von unten nach oben angewendet: [role_required] umhüllt die Aktion, danach umhüllt [login_required] das gesamte Gebilde. Zur Laufzeit ist die Reihenfolge umgekehrt: Die äußere Hülle, [login_required], wird zuerst ausgeführt. Wenn also [role_required] läuft, ist der Benutzer zwangsläufig authentifiziert, und [g.user] ist nicht [None].
8.2.3. Die Fehlerseite: app.py
- Zeilen 37–39: Ein für einen bestimmten Code – den Fehler 403 – registrierter Fehlerbehandler zeigt unsere Seite an.
8.2.4. Ausführung
Marie, mit der Rolle USER, folgt dem Link zur Administrationsseite:

Der Administrator hingegen hat Zugriff darauf:

Mit [curl]: ein Benutzer mit der Rolle USER, gefolgt von einem anonymen Besucher:
Das Schützen der Aktionen einzeln hat einen Haken: Ein einziges Versehen öffnet eine Seite für alle. Die Fallstudie kehrt diese Logik um: Alle Aktionen sind standardmäßig geschützt, und ein Dekorator [@public] kennzeichnet die wenigen Ausnahmen (die Anmeldeseite, die Registrierung).
8.3. Beispiel 27: CAPTCHA und Begrenzung der Versuche
Ein Anmeldeformular ist ein Angriffsziel: Ein Programm kann Tausende von Passwörtern pro Minute ausprobieren (Brute-Force-Angriff). Zwei Schutzmaßnahmen ergänzen sich:
- ein CAPTCHA (*Completely Automated Public Turing test to tell Computers and Humans Apart*): ein Bild mit einem verzerrten Code, der für einen Menschen leicht, für ein Programm aber schwer zu lesen ist;
- eine Begrenzung der Versuche: Nach drei fehlgeschlagenen Versuchen wird die IP-Adresse des Clients für eine Minute gesperrt.
Beispiel 27 baut auf Beispiel 25 auf (ohne die Administrationsseite) und fügt diese beiden Sicherheitsmaßnahmen hinzu.
8.3.1. Das CAPTCHA-Bild: auth/captcha_drawing.py
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 | |
Das Bild liegt im SVG-Format (*Scalable Vector Graphics*) vor: einer Vektorgrafik, die in XML – also als Text – beschrieben ist, die der Server ohne Grafikbibliothek erzeugt und die der Browser direkt auf der Seite darstellt.
- Zeile 11: Das Modul [random] von [Python] erzeugt vorhersagbare Zahlenfolgen (wer einige Werte kennt, kann die folgenden erraten): Es eignet sich für Simulationen, nicht für Sicherheitszwecke. Das Modul [secrets] bietet einen kryptografischen Generator, der nicht vorhersagbar ist;
- Zeilen 16–48: eine minimalistische „Schrift“: Jedes Zeichen ist eine Liste von Strichen, und jeder Strich ist eine Liste von Koordinaten [x, y] in einem Raster von 4 × 6. Leicht zu verwechselnde Zeichen ([0] und [O], [1], [I] und [L]) sind ausgeschlossen;
- Zeile 51: ["".join(FONT)] verbindet die Schlüssel des Wörterbuchs: die verfügbaren Zeichen;
- Zeilen 57–58: zufälliger Text. [_] ist der übliche Name für eine nicht verwendete Variable;
- Zeilen 69–103: die Zeichnung. Jedes Zeichen wird zufällig vergrößert, gedreht und verschoben, und jeder seiner Punkte wird leicht versetzt; jeder Strich wird zu einem [<path>]-Element des SVG ([M]: Verschiebung, [L]: Linie). Drei Kurven ([C]: Bézierkurve) durchziehen das Bild, um Erkennungsprogramme zu verwirren. Die Formate [:.1f] schreiben Zahlen mit einer Nachkommastelle.
8.3.2. Der CAPTCHA-Service: auth/captcha.py
- Zeilen 28–33: ein neues CAPTCHA: zufälliger Text, eine zufällige, nicht erratbare Kennung ([secrets.token_urlsafe]) und das Bild. Zu jeder Kennung speichert der Server die erwartete Antwort und ein Ablaufdatum. Die Seite erhält nur die Kennung und das Bild: Die Antwort verlässt den Server nie;
- Zeilen 36–42: Überprüfung. [pop] entfernt den Eintrag aus dem Dictionary und gibt ihn zurück: Das CAPTCHA wird verbraucht – in jedem Fall, ob die Prüfung gelingt oder nicht. Ohne dies könnte ein Programm alle möglichen Antworten für dasselbe Bild durchprobieren. Der Vergleich ignoriert Groß- und Kleinschreibung sowie Leerzeichen um die Eingabe.
Dieser Service hält Daten im Arbeitsspeicher des Servers: Das weicht vom Prinzip des zustandslosen Servers ab (siehe das Kapitel über Gültigkeitsbereiche), was für kurzlebige Daten akzeptabel ist. Bei mehreren Servern müssten die Daten in einem gemeinsamen Speichersystem abgelegt werden (einer Datenbank, [Redis] ...). Beachten Sie außerdem, dass nie verwendete CAPTCHAs nicht gelöscht werden: Die Fallstudie bereinigt regelmäßig abgelaufene CAPTCHAs.
8.3.3. Begrenzung der Versuche: auth/limiter.py
- Zeilen 12–15: pro IP-Adresse eine Anzahl fehlgeschlagener Versuche und ein Datum, an dem die Sperre endet ([datetime.min], das früheste mögliche Datum, bedeutet „nicht gesperrt“);
- Zeilen 26–32: die in der Sperre verbleibenden Sekunden, aufgerundet auf die nächste ganze Zahl ([math.ceil]);
- Zeilen 34–40: ein weiterer Fehlversuch. [setdefault] setzt den Zähler der Adresse zurück und legt ihn an, falls er nicht existiert. Beim dritten Fehlversuch wird die Adresse für eine Minute gesperrt, und der Zähler wird auf null zurückgesetzt;
- Zeilen 42–44: Eine erfolgreiche Anmeldung setzt den Zähler zurück.
8.3.4. Der Controller: controllers/auth.py
- Zeile 25: die Adresse des Clients, IP;
- Zeilen 28–30: Eine gesperrte Adresse wird gar nicht erst beachtet;
- Zeilen 32–34: Das CAPTCHA wird vor dem Passwort geprüft: Die Prüfung kostet fast nichts, während [bcrypt] absichtlich langsam ist. Ein Programm, das ein falsches CAPTCHA eingibt, würde daher nicht [bcrypt] auslösen. Jeder Fehlversuch – ob beim CAPTCHA oder beim Passwort – wird gezählt;
- Zeile 39: Eine erfolgreiche Anmeldung setzt die Fehlerzahl zurück;
- Zeilen 54–56: Jedes Mal, wenn das Formular angezeigt wird, wird ein neues CAPTCHA erzeugt, auch nach einem Fehlversuch.
8.3.5. Die View: templates/auth/login.html
- Zeile 17: Das SVG-Bild wird mit dem Filter [safe] unverändert in die Seite eingefügt (Beispiel 14). Das ist zulässig: Dieses HTML wurde vom Server erzeugt und enthält keine Benutzereingaben;
- Zeile 19: Die CAPTCHA-ID in einem versteckten Feld;
- Zeile 20: Der Browser schlägt für dieses Feld keine früheren Eingaben vor.
8.3.6. Ausführung

Ein falsch abgeschriebener Code:

Beim dritten fehlgeschlagenen Versuch wird die Adresse gesperrt:

Mit [curl], vier Versuche mit einer erfundenen CAPTCHA-ID:
Selbst mit dem richtigen Passwort wird der vierte Versuch ohne Überprüfung abgelehnt.