mitmario.dev

Eine einfache Anmeldung

PHP Sandbox 4 Min Lesezeit 3 BeispieleLektion 5 von 6

Eine geschützte Seite soll nur sehen, wer das Passwort kennt. Und das auch auf jeder Seite danach, ohne es jedes Mal neu einzutippen. Die Teile dafür hast du schon, nämlich Formular, Weiterleitung und Sitzung. Neu ist nur der Umgang mit dem Passwort.

Formular, Vergleich und Merker

Die drei Teile einer Anmeldung
<?php

declare(strict_types=1);

// Eine vollstaendige Anmeldung in einer Datei. Das Passwort lautet
// gurkenbeet-im-mai. Mit ihm geht der geschuetzte Bereich auf, und
// Abmelden schliesst ihn wieder.

session_start();

const PASSWORT_HASH = '$2y$12$vuWc2OALu2CE9nxuCd6XmuvGDX9bYCdMSlioDc562fi89y527GHF6';

$pfad = parse_url($_SERVER["REQUEST_URI"], PHP_URL_PATH);
$angemeldet = !empty($_SESSION["angemeldet"]);
$fehler = null;

if ($pfad === "/login" && $_SERVER["REQUEST_METHOD"] === "POST") {
    if (password_verify($_POST["passwort"] ?? "", PASSWORT_HASH)) {
        // Neue Kennung, damit eine untergeschobene alte wertlos wird.
        session_regenerate_id(true);
        $_SESSION["angemeldet"] = true;

        header("Location: /geheim", true, 302);
        exit;
    }

    $fehler = "Das Passwort stimmt nicht.";
}

if ($pfad === "/geheim" && !$angemeldet) {
    header("Location: /login", true, 302);
    exit;
}

if ($pfad === "/logout") {
    $_SESSION = [];
    setcookie(session_name(), "", ["expires" => time() - 3600, "path" => "/"]);
    session_destroy();

    header("Location: /", true, 302);
    exit;
}

?>
<!doctype html>
<html lang="de">
<head>
    <meta charset="utf-8">
    <title>Mitgliederbereich</title>
</head>
<body>

<?php if ($pfad === "/geheim") { ?>
    <h1>Streng geheim</h1>
    <p>Der Umsatz des Monats liegt bei 84.120 Euro.</p>
    <p><a href="/logout">Abmelden</a></p>

<?php } elseif ($pfad === "/login") { ?>
    <h1>Anmelden</h1>

    <?php if ($fehler !== null) { ?>
    <p><strong><?= htmlspecialchars($fehler, ENT_QUOTES, "UTF-8") ?></strong></p>
    <?php } ?>

    <form method="post" action="/login">
        <p><label>Passwort: <input type="password" name="passwort"></label></p>
        <button type="submit">Anmelden</button>
    </form>

<?php } else { ?>
    <h1>Willkommen</h1>
    <p>Diese Seite darf jeder sehen.</p>
    <p><a href="/geheim">Zum geschützten Bereich</a></p>
<?php } ?>

</body>
</html>

Mehr als drei Teile braucht es dafür nicht.

Das Formular ist eines wie in Abschnitt 11, mit einem Feld, einem Button und method="post". Der Vergleich prüft, ob das eingegebene Passwort zu dem passt, das du hinterlegt hast. Und der Merker ist eine einzige Zeile, $_SESSION["angemeldet"] = true;.

Alles Weitere folgt daraus. Eine geschützte Seite fragt oben nach diesem Merker und schickt jeden weg, bei dem er fehlt. Beim Abmelden wird die Sitzung abgeräumt, so wie in der Lektion über Sitzungen.

Der Besucher trägt dabei nur die Sitzungskennung mit sich herum. Der Merker selbst liegt in der Datei auf deinem Server, und deshalb kann ihn niemand von außen setzen. Beim Cookie in der Lektion über Cookies war das anders, da konnte sich jeder zum Chef machen.

Im Reiter Netzwerk tragen der POST /login und das GET /geheim danach je eine cookie: PHPSESSID=…-Zeile, und zwar nicht dieselbe. Warum, steht weiter unten. Vom Passwort steht in den Kopfzeilen nichts, denn es ist im Rumpf des POST mitgereist. Klappst du den POST /login auf, siehst du es im Anfrage-Rumpf im Klartext, so wie es über die Leitung ging.

Das Passwort selbst kommt nie in deine Nähe

Warum das Passwort nicht im Klartext verglichen wird
<?php

declare(strict_types=1);

// Ein Passwort wird nie gespeichert, sondern nur sein Hash. Aus dem
// Hash laesst sich das Passwort nicht zurueckrechnen, aus dem
// Passwort der Hash sehr wohl. Das reicht zum Anmelden.

$passwort = "gurkenbeet-im-mai";

$hash1 = password_hash($passwort, PASSWORD_DEFAULT);
$hash2 = password_hash($passwort, PASSWORD_DEFAULT);

echo "Länge eines Hashs: ", strlen($hash1), " Zeichen", PHP_EOL;
echo "Beide Hashs gleich? ", $hash1 === $hash2 ? "ja" : "nein", PHP_EOL;
echo PHP_EOL;

// Zweimal dasselbe Passwort, zweimal ein anderer Hash: In jedem
// steckt ein zufaelliges Stueck mit, der Salt. Deshalb vergleicht
// man Hashs nie mit === , sondern mit password_verify().

echo "Richtiges Passwort: ", password_verify("gurkenbeet-im-mai", $hash1) ? "passt" : "passt nicht", PHP_EOL;
echo "Falsches Passwort:  ", password_verify("gurkenbeet-im-juni", $hash1) ? "passt" : "passt nicht", PHP_EOL;
echo "Gegen den zweiten Hash: ", password_verify("gurkenbeet-im-mai", $hash2) ? "passt" : "passt nicht", PHP_EOL;

Ein Passwort wird nicht gespeichert. Gespeichert wird ein Hash, ein Text, der sich aus dem Passwort berechnen lässt, aus dem sich das Passwort aber nicht zurückholen lässt. password_hash($passwort, PASSWORD_DEFAULT) erzeugt ihn, password_verify($eingabe, $hash) prüft ihn, und das Passwort im Klartext existiert nur für die Dauer einer Anfrage. Selbst bauen musst du dabei nichts.

Im Beispiel ist der Hash bei jedem Aufruf ein anderer, obwohl das Passwort dasselbe ist. In ihm steckt nämlich ein zufälliges Stück mit, der Salt. password_verify funktioniert trotzdem gegen beide, weil der Salt mit im Hash steht. Das Beispiel läuft als Skript im Terminal. Hier antwortet niemand auf eine Anfrage, es wird nur gerechnet.

Hashs vergleicht man deshalb nie mit ===. Ein Vergleich auf Gleichheit würde bei richtigem Passwort fehlschlagen, und an dem Punkt fangen Leute an, sich etwas Eigenes auszudenken. Warum das eine schlechte Idee ist, mit welchen Verfahren man es zu tun hat und was ein Hash sonst noch aushalten muss, steht in Abschnitt 15.

Die Kennung wechseln, direkt nach dem Anmelden

Was session_regenerate_id bewirkt
<?php

declare(strict_types=1);

// Die Kennung deiner Sitzung, vor und nach einer Neuvergabe.
//
// Beim Neuladen bleibt die Kennung, nach dem Link zum Neuvergeben
// ist sie eine andere, und der Zaehler steht trotzdem noch da, wo
// er war.

session_start();

$vorher = session_id();
$neu = false;

if (isset($_GET["neuekennung"])) {
    session_regenerate_id(true);
    $neu = true;
}

$_SESSION["stand"] = ($_SESSION["stand"] ?? 0) + 1;

?>
<!doctype html>
<html lang="de">
<head>
    <meta charset="utf-8">
    <title>Kennung</title>
    <style>
        body { font-family: system-ui, sans-serif; }
        code { background: #eee; padding: .1rem .3rem; }
    </style>
</head>
<body>
    <h1>Deine Sitzungskennung</h1>

    <p>Vorher: <code><?= htmlspecialchars($vorher, ENT_QUOTES, "UTF-8") ?></code></p>
    <p>Jetzt: <code><?= htmlspecialchars(session_id(), ENT_QUOTES, "UTF-8") ?></code></p>
    <p>Neu vergeben: <?= $neu ? "ja" : "nein" ?></p>

    <p>Stand des Zählers: <strong><?= $_SESSION["stand"] ?></strong></p>

    <p>
        <a href="/">Neu laden</a> ·
        <a href="/?neuekennung=1">Kennung neu vergeben</a>
    </p>
</body>
</html>

Ohne Vorkehrung kommt ein Angreifer auch ohne Passwort an eine angemeldete Sitzung. Er besorgt sich eine Sitzungskennung, bringt den Browser des Opfers dazu, sie als Cookie zu speichern, und wartet. Meldet das Opfer sich an, wird diese Kennung zur Kennung eines angemeldeten Besuchers, und der Angreifer kennt sie längst. Das nennt man Session Fixation.

Dagegen hilft session_regenerate_id(true) direkt nach dem erfolgreichen Vergleich. PHP vergibt eine neue Kennung und schickt sie als Cookie mit, und der Inhalt der Sitzung zieht um. Die untergeschobene Kennung zeigt danach auf nichts mehr.

Auf der Seite zur Neuvergabe ändert der Link „Kennung neu vergeben“ die Kennung, und der Zähler bleibt. Im Reiter Netzwerk steht an der Anfrage mit neuekennung ein Set-Cookie: PHPSESSID=… mit der neuen Kennung, so wie beim allerersten Aufruf. Ab dann schickt der Browser die neue mit.

Ohne das true bleibt die alte Datei liegen, und zwar mit dem Inhalt, den die Sitzung im Moment des Umzugs hatte. Setzt du den Merker vorher, bleibt für den Angreifer also das liegen, was er wollte. Mit true wird die alte Datei gelöscht.

Der Angriff im Terminal

Gegen das Beispiel mit den drei Teilen lässt sich der Schutz im Terminal vorführen, sobald es läuft. Ohne -c und -b hebt curl nichts auf, und jeder Aufruf kommt als neuer Besucher an. Mit einer Datei, in der es seine Cookies aufhebt, geht es den Weg eines Browsers. So arbeiten die ersten beiden Befehle in der Befehlsleiste dieses Beispiels. Die Anmeldung mit -c jar -b jar antwortet mit HTTP/1.1 302 Found, und curl -s -b jar localhost:3000/geheim | grep '<h1>' zeigt danach Streng geheim. Der Server hat eine neue Kennung vergeben, und curl hat sie aus dem Set-Cookie in die Datei übernommen. Alles in Ordnung.

Die anderen beiden Befehle gehen den Weg eines Angreifers, mit der Kennung festekennung12345, die er sich vorher ausgesucht hat. Die Anmeldung mit dieser Kennung meldet ebenfalls die 302. Der Aufruf von /geheim mit derselben Kennung antwortet aber mit einer weiteren 302, zurück zur Anmeldung.

Dass PHP eine ausgedachte Kennung wie festekennung12345 überhaupt annimmt, hängt an einer Einstellung. Mit session.use_strict_mode = 1 in der php.ini nimmt PHP nur Kennungen an, die es selbst vergeben hat, und schickt für jede andere eine frische zurück. Eine echte Kennung, die sich der Angreifer vorher selbst bei der Seite abgeholt hat, kommt trotzdem durch. Deshalb gehört die Neuvergabe auch dann hinter jeden erfolgreichen Vergleich. In diesem Kurs steht der Schalter auf 0, wie beim Standardwert von PHP und in den beiden php.ini-Vorlagen, die PHP mitbringt. In den Prüflisten der Lektionen davor stehen erfundene Kennungen, und die funktionieren nur so.

In der Aufgabe kommt vor die Notizanwendung eine Anmeldung mit Mias Passwort. Beim Prüfen werden die Cookies dabei aufgehoben wie bei curl mit -c jar -b jar.

Zum Mitnehmen

Eine Anmeldung ist ein Formular, ein Vergleich mit password_verify und ein Merker in der Sitzung. Direkt nach dem Vergleich vergibt session_regenerate_id(true) eine neue Kennung, damit eine untergeschobene nichts mehr wert 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.