squad-manager/server/sva-privat/app/konten.php
danny 6e4d4afc1d Server fuer Konten, Akten und Squads
PHP 8 ohne Framework unter server/: oeffentliche Einstiege fuer
sva.tyrveil.com (Schnittstelle, Konto-Links, Verwaltung, Einrichtung) und
die Logik in sva-privat neben dem Dokumentenstamm.

- Konten mit E-Mail-Bestaetigung, Anmeldung per Token, Passwort
  vergessen, Konto loeschen
- Akten auf dem Server mit serververgebener Aktennummer und
  Versionspruefung; Portraets werden neu als PNG gespeichert
- Squads mit Einladungen, Fuehrung uebergeben, Aufloesen
- Verwaltung fuer info@tyrveil.com: Nutzer, Charaktere, Squads
- Bremsen gegen Durchprobieren, Token nur als Hash, CSRF-Schutz

werkzeuge/server_test.py prueft alles lokal mit SQLite (91 Faelle).
Der Release-Bau legt dist/server und dist/sva-privat an, ohne config.php.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-13 17:50:33 +02:00

209 lines
9.7 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
/*
* Nutzerkonten: Registrierung mit E-Mail-Bestaetigung, Anmeldung,
* Passwort vergessen, Konto loeschen.
*/
declare(strict_types=1);
final class Konten
{
public static function oeffentlich(array $nutzer): array
{
return [
'id' => (int) $nutzer['id'],
'benutzername' => $nutzer['benutzername'],
'email' => $nutzer['email'],
'rolle' => $nutzer['rolle'],
];
}
public static function link(string $pfad): string
{
return rtrim((string) sm_config('basis_url', 'https://sva.tyrveil.com'), '/') . $pfad;
}
public static function registrieren(string $benutzername, string $email, string $passwort): void
{
$benutzername = trim($benutzername);
$email = mb_strtolower(trim($email));
if (!preg_match('/^[A-Za-z0-9_.-]{3,32}$/', $benutzername)) {
throw new SmFehler('benutzername_ungueltig', 'Der Benutzername braucht 3 bis 32 Zeichen: '
. 'Buchstaben, Ziffern, Punkt, Minus oder Unterstrich.');
}
if (strlen($email) > 191 || !filter_var($email, FILTER_VALIDATE_EMAIL)) {
throw new SmFehler('email_ungueltig', 'Die E-Mail-Adresse ist ungültig.');
}
$regel = Sicherheit::passwortRegeln($passwort);
if ($regel !== null) {
throw new SmFehler('passwort_zu_schwach', $regel);
}
Sicherheit::bremseOderFehler('registrieren', Sicherheit::ip(), 5, 3600);
if (DB::wert('SELECT 1 FROM sm_nutzer WHERE benutzername_klein = ?', [mb_strtolower($benutzername)])) {
throw new SmFehler('benutzername_vergeben', 'Dieser Benutzername ist schon vergeben.', 409);
}
if (DB::wert('SELECT 1 FROM sm_nutzer WHERE email = ?', [$email])) {
throw new SmFehler('email_vergeben',
'Mit dieser E-Mail-Adresse gibt es schon ein Konto. Passwort vergessen?', 409);
}
try {
$id = DB::einfuegen('sm_nutzer', [
'benutzername' => $benutzername,
'benutzername_klein' => mb_strtolower($benutzername),
'email' => $email,
'passwort_hash' => Sicherheit::passwortHash($passwort),
'rolle' => 'nutzer',
'gesperrt' => 0,
'erstellt_am' => DB::jetzt(),
]);
} catch (PDOException $fehler) {
// Zwei gleichzeitige Registrierungen mit demselben Namen
if ((string) $fehler->getCode() === '23000') {
throw new SmFehler('benutzername_vergeben', 'Benutzername oder E-Mail ist schon vergeben.', 409);
}
throw $fehler;
}
self::bestaetigungSenden($id, $benutzername, $email);
}
private static function bestaetigungSenden(int $nutzerId, string $benutzername, string $email): void
{
Sicherheit::alleTokenLoeschen($nutzerId, 'bestaetigung');
$token = Sicherheit::tokenAnlegen($nutzerId, 'bestaetigung', 48 * 3600);
$link = self::link('/konto/bestaetigen.php?t=' . $token);
Mail::senden($email, 'Squad Manager: E-Mail-Adresse bestätigen',
"Hallo $benutzername,\n\n"
. "bitte bestätige deine E-Mail-Adresse, damit du dich im Squad Manager anmelden kannst:\n\n"
. "$link\n\n"
. "Der Link ist 48 Stunden gültig. Hast du kein Konto angelegt, ignoriere diese Mail einfach."
. Mail::fusszeile());
}
public static function bestaetigen(string $token): array
{
$zeile = Sicherheit::tokenFinden($token, 'bestaetigung');
if ($zeile === null) {
throw new SmFehler('link_ungueltig', 'Dieser Link ist ungültig oder abgelaufen.', 404);
}
if ($zeile['email_bestaetigt_am'] === null) {
DB::aktualisieren('sm_nutzer', ['email_bestaetigt_am' => DB::jetzt()], 'id = ?', [$zeile['id']]);
}
Sicherheit::tokenLoeschen((int) $zeile['token_id']);
return $zeile;
}
/** Antwortet immer gleich, damit sich nicht erraten laesst, welche Adressen registriert sind. */
public static function bestaetigungErneut(string $email): void
{
$email = mb_strtolower(trim($email));
Sicherheit::bremseOderFehler('bestaetigung', Sicherheit::ip(), 5, 3600);
$nutzer = DB::eine('SELECT * FROM sm_nutzer WHERE email = ?', [$email]);
if ($nutzer && $nutzer['email_bestaetigt_am'] === null && !(int) $nutzer['gesperrt']
&& Sicherheit::bremse('bestaetigung_mail', $email, 3, 3600)) {
self::bestaetigungSenden((int) $nutzer['id'], $nutzer['benutzername'], $nutzer['email']);
}
}
public static function anmelden(string $login, string $passwort, string $geraet): array
{
$login = mb_strtolower(trim($login));
Sicherheit::bremseOderFehler('anmelden', Sicherheit::ip() . '|' . $login, 10, 900);
$nutzer = DB::eine('SELECT * FROM sm_nutzer WHERE benutzername_klein = ? OR email = ?', [$login, $login]);
$hash = $nutzer['passwort_hash'] ?? null;
// Auch ohne Nutzer einen echten Hash pruefen, sonst verraet die
// Antwortzeit, welche Namen existieren
$passt = password_verify($passwort, $hash ?? password_hash('platzhalter', PASSWORD_DEFAULT));
if (!$nutzer || $hash === null || !$passt) {
throw new SmFehler('anmeldung_falsch', 'Benutzername oder Passwort stimmt nicht.', 401);
}
if ((int) $nutzer['gesperrt'] === 1) {
throw new SmFehler('gesperrt', 'Dieses Konto ist gesperrt.', 403);
}
if ($nutzer['email_bestaetigt_am'] === null) {
throw new SmFehler('nicht_bestaetigt',
'Bitte bestätige zuerst deine E-Mail-Adresse – der Link steht in der Mail von uns.', 403);
}
if (password_needs_rehash($hash, PASSWORD_DEFAULT)) {
DB::aktualisieren('sm_nutzer', ['passwort_hash' => Sicherheit::passwortHash($passwort)],
'id = ?', [$nutzer['id']]);
}
Sicherheit::bremseLoesen('anmelden', Sicherheit::ip() . '|' . $login);
$token = Sicherheit::tokenAnlegen((int) $nutzer['id'], 'sitzung',
Sicherheit::SITZUNG_TAGE * 86400, $geraet);
DB::aktualisieren('sm_nutzer', ['letzte_anmeldung_am' => DB::jetzt()], 'id = ?', [$nutzer['id']]);
return ['token' => $token, 'nutzer' => self::oeffentlich($nutzer)];
}
public static function abmelden(array $nutzer): void
{
Sicherheit::tokenLoeschen((int) $nutzer['token_id']);
}
public static function passwortVergessen(string $email): void
{
$email = mb_strtolower(trim($email));
Sicherheit::bremseOderFehler('vergessen', Sicherheit::ip(), 5, 3600);
$nutzer = DB::eine('SELECT * FROM sm_nutzer WHERE email = ?', [$email]);
if ($nutzer && !(int) $nutzer['gesperrt'] && Sicherheit::bremse('vergessen_mail', $email, 3, 3600)) {
self::passwortLinkSenden($nutzer, 3600,
"jemand – hoffentlich du – möchte das Passwort für deinen Squad Manager-Zugang zurücksetzen.\n\n"
. "Neues Passwort festlegen:\n\n%LINK%\n\n"
. "Der Link ist eine Stunde gültig. Warst du das nicht, ignoriere diese Mail; "
. "dein Passwort bleibt dann unverändert.");
}
}
/** Verschickt einen Link zum Passwort-Setzen. Gibt den Link zurueck (fuer die Einrichtung). */
public static function passwortLinkSenden(array $nutzer, int $gueltigSekunden, string $text): string
{
Sicherheit::alleTokenLoeschen((int) $nutzer['id'], 'passwort');
$token = Sicherheit::tokenAnlegen((int) $nutzer['id'], 'passwort', $gueltigSekunden);
$link = self::link('/konto/passwort.php?t=' . $token);
Mail::senden($nutzer['email'], 'Squad Manager: Passwort festlegen',
"Hallo {$nutzer['benutzername']},\n\n" . str_replace('%LINK%', $link, $text) . Mail::fusszeile());
return $link;
}
public static function passwortSetzen(string $token, string $passwort): array
{
$zeile = Sicherheit::tokenFinden($token, 'passwort');
if ($zeile === null) {
throw new SmFehler('link_ungueltig', 'Dieser Link ist ungültig oder abgelaufen.', 404);
}
$regel = Sicherheit::passwortRegeln($passwort);
if ($regel !== null) {
throw new SmFehler('passwort_zu_schwach', $regel);
}
DB::transaktion(function () use ($zeile, $passwort) {
// Wer den Link aus der Mail nutzt, hat die Adresse damit auch bestaetigt
DB::aktualisieren('sm_nutzer', [
'passwort_hash' => Sicherheit::passwortHash($passwort),
'email_bestaetigt_am' => $zeile['email_bestaetigt_am'] ?? DB::jetzt(),
], 'id = ?', [$zeile['id']]);
Sicherheit::alleTokenLoeschen((int) $zeile['id'], 'passwort');
Sicherheit::alleTokenLoeschen((int) $zeile['id'], 'sitzung');
});
return $zeile;
}
public static function kontoLoeschen(array $nutzer, string $passwort): void
{
if ($nutzer['passwort_hash'] === null || !password_verify($passwort, $nutzer['passwort_hash'])) {
throw new SmFehler('anmeldung_falsch', 'Das Passwort stimmt nicht.', 401);
}
if ($nutzer['rolle'] === 'admin') {
throw new SmFehler('admin', 'Der Verwaltungszugang lässt sich nicht selbst löschen.', 403);
}
self::loeschen((int) $nutzer['id']);
}
/** Loescht Konto samt Charakteren; Squads werden dabei weitergegeben oder aufgeloest. */
public static function loeschen(int $nutzerId): void
{
DB::transaktion(function () use ($nutzerId) {
Charaktere::alleVonNutzerLoeschen($nutzerId);
DB::ausfuehren('DELETE FROM sm_nutzer WHERE id = ?', [$nutzerId]);
});
}
}