squad-manager/server/sva-privat/app/sicherheit.php
danny a5da53d373 1.7.0: Mitmachen im Squad ohne Konto
Der Squad-Reiter braucht kein Konto mehr: Spielername eingeben, der PC
bekommt einen Schluessel (Token ohne Ablauf), die Akten werden fuer alle
sichtbar. E-Mail und Passwort sind optional ("Konto sichern") und machen
die Charaktere reset- und mehr-PC-fest. Ohne gesichertes Konto bietet das
Menue kein Abmelden, weil das den Schluessel loeschte.

Server: Aktionen mitmachen und konto_sichern, Konten ohne E-Mail
(Datenbank-Stand 2, eingespielt von DB::migrieren() bei der ersten
Anfrage), Loeschen ohne Passwort fuer reine Schluessel-Konten, Verwaltung
zeigt sie als "nur Schluessel". Deinstallationsfrage nennt den Schluessel.

Tests: Server 108, Zwei-PC 34, Oberflaeche 24 - auch gegen das Paket.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-15 06:35:54 +02:00

145 lines
5 KiB
PHP

<?php
/*
* Token, Passwoerter und Bremsen gegen Durchprobieren und Spam.
*
* Token werden nur als SHA-256-Hash gespeichert: Wer die Datenbank liest,
* kann sich damit nicht anmelden. Passwoerter mit password_hash().
*/
declare(strict_types=1);
final class Sicherheit
{
public const SITZUNG_TAGE = 180;
public const PASSWORT_MIN = 10;
public static function zufall(int $bytes = 32): string
{
return bin2hex(random_bytes($bytes));
}
public static function hash(string $token): string
{
return hash('sha256', $token);
}
/** Legt ein Token an und gibt es im Klartext zurueck - nur dieses eine Mal. */
public static function tokenAnlegen(int $nutzerId, string $art, int $gueltigSekunden,
?string $geraet = null): string
{
$token = self::zufall();
DB::einfuegen('sm_token', [
'nutzer_id' => $nutzerId,
'art' => $art,
'token_hash' => self::hash($token),
'geraet' => $geraet === null ? null : mb_substr($geraet, 0, 100),
'erstellt_am' => DB::jetzt(),
'laeuft_ab_am' => DB::jetzt($gueltigSekunden),
]);
return $token;
}
/** Gueltiges Token samt Nutzer, sonst null. */
public static function tokenFinden(string $token, string $art): ?array
{
if (!preg_match('/^[0-9a-f]{64}$/', $token)) {
return null;
}
return DB::eine(
'SELECT t.id AS token_id, t.laeuft_ab_am, t.genutzt_am, n.*
FROM sm_token t JOIN sm_nutzer n ON n.id = t.nutzer_id
WHERE t.token_hash = ? AND t.art = ? AND t.laeuft_ab_am > ?',
[self::hash($token), $art, DB::jetzt()]);
}
public static function tokenLoeschen(int $tokenId): void
{
DB::ausfuehren('DELETE FROM sm_token WHERE id = ?', [$tokenId]);
}
public static function alleTokenLoeschen(int $nutzerId, string $art): void
{
DB::ausfuehren('DELETE FROM sm_token WHERE nutzer_id = ? AND art = ?', [$nutzerId, $art]);
}
/**
* Prueft das Sitzungstoken des Programms. Wer das Programm regelmaessig
* nutzt, bleibt angemeldet: Die Laufzeit verlaengert sich, hoechstens
* einmal am Tag geschrieben.
*/
public static function sitzung(string $token): ?array
{
$zeile = self::tokenFinden($token, 'sitzung');
if ($zeile === null || (int) $zeile['gesperrt'] === 1) {
return null;
}
if ($zeile['genutzt_am'] === null || $zeile['genutzt_am'] < DB::jetzt(-86400)) {
// Nie verkuerzen: Der Schluessel eines PCs ohne Konto laeuft gar nicht ab
$neu = max((string) $zeile['laeuft_ab_am'], DB::jetzt(self::SITZUNG_TAGE * 86400));
DB::aktualisieren('sm_token', ['genutzt_am' => DB::jetzt(), 'laeuft_ab_am' => $neu],
'id = ?', [$zeile['token_id']]);
}
return $zeile;
}
public static function passwortRegeln(string $passwort): ?string
{
if (mb_strlen($passwort) < self::PASSWORT_MIN) {
return 'Das Passwort braucht mindestens ' . self::PASSWORT_MIN . ' Zeichen.';
}
if (strlen($passwort) > 200) {
return 'Das Passwort ist zu lang.';
}
return null;
}
public static function passwortHash(string $passwort): string
{
return password_hash($passwort, PASSWORD_DEFAULT);
}
public static function ip(): string
{
return (string) ($_SERVER['REMOTE_ADDR'] ?? '0.0.0.0');
}
/**
* Zaehlt Versuche je Art und Schluessel (etwa IP oder E-Mail) im
* Zeitfenster. Gibt false zurueck, wenn das Limit erreicht ist - dann
* wird auch nichts mehr gezaehlt.
*/
public static function bremse(string $art, string $wer, int $max, int $fensterSekunden): bool
{
$schluessel = self::hash($art . '|' . $wer);
$anzahl = (int) DB::wert(
'SELECT COUNT(*) FROM sm_versuch WHERE art = ? AND schluessel = ? AND zeit > ?',
[$art, $schluessel, DB::jetzt(-$fensterSekunden)]);
if ($anzahl >= $max) {
return false;
}
DB::einfuegen('sm_versuch', ['art' => $art, 'schluessel' => $schluessel, 'zeit' => DB::jetzt()]);
if (random_int(1, 50) === 1) {
self::aufraeumen();
}
return true;
}
public static function bremseLoesen(string $art, string $wer): void
{
DB::ausfuehren('DELETE FROM sm_versuch WHERE art = ? AND schluessel = ?',
[$art, self::hash($art . '|' . $wer)]);
}
public static function bremseOderFehler(string $art, string $wer, int $max, int $fenster): void
{
if (!self::bremse($art, $wer, $max, $fenster)) {
throw new SmFehler('zu_viele_versuche',
'Zu viele Versuche. Bitte warte einige Minuten.', 429);
}
}
public static function aufraeumen(): void
{
DB::ausfuehren('DELETE FROM sm_versuch WHERE zeit < ?', [DB::jetzt(-86400)]);
DB::ausfuehren('DELETE FROM sm_token WHERE laeuft_ab_am < ?', [DB::jetzt()]);
}
}