mitmario.dev

Anmeldung

PHP Sandbox 3 Min Lesezeit 2 BeispieleLektion 3 von 8

Mit einem Passwort-Hash in einer Konstante kann sich genau eine Person anmelden. Für eine zweite gehören die Konten in eine Tabelle, und aus einer Anmeldung werden drei Wege: registrieren, anmelden und abmelden.

Die kleinste Anmeldung

Anmeldung in klein
<?php

declare(strict_types=1);

// Anmeldung in klein: vier Adressen, ein Konto, kein Speicher. Im Reiter
// Browser kannst du es wirklich durchspielen, dein Browser haelt die
// Sitzung zusammen. Das Passwort lautet gurkenbeet-im-mai.

session_start();

// Einmal mit password_hash("gurkenbeet-im-mai", PASSWORD_DEFAULT, ["cost" => 12])
// erzeugt. In der Anwendung steht so ein Hash in der Spalte passwort_hash.
$konten = ["mia" => '$2y$12$WxNFz16zb7VpJN/UxpGAguqQhLyiThjRJZBJFeuJwFBr7VVdwuWN6'];

$pfad = parse_url($_SERVER["REQUEST_URI"], PHP_URL_PATH) ?: "";
$meldung = null;

if ($pfad === "/login" && $_SERVER["REQUEST_METHOD"] === "POST") {
    $name = trim($_POST["name"] ?? "");

    // Der Vergleich laeuft auch dann, wenn es den Namen gar nicht gibt,
    // gegen einen Ersatz-Hash mit denselben Kosten. Sonst waere an der
    // Antwortzeit abzulesen, welche Namen vergeben sind.
    $hash = $konten[$name] ?? '$2y$12$5rTZVJchRm1u8TsgqFvqrOkv4n1NfL.aaBR6FkfZgzlbAh7bvc7TW';
    $passt = password_verify($_POST["passwort"] ?? "", $hash);

    if (isset($konten[$name]) && $passt) {
        session_regenerate_id(true);
        $_SESSION["name"] = $name;

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

    $meldung = "Name oder Passwort stimmt nicht.";
}

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

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

// Die Wand: eine Zeile, und sie steht vor allem, was geschuetzt sein soll.
if ($pfad === "/geschuetzt" && empty($_SESSION["name"])) {
    header("Location: /login", true, 302);
    exit;
}

?>
<!doctype html>
<html lang="de">
<head><meta charset="utf-8"><title>Anmeldung in klein</title>
<style>body{font-family:system-ui,sans-serif;max-width:34rem;margin:2rem auto}</style></head>
<body>
<h1>Anmeldung in klein</h1>

<?php if ($pfad === "/geschuetzt") { ?>
    <p>Hallo <?= htmlspecialchars($_SESSION["name"], ENT_QUOTES, "UTF-8") ?>. Hier steht, was nur du sehen darfst.</p>
    <p><a href="/logout">Abmelden</a></p>

<?php } elseif ($pfad === "/login") { ?>
    <?php if ($meldung !== null) { ?><p><strong><?= htmlspecialchars($meldung, ENT_QUOTES, "UTF-8") ?></strong></p><?php } ?>
    <form method="post" action="/login">
        <p><label>Name: <input type="text" name="name" value="mia"></label></p>
        <p><label>Passwort: <input type="password" name="passwort"></label></p>
        <button type="submit">Anmelden</button>
    </form>

<?php } else { ?>
    <p>Diese Seite darf jeder sehen.</p>
    <p><a href="/geschuetzt">Zum geschützten Bereich</a> (ohne Anmeldung fliegst du raus)</p>
<?php } ?>

</body>
</html>

Im ersten Beispiel steht die kleinste Anmeldung, mit der man wirklich etwas anfangen kann. Ein Konto, vier Adressen, keine Datenbank. Im Reiter Browser kannst du sie richtig bedienen. Rufst du /geschuetzt ohne Anmeldung auf, landest du auf der Anmeldeseite. Mit gurkenbeet-im-mai kommst du hinein, und nach dem Abmelden bist du wieder draußen.

Bei einem Namen, den es gar nicht gibt, läuft der Vergleich trotzdem. password_verify braucht bei Kosten 12 gut 150 Millisekunden. Ohne den Aufruf käme die Antwort bei einem unbekannten Namen in unter einer Millisekunde, und an der Antwortzeit ließe sich ablesen, welche Namen vergeben sind. Ein leerer Hash hilft dabei nicht, denn gegen den rechnet password_verify gar nicht erst. Im Beispiel steht deshalb ein Ersatz-Hash mit denselben Kosten.

Zum Abmelden gehören die drei Schritte aus Lektion 12.3: die Sitzung leeren, ihr Cookie löschen und sie zerstören. Entfernst du nur den einen Wert, bleibt die Sitzungsdatei liegen.

Ein Hash ist kein verschlüsseltes Passwort

Ein Hash ist jedes Mal anders
<?php

declare(strict_types=1);

// Zwei Hashes desselben Passworts, und sie sind verschieden, weil in jedem
// ein zufaelliger Salt steckt.

$erster = password_hash("gurkenbeet-im-mai", PASSWORD_DEFAULT, ["cost" => 12]);
$zweiter = password_hash("gurkenbeet-im-mai", PASSWORD_DEFAULT, ["cost" => 12]);

echo "Erster Hash:  ", $erster, "\n";
echo "Zweiter Hash: ", $zweiter, "\n";
echo "Gleich?       ", $erster === $zweiter ? "ja" : "nein", "\n\n";

// Trotzdem passen beide zum selben Passwort. Vergleichen kann man Hashes
// also nicht, pruefen schon.
echo "password_verify gegen den ersten:  ", password_verify("gurkenbeet-im-mai", $erster) ? "passt" : "passt nicht", "\n";
echo "password_verify gegen den zweiten: ", password_verify("gurkenbeet-im-mai", $zweiter) ? "passt" : "passt nicht", "\n";
echo "password_verify mit falschem Wort: ", password_verify("gurkenbeet-im-juni", $erster) ? "passt" : "passt nicht", "\n\n";

// Was in einem Hash steht, kann man ablesen. Das Passwort gehoert nicht dazu.
$info = password_get_info($erster);

echo "Verfahren laut Präfix:  ", $info["algo"], " (", $info["algoName"], ")\n";
echo "Kostenfaktor:           ", $info["options"]["cost"], "\n";
echo "Länge:                  ", strlen($erster), " Bytes\n\n";

// Und die Frage, die eine Anwendung nach Jahren stellt: ist der Hash noch
// gut genug? Der hier ist mit Kosten 4 gerechnet, absichtlich zu billig.
$alt = password_hash("gurkenbeet-im-mai", PASSWORD_BCRYPT, ["cost" => 4]);

echo "Alter Hash passt noch:  ", password_verify("gurkenbeet-im-mai", $alt) ? "ja" : "nein", "\n";
echo "Neu rechnen fällig:     ", password_needs_rehash($alt, PASSWORD_DEFAULT, ["cost" => 12]) ? "ja" : "nein", "\n";

Im zweiten Beispiel wird zweimal der Hash desselben Passworts berechnet, und heraus kommen zwei verschiedene Ergebnisse. Einen verschlüsselten Text könnte man mit dem Schlüssel zurückrechnen. Einen Hash nicht. In jedem Hash steckt außerdem ein zufälliger Salt, damit zwei Leute mit demselben Passwort nicht denselben Eintrag in der Datenbank haben.

password_hash($eingabe) === $ausDerDatenbank ist deshalb immer falsch, auch beim richtigen Passwort. Geprüft wird mit password_verify($eingabe, $ausDerDatenbank). Die Funktion liest den Salt aus dem gespeicherten Hash und rechnet damit nach.

An einem Hash lässt sich trotzdem einiges ablesen. Am Präfix $2y$ erkennt man bcrypt, an der Zahl dahinter den Kostenfaktor, und password_needs_rehash() sagt, ob er nach heutigen Maßstäben zu billig gerechnet ist. Nur das Passwort selbst steht nicht darin.

Die Wand steht an einer Stelle

Fragt jede geschützte Seitenfunktion selbst nach, ob jemand angemeldet ist, funktioniert das, solange man daran denkt. Beim Anlegen der siebten Funktion denkt niemand mehr daran. Dann gibt es eine Adresse, die ohne Anmeldung geht, und alle anderen sind geschützt. So eine Lücke fällt erst auf, wenn jemand die Adresse zufällig aufruft.

Dagegen hilft eine einzige Funktion, die die Frage beantwortet, und ihr Aufruf in der ersten Zeile jeder geschützten Seite. Sie gibt entweder die Nummer des Angemeldeten zurück oder leitet weg und beendet die Anfrage. An jeder Seitenfunktion sieht man dann in ihrer ersten Zeile, ob sie geschützt ist.

Was in die Sitzung gehört

In diesem Projekt stehen dort zwei Werte, die Nummer des Angemeldeten unter nutzer_id und sein Name für die Anzeige. Was einer Person gehört, entscheidet die Nummer. Um ihre Lesezeichen zu laden, nimmt der Code die Nummer aus der Sitzung und nie eine aus dem Formular oder der Adresse. Wie weit das reicht, steht in der Lektion „Bearbeiten und löschen“.

Bevor etwas in die Sitzung kommt, steht im ersten Beispiel session_regenerate_id(true), die Zeile aus der Anmeldung im Abschnitt über Sitzungen. Sie tauscht die Sitzungskennung gegen eine frische, und wer die alte kannte oder sie untergeschoben hat, hat danach nichts mehr davon.

Registrieren und Anmelden enden gleich. Wer sich gerade registriert hat, ist danach angemeldet und muss das nicht noch einmal tun. Beide holen eine frische Sitzungskennung, setzen dieselben zwei Werte in die Sitzung und leiten auf die Liste weiter.

In der Aufgabe baust du diese Wand und die beiden Wege hinein, registrieren und anmelden.

Zum Mitnehmen

Ein Konto ist ein Name und ein Hash in einer Tabelle, und password_verify prüft das Passwort dagegen. Wer sich anmeldet oder registriert, bekommt eine frische Sitzungskennung. Wer nicht angemeldet ist, kommt an keiner geschützten Seite vorbei, weil jede zuerst dieselbe Funktion aufruft.

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

    Steht hier, ohne Konto lesbar.

  • Aufgabe, dein Code läuft auf einem Server

    Öffnet sich mit dem Basis Konto.