Halo-Server, Stufe 1: Benutzer, Anmeldung, Einrichtung
Der Anfang eines eigenen Medienservers — C#, .NET 10, SQLite, im Container für amd64 und arm64. Stufe 1 von fünf: er spielt noch keinen Film ab, aber ein Fremder kann ihn in Betrieb nehmen, und genau daran scheitern solche Projekte sonst als Erstes. **Was läuft, gegen den laufenden Container gemessen** — nicht gegen einen Prüfstand: Gesundheitsfrage, Einrichtungsassistent, zweiter Einrichtungsversuch abgelehnt (409), Anmeldung, falsches Passwort abgelehnt (401), und der ganze Weg der Code-Anmeldung vom Bildschirm bis zum Token. **Drei Entscheidungen, die beim Lesen Fragen aufwerfen:** *Zeitpunkte liegen als Unix-Millisekunden in der Datenbank.* SQLite hat keinen Zeittyp; EF legt einen `DateTimeOffset` sonst als Text mitsamt Zonenversatz ab, und dann steht `…T12:00+02:00` neben `…T11:00Z` — derselbe Augenblick, als Text falsch herum sortiert. EF weigert sich deshalb, `ExpiresAt > jetzt` überhaupt zu übersetzen; das war der erste echte Fehlschlag und ist jetzt eine Typumwandlung für das ganze Modell statt je Eigenschaft. *Token sind keine JWT.* Der Server schlägt sie nach, statt sie zu prüfen — nur so lässt sich ein verlorenes Telefon sofort aussperren. In der Datenbank steht allein der Fingerabdruck. *Der Code am Fernseher holt nie selbst ein Token ab.* Dafür gibt es den Abholschein, den nur das anfragende Gerät kennt. Ohne ihn wären sechsstellige Codes ein Türschloss mit einer Million Schlüsseln — in Minuten durchprobiert. Dass ein erratener Schein nichts bekommt, ist die wichtigste der 55 Prüfungen. **Zwei Fehler, die erst der echte Container zeigte:** `EnsureExists` legte nur an und prüfte nicht, ob sich schreiben lässt — bei einem vorhandenen, aber gesperrten Verzeichnis meldete es Erfolg, und der Server starb zehn Zeilen später an „unable to open database file". Diese Meldung nennt weder das Verzeichnis noch verrät sie, dass es um Dateirechte geht. Jetzt wird tatsächlich geschrieben, und die Meldung nennt Variable, Pfad, die eigene Kennung und den nächsten Schritt. Und: Docker legt den Einhängepunkt eines frischen benannten Volumes als `root` an, wenn das Verzeichnis im Image fehlt. Das traf jeden, der ohne Bind Mount startet. Die drei Verzeichnisse werden jetzt im Image angelegt und übereignet. **Die Lizenz ist eine Bauvorschrift, keine Fussnote.** GPL-2.0-only verträgt sich nicht mit Apache-2.0 — dessen Patentklausel gilt unter Abschnitt 6 als „weitere Einschränkung". Darum steht in `LICENSES.md`, dass vor jedem `PackageReference` die Lizenz zu prüfen ist, und darum ist das Testwerk NUnit (MIT) und nicht xUnit (Apache-2.0). Alle vier Pakete sind geprüft MIT. Die Apps stehen unter MPL-2.0 statt GPL, weil GPL und App Store sich nicht vertragen — Apple entfernte 2011 VLC aus dem Store, nachdem ein Rechteinhaber sich auf Abschnitt 6 berufen hatte. 55 Tests grün. Image baut für linux/amd64 und linux/arm64. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Scarriffle
co-authored by
Claude Opus 5
Claude Opus 5
parent
4b9a1e7b67
commit
156c740330
@@ -0,0 +1,6 @@
|
||||
**/bin/
|
||||
**/obj/
|
||||
**/*.user
|
||||
data/
|
||||
cache/
|
||||
transcode/
|
||||
@@ -0,0 +1,49 @@
|
||||
# syntax=docker/dockerfile:1
|
||||
|
||||
# Gebaut wird auf der Architektur des Bauwirts, übersetzt wird für die des
|
||||
# Ziels — `dotnet publish -a` kann das. Ohne diese Trennung liefe der Bau für
|
||||
# arm64 unter Emulation und dauerte ein Vielfaches.
|
||||
FROM --platform=$BUILDPLATFORM mcr.microsoft.com/dotnet/sdk:10.0 AS build
|
||||
ARG TARGETARCH
|
||||
WORKDIR /src
|
||||
|
||||
# Erst die Projektdateien, dann wiederherstellen: so bleibt die
|
||||
# Paket-Wiederherstellung in der Ebenenzwischenablage, solange sich keine
|
||||
# Abhängigkeit ändert. Ohne diesen Schritt lädt jeder Bau alles neu.
|
||||
COPY src/Halo.Api/Halo.Api.csproj src/Halo.Api/
|
||||
COPY src/Halo.Core/Halo.Core.csproj src/Halo.Core/
|
||||
COPY src/Halo.Data/Halo.Data.csproj src/Halo.Data/
|
||||
RUN dotnet restore src/Halo.Api/Halo.Api.csproj -a $TARGETARCH
|
||||
|
||||
COPY . .
|
||||
RUN dotnet publish src/Halo.Api/Halo.Api.csproj -a $TARGETARCH -c Release -o /app --no-restore
|
||||
|
||||
|
||||
FROM mcr.microsoft.com/dotnet/aspnet:10.0 AS runtime
|
||||
|
||||
# **Die Verzeichnisse müssen hier angelegt werden, nicht erst beim Start.**
|
||||
# Docker legt den Einhängepunkt eines frischen benannten Volumes sonst als
|
||||
# `root` an und übernimmt für ein leeres Volume die Rechte aus dem Image —
|
||||
# gibt es das Verzeichnis im Image nicht, erbt es `root:root`, und der erste
|
||||
# Start scheitert für jeden, der kein Bind Mount benutzt.
|
||||
RUN mkdir -p /config /cache /transcode && chown -R 1000:1000 /config /cache /transcode
|
||||
|
||||
# **Kein root.** Die Kennung 1000 ist die des ersten Benutzers auf fast jedem
|
||||
# Linux und auf den üblichen NAS-Geräten — wessen Dateien anders gehören, setzt
|
||||
# in der Compose-Datei `user: "<uid>:<gid>"`. Das ist Docker-Bordmittel und
|
||||
# braucht weder ein Startskript noch root im Container.
|
||||
USER 1000:1000
|
||||
|
||||
ENV HALO_DATA=/config \
|
||||
HALO_CACHE=/cache \
|
||||
HALO_TRANSCODE=/transcode \
|
||||
ASPNETCORE_URLS=http://+:8080 \
|
||||
DOTNET_gcServer=0
|
||||
|
||||
WORKDIR /app
|
||||
COPY --from=build /app .
|
||||
|
||||
EXPOSE 8080
|
||||
VOLUME ["/config", "/cache", "/transcode"]
|
||||
|
||||
ENTRYPOINT ["dotnet", "Halo.Api.dll"]
|
||||
@@ -0,0 +1,11 @@
|
||||
<Solution>
|
||||
<Folder Name="/src/">
|
||||
<Project Path="src/Halo.Api/Halo.Api.csproj" />
|
||||
<Project Path="src/Halo.Core/Halo.Core.csproj" />
|
||||
<Project Path="src/Halo.Data/Halo.Data.csproj" />
|
||||
</Folder>
|
||||
<Folder Name="/tests/">
|
||||
<Project Path="tests/Halo.Api.Tests/Halo.Api.Tests.csproj" />
|
||||
<Project Path="tests/Halo.Core.Tests/Halo.Core.Tests.csproj" />
|
||||
</Folder>
|
||||
</Solution>
|
||||
@@ -0,0 +1,128 @@
|
||||
# Halo-Server
|
||||
|
||||
Ein Medienserver, der dieselben Dinge kann wie Jellyfin — und zwei, die dort
|
||||
nicht gehen.
|
||||
|
||||
**Stand: Stufe 1 von 5.** Es gibt Benutzer, Anmeldung, Einrichtung und das
|
||||
Gerüst. Einen Film spielt er noch nicht ab. Der Entwurf samt Begründungen steht
|
||||
in [`docs/superpowers/specs/2026-10-03-halo-server-design.md`](../docs/superpowers/specs/2026-10-03-halo-server-design.md).
|
||||
|
||||
## Warum
|
||||
|
||||
**Download mit allen Tonspuren.** Jellyfins Transcode-Endpunkt bildet eine
|
||||
Tonspur je Sitzung ab; was offline landet, ist einspurig, und welche Spur es
|
||||
ist, entscheidet der Server. Einmal war es die Audiodeskription — drei Gigabyte
|
||||
Mobilfunk für eine Datei, die niemand hören wollte.
|
||||
|
||||
**Fortschritt ohne Schwelle.** Jellyfin merkt sich unterhalb eines
|
||||
Mindestanteils gar nichts. Wer zehn Minuten sieht und abbricht, findet beim
|
||||
nächsten Mal keinen Anknüpfungspunkt.
|
||||
|
||||
## Betreiben
|
||||
|
||||
```bash
|
||||
cp docker-compose.example.yml docker-compose.yml
|
||||
# Pfade anpassen — jeder darin ist ein Beispiel, keiner stimmt bei dir.
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
Dann `http://localhost:8080` öffnen; der Einrichtungsassistent legt das erste
|
||||
Administratorkonto an. Danach verschliesst sich dieser Weg von selbst.
|
||||
|
||||
### Einstellungen
|
||||
|
||||
| Variable | Bedeutung | Voreinstellung im Image |
|
||||
|---|---|---|
|
||||
| `HALO_DATA` | Datenbank und Einstellungen. **Das Einzige, was gesichert werden muss.** | `/config` |
|
||||
| `HALO_CACHE` | Bilder und Zwischenstände. Darf verlorengehen. | `/cache` |
|
||||
| `HALO_TRANSCODE` | Kratzplatz fürs Umrechnen. Am besten auf eine SSD. | `/transcode` |
|
||||
| `ASPNETCORE_URLS` | Worauf gelauscht wird | `http://+:8080` |
|
||||
| `TZ` | Zeitzone | `UTC` |
|
||||
| `HALO_RATELIMIT_SIGNIN` | Anmeldeversuche je Minute und Adresse | `10` |
|
||||
| `HALO_RATELIMIT_POLLING` | Nachfragen je Minute und Adresse | `120` |
|
||||
|
||||
**Medienpfade stehen hier nicht.** Sie werden in der Oberfläche als
|
||||
Bibliotheken angelegt und liegen in der Datenbank — sonst müsste der Container
|
||||
neu starten, um eine Bibliothek hinzuzufügen.
|
||||
|
||||
### Rechte
|
||||
|
||||
Das Image läuft als `1000:1000`, **nicht als root**. Gehören die eingehängten
|
||||
Verzeichnisse jemand anderem, trage in der Compose-Datei
|
||||
`user: "<uid>:<gid>"` ein (`id -u` und `id -g` auf dem Wirt sagen, welche)
|
||||
oder übereigne sie mit `chown`.
|
||||
|
||||
Stimmt etwas nicht, bricht der Server **beim Start** ab und nennt Variable,
|
||||
Pfad, seine eigene Kennung und den nächsten Schritt. Das ist Absicht: ohne
|
||||
diese Meldung stünde dort nur „unable to open database file".
|
||||
|
||||
### Hardware fürs Umrechnen
|
||||
|
||||
`/dev/dri` durchreichen — VAAPI deckt Intel wie AMD ab. Fehlt es, rechnet Halo
|
||||
in Software; das ist langsamer, aber es läuft. **Zum blossen Umpacken wird gar
|
||||
keine Hardware gebraucht**, und das ist der Weg, der den meisten Beständen
|
||||
hilft.
|
||||
|
||||
## Entwickeln
|
||||
|
||||
```bash
|
||||
dotnet test # 55 Tests
|
||||
dotnet run --project src/Halo.Api # auf http://localhost:5000
|
||||
```
|
||||
|
||||
Ohne gesetzte Variablen legt der Server `data/`, `cache/` und `transcode/`
|
||||
neben dem Programm an.
|
||||
|
||||
```bash
|
||||
# Image bauen, beide Architekturen
|
||||
docker buildx build --platform linux/amd64,linux/arm64 -t halo:dev .
|
||||
|
||||
# Eine Migration nach einer Modelländerung
|
||||
dotnet ef migrations add <Name> --project src/Halo.Data --startup-project src/Halo.Api --output-dir Migrations
|
||||
```
|
||||
|
||||
Migrationen wandern **beim Start** des Servers, nicht über ein eigenes
|
||||
Kommando.
|
||||
|
||||
### Aufbau
|
||||
|
||||
| Projekt | Aufgabe |
|
||||
|---|---|
|
||||
| `Halo.Core` | Domäne: Benutzer, Anmeldung, Bibliotheken. Kennt kein HTTP und keine Datenbank |
|
||||
| `Halo.Data` | EF Core, SQLite, Migrationen |
|
||||
| `Halo.Api` | Endpunkte, Authentifizierung, Auslieferung der Oberfläche |
|
||||
|
||||
Was sicherheitsrelevant ist, liegt in `Halo.Core` — dort ist es ohne Server
|
||||
prüfbar, und die Tests dazu sind die, die am meisten wert sind.
|
||||
|
||||
### Zwei Entscheidungen, die beim Lesen Fragen aufwerfen
|
||||
|
||||
**Zeitpunkte liegen als Unix-Millisekunden in der Datenbank, nicht als Text.**
|
||||
SQLite hat keinen Zeittyp; ein `DateTimeOffset` landet sonst als Text mitsamt
|
||||
Zonenversatz, und dann steht `…T12:00+02:00` neben `…T11:00Z` — derselbe
|
||||
Augenblick, als Text aber falsch herum sortiert. EF weigert sich deshalb,
|
||||
`ExpiresAt > jetzt` überhaupt zu übersetzen.
|
||||
|
||||
**Token sind keine JWT.** Der Server schlägt sie nach, statt sie zu prüfen.
|
||||
Ein nachgeschlagenes Token lässt sich **sofort** widerrufen; ein signiertes
|
||||
gilt bis zum Ablauf weiter, und für ein verlorenes Telefon ist das der falsche
|
||||
Satz. In der Datenbank steht nur der Fingerabdruck.
|
||||
|
||||
## Anmeldung am Fernseher
|
||||
|
||||
Ein Passwort auf der Apple-TV-Fernbedienung zu tippen ist eine Zumutung.
|
||||
Stattdessen:
|
||||
|
||||
1. Der Fernseher fordert an und bekommt einen **sechsstelligen Code** für den
|
||||
Bildschirm und einen **Abholschein**, den nur er kennt.
|
||||
2. Am Telefon, angemeldet, wird der Code bestätigt — dort steht, welches Gerät.
|
||||
3. Der Fernseher holt mit seinem Abholschein das Token ab.
|
||||
|
||||
**Der Code allein holt nie ein Token ab.** Ohne den Abholschein wären
|
||||
sechsstellige Codes ein Türschloss mit einer Million Schlüsseln.
|
||||
|
||||
## Lizenz
|
||||
|
||||
**GPL-2.0-only.** Abhängigkeiten müssen dazu passen: MIT, BSD oder GPL-2.0.
|
||||
**Apache-2.0 ist ausgeschlossen** — Einzelheiten und der Grund stehen in
|
||||
[`LICENSES.md`](../LICENSES.md).
|
||||
@@ -0,0 +1,50 @@
|
||||
# Beispiel, kein fertiger Betrieb. Jeder Pfad hier gehört angepasst.
|
||||
#
|
||||
# Übernommen aus einem laufenden Plex-Container auf einem UGREEN-NAS — die
|
||||
# Form ist bewährt, die Werte sind es nur dort.
|
||||
|
||||
services:
|
||||
halo:
|
||||
image: ghcr.io/scarriffle/halo:latest
|
||||
container_name: halo
|
||||
restart: unless-stopped
|
||||
|
||||
ports:
|
||||
- "8080:8080"
|
||||
|
||||
environment:
|
||||
- TZ=Europe/Zurich
|
||||
|
||||
# Wem die Dateien auf dem Wirt gehören. 1000:1000 ist die Voreinstellung
|
||||
# im Image; wer andere Kennungen hat, trägt sie hier ein — `id -u` und
|
||||
# `id -g` auf dem Wirt sagen, welche.
|
||||
user: "1000:1000"
|
||||
|
||||
volumes:
|
||||
# Datenbank und Einstellungen. **Das Einzige, was gesichert werden muss.**
|
||||
- /volume4/CRITICAL/Docker/Halo/config:/config
|
||||
|
||||
# Bilder und Zwischenstände. Darf verlorengehen, baut sich neu auf.
|
||||
- /volume4/CRITICAL/Docker/Halo/cache:/cache
|
||||
|
||||
# Kratzplatz fürs Umrechnen. Am besten auf eine SSD und nicht dorthin,
|
||||
# wo die Medien liegen — hier wird viel und kurzlebig geschrieben.
|
||||
- /volume1/Transcode:/transcode
|
||||
|
||||
# Die Medien. **Schreibgeschützt**, und das ist Absicht: Halo liest nur.
|
||||
# Was hier eingehängt wird, ist der Pfad, den du später in der Oberfläche
|
||||
# als Bibliothek anlegst — also `/media`, nicht `/volume4/MYFLIX`.
|
||||
- /volume4/MYFLIX:/media:ro
|
||||
|
||||
# Hardware fürs Umrechnen. Intel wie AMD laufen über VAAPI an derselben
|
||||
# Stelle. Fehlt die Zeile, rechnet Halo in Software — langsamer, aber es
|
||||
# läuft. Zum blossen Umpacken wird sie ohnehin nicht gebraucht.
|
||||
devices:
|
||||
- /dev/dri:/dev/dri
|
||||
|
||||
healthcheck:
|
||||
test: ["CMD", "dotnet", "--info"]
|
||||
interval: 30s
|
||||
timeout: 5s
|
||||
retries: 3
|
||||
start_period: 20s
|
||||
@@ -0,0 +1,13 @@
|
||||
{
|
||||
"version": 1,
|
||||
"isRoot": true,
|
||||
"tools": {
|
||||
"dotnet-ef": {
|
||||
"version": "10.0.12",
|
||||
"commands": [
|
||||
"dotnet-ef"
|
||||
],
|
||||
"rollForward": false
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,79 @@
|
||||
using System.Security.Claims;
|
||||
using System.Text.Encodings.Web;
|
||||
using Halo.Core.Auth;
|
||||
using Halo.Data;
|
||||
using Microsoft.AspNetCore.Authentication;
|
||||
using Microsoft.EntityFrameworkCore;
|
||||
using Microsoft.Extensions.Options;
|
||||
|
||||
namespace Halo.Api.Auth;
|
||||
|
||||
/// <summary>Weist Anfragen über ein Geräte-Token aus.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
/// <c>Authorization: Bearer <token></c>. Der Server hasht das Vorgezeigte
|
||||
/// und sucht den Fingerabdruck — das Token selbst steht nirgends in der
|
||||
/// Datenbank und ist aus ihr auch nicht zu gewinnen.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// Keine JWT. Ein Token, das der Server nachschlägt, lässt sich <b>sofort</b>
|
||||
/// widerrufen; ein signiertes gilt bis zum Ablauf weiter, und für ein
|
||||
/// verlorenes Telefon ist das der falsche Satz.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public sealed class TokenAuthenticationHandler(
|
||||
IOptionsMonitor<AuthenticationSchemeOptions> options,
|
||||
ILoggerFactory logger,
|
||||
UrlEncoder encoder,
|
||||
HaloContext db,
|
||||
TimeProvider clock) : AuthenticationHandler<AuthenticationSchemeOptions>(options, logger, encoder)
|
||||
{
|
||||
public const string SchemeName = "HaloToken";
|
||||
public const string DeviceTokenIdClaim = "halo:device";
|
||||
|
||||
protected override async Task<AuthenticateResult> HandleAuthenticateAsync()
|
||||
{
|
||||
if (!Request.Headers.TryGetValue("Authorization", out var kopfzeile)) return AuthenticateResult.NoResult();
|
||||
|
||||
var roh = kopfzeile.ToString();
|
||||
const string vorsatz = "Bearer ";
|
||||
if (!roh.StartsWith(vorsatz, StringComparison.OrdinalIgnoreCase)) return AuthenticateResult.NoResult();
|
||||
|
||||
var token = roh[vorsatz.Length..].Trim();
|
||||
if (token.Length == 0) return AuthenticateResult.NoResult();
|
||||
|
||||
var fingerabdruck = Secrets.Fingerprint(token);
|
||||
var eintrag = await db.DeviceTokens.FirstOrDefaultAsync(t => t.TokenFingerprint == fingerabdruck);
|
||||
|
||||
var jetzt = clock.GetUtcNow();
|
||||
if (eintrag is null || !eintrag.IsValid(jetzt)) return AuthenticateResult.Fail("Token gilt nicht.");
|
||||
|
||||
var benutzer = await db.Users.FindAsync(eintrag.UserId);
|
||||
if (benutzer is null) return AuthenticateResult.Fail("Token gilt nicht.");
|
||||
|
||||
// Für die Geräteliste: „zuletzt gesehen". Höchstens einmal je Stunde
|
||||
// geschrieben — bei jeder Anfrage zu schreiben hiesse, jede Anfrage in
|
||||
// einen Schreibzugriff zu verwandeln, und SQLite serialisiert die.
|
||||
if (jetzt - eintrag.LastSeenAt > TimeSpan.FromHours(1))
|
||||
{
|
||||
eintrag.LastSeenAt = jetzt;
|
||||
await db.SaveChangesAsync();
|
||||
}
|
||||
|
||||
var ausweis = new ClaimsIdentity(
|
||||
[
|
||||
new Claim(ClaimTypes.NameIdentifier, benutzer.Id.ToString()),
|
||||
new Claim(ClaimTypes.Name, benutzer.UserName),
|
||||
new Claim(DeviceTokenIdClaim, eintrag.Id.ToString()),
|
||||
.. benutzer.IsAdministrator ? new[] { new Claim(ClaimTypes.Role, HaloRoles.Administrator) } : [],
|
||||
], SchemeName);
|
||||
|
||||
return AuthenticateResult.Success(new AuthenticationTicket(new ClaimsPrincipal(ausweis), SchemeName));
|
||||
}
|
||||
}
|
||||
|
||||
public static class HaloRoles
|
||||
{
|
||||
public const string Administrator = "administrator";
|
||||
}
|
||||
@@ -0,0 +1,190 @@
|
||||
using System.Security.Claims;
|
||||
using Halo.Api.Auth;
|
||||
using Halo.Core.Auth;
|
||||
using Halo.Core.Users;
|
||||
using Halo.Data;
|
||||
using Microsoft.EntityFrameworkCore;
|
||||
|
||||
namespace Halo.Api.Endpoints;
|
||||
|
||||
public static class AuthEndpoints
|
||||
{
|
||||
/// <summary>Ein Hash, gegen den geprüft wird, wenn es den Benutzer gar nicht gibt.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <b>Gegen das Abfragen von Benutzernamen über die Uhr.</b> Ohne ihn
|
||||
/// antwortet der Server bei einem unbekannten Namen sofort und bei einem
|
||||
/// bekannten erst nach dem Argon2-Lauf — vierzig Millisekunden Unterschied,
|
||||
/// und damit lässt sich eine Liste gültiger Konten zusammentragen.
|
||||
/// </remarks>
|
||||
private static readonly Lazy<string> Strohmann =
|
||||
new(() => PasswordHasher.Hash(Secrets.Create()), LazyThreadSafetyMode.ExecutionAndPublication);
|
||||
|
||||
public static void MapAuth(this IEndpointRouteBuilder app)
|
||||
{
|
||||
app.MapPost("/api/v1/auth/login", async (
|
||||
LoginRequest anfrage, HaloContext db, TimeProvider clock) =>
|
||||
{
|
||||
var name = anfrage.UserName.Trim();
|
||||
var benutzer = await db.Users.FirstOrDefaultAsync(u => u.UserName == name);
|
||||
|
||||
if (benutzer is null)
|
||||
{
|
||||
// Dieselbe Arbeit wie bei einem echten Konto, dann ablehnen.
|
||||
PasswordHasher.Verify(anfrage.Password, Strohmann.Value);
|
||||
return Abgelehnt();
|
||||
}
|
||||
|
||||
if (!PasswordHasher.Verify(anfrage.Password, benutzer.PasswordHash)) return Abgelehnt();
|
||||
|
||||
// Gelegenheit genutzt: hier liegt das Passwort im Klartext vor, und
|
||||
// nur hier lässt sich ein nach alten Kennwerten gebildeter Hash
|
||||
// überhaupt erneuern.
|
||||
if (PasswordHasher.NeedsRehash(benutzer.PasswordHash))
|
||||
benutzer.PasswordHash = PasswordHasher.Hash(anfrage.Password);
|
||||
|
||||
var antwort = await TokenAusstellen(db, clock, benutzer, anfrage.DeviceName, anfrage.DeviceId);
|
||||
await db.SaveChangesAsync();
|
||||
return Results.Ok(antwort);
|
||||
}).AllowAnonymous().RequireRateLimiting(HaloRateLimits.SignIn);
|
||||
|
||||
app.MapPost("/api/v1/auth/logout", async (ClaimsPrincipal wer, HaloContext db, TimeProvider clock) =>
|
||||
{
|
||||
if (!Guid.TryParse(wer.FindFirstValue(TokenAuthenticationHandler.DeviceTokenIdClaim), out var id))
|
||||
return Results.Unauthorized();
|
||||
|
||||
var eintrag = await db.DeviceTokens.FindAsync(id);
|
||||
if (eintrag is not null)
|
||||
{
|
||||
eintrag.RevokedAt = clock.GetUtcNow();
|
||||
await db.SaveChangesAsync();
|
||||
}
|
||||
return Results.NoContent();
|
||||
}).RequireAuthorization();
|
||||
|
||||
app.MapGet("/api/v1/auth/me", (ClaimsPrincipal wer) =>
|
||||
Guid.TryParse(wer.FindFirstValue(ClaimTypes.NameIdentifier), out var id)
|
||||
? Results.Ok(new AuthenticatedUser(
|
||||
id,
|
||||
wer.FindFirstValue(ClaimTypes.Name) ?? "",
|
||||
wer.IsInRole(HaloRoles.Administrator)))
|
||||
: Results.Unauthorized())
|
||||
.RequireAuthorization();
|
||||
|
||||
MapCodeFlow(app);
|
||||
}
|
||||
|
||||
/// <summary>Anmelden mit einem Code auf dem Bildschirm.</summary>
|
||||
private static void MapCodeFlow(IEndpointRouteBuilder app)
|
||||
{
|
||||
app.MapPost("/api/v1/auth/code", async (CodeRequest anfrage, HaloContext db, TimeProvider clock) =>
|
||||
{
|
||||
var jetzt = clock.GetUtcNow();
|
||||
|
||||
// Beiläufig aufräumen. Ein eigener Hintergrunddienst für ein paar
|
||||
// Zeilen je Tag wäre Aufwand ohne Gegenwert.
|
||||
await db.AuthCodes.Where(c => c.ExpiresAt < jetzt).ExecuteDeleteAsync();
|
||||
|
||||
var abholschein = Secrets.Create();
|
||||
var code = new AuthCode
|
||||
{
|
||||
Code = AuthCode.NewCode(),
|
||||
HandleFingerprint = Secrets.Fingerprint(abholschein),
|
||||
DeviceName = Kürzen(anfrage.DeviceName, 128),
|
||||
DeviceId = Kürzen(anfrage.DeviceId, 128),
|
||||
CreatedAt = jetzt,
|
||||
ExpiresAt = jetzt + AuthCode.Lifetime,
|
||||
};
|
||||
db.AuthCodes.Add(code);
|
||||
await db.SaveChangesAsync();
|
||||
|
||||
return Results.Ok(new CodeResponse(code.Code, abholschein, code.ExpiresAt));
|
||||
}).AllowAnonymous().RequireRateLimiting(HaloRateLimits.SignIn);
|
||||
|
||||
app.MapGet("/api/v1/auth/code/{handle}", async (
|
||||
string handle, HaloContext db, TimeProvider clock) =>
|
||||
{
|
||||
var jetzt = clock.GetUtcNow();
|
||||
var fingerabdruck = Secrets.Fingerprint(handle);
|
||||
var code = await db.AuthCodes.FirstOrDefaultAsync(c => c.HandleFingerprint == fingerabdruck);
|
||||
|
||||
if (code is null || code.IsExpired(jetzt) || code.ConsumedAt is not null)
|
||||
return Results.Ok(new CodeState("expired", null));
|
||||
|
||||
if (code.ApprovedByUserId is not { } benutzerId)
|
||||
return Results.Ok(new CodeState("pending", null));
|
||||
|
||||
var benutzer = await db.Users.FindAsync(benutzerId);
|
||||
if (benutzer is null) return Results.Ok(new CodeState("expired", null));
|
||||
|
||||
// Einmal abgeholt ist abgeholt — vor dem Ausstellen gesetzt, damit
|
||||
// zwei gleichzeitige Abholungen nicht zwei Token ergeben.
|
||||
code.ConsumedAt = jetzt;
|
||||
var antwort = await TokenAusstellen(db, clock, benutzer, code.DeviceName, code.DeviceId);
|
||||
await db.SaveChangesAsync();
|
||||
|
||||
return Results.Ok(new CodeState("approved", antwort));
|
||||
}).AllowAnonymous().RequireRateLimiting(HaloRateLimits.Polling);
|
||||
|
||||
app.MapPost("/api/v1/auth/code/{code}", async (
|
||||
string code, ClaimsPrincipal wer, HaloContext db, TimeProvider clock) =>
|
||||
{
|
||||
if (!Guid.TryParse(wer.FindFirstValue(ClaimTypes.NameIdentifier), out var benutzerId))
|
||||
return Results.Unauthorized();
|
||||
|
||||
var jetzt = clock.GetUtcNow();
|
||||
var offen = await db.AuthCodes.FirstOrDefaultAsync(c =>
|
||||
c.Code == code && c.ApprovedByUserId == null && c.ExpiresAt > jetzt);
|
||||
|
||||
if (offen is null)
|
||||
return Results.Problem("Dieser Code gilt nicht mehr.", statusCode: StatusCodes.Status404NotFound);
|
||||
|
||||
offen.ApprovedByUserId = benutzerId;
|
||||
await db.SaveChangesAsync();
|
||||
|
||||
// Damit am Telefon steht, was man da gerade hereinlässt.
|
||||
return Results.Ok(new { device = offen.DeviceName });
|
||||
}).RequireAuthorization().RequireRateLimiting(HaloRateLimits.SignIn);
|
||||
}
|
||||
|
||||
/// <summary>Stellt ein Geräte-Token aus und löst ein älteres desselben Geräts ab.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// Ohne das Ablösen füllt sich die Geräteliste mit Karteileichen: jede
|
||||
/// erneute Anmeldung derselben App hinterliesse einen weiteren Eintrag,
|
||||
/// und nach einem Jahr weiss niemand mehr, welches Telefon welches ist.
|
||||
/// </remarks>
|
||||
private static async Task<LoginResponse> TokenAusstellen(
|
||||
HaloContext db, TimeProvider clock, User benutzer, string geräteName, string geräteKennung)
|
||||
{
|
||||
var jetzt = clock.GetUtcNow();
|
||||
var kennung = Kürzen(geräteKennung, 128);
|
||||
|
||||
await db.DeviceTokens
|
||||
.Where(t => t.UserId == benutzer.Id && t.DeviceId == kennung && t.RevokedAt == null)
|
||||
.ExecuteUpdateAsync(s => s.SetProperty(t => t.RevokedAt, jetzt));
|
||||
|
||||
var token = Secrets.Create();
|
||||
db.DeviceTokens.Add(new DeviceToken
|
||||
{
|
||||
UserId = benutzer.Id,
|
||||
TokenFingerprint = Secrets.Fingerprint(token),
|
||||
DeviceName = Kürzen(geräteName, 128),
|
||||
DeviceId = kennung,
|
||||
CreatedAt = jetzt,
|
||||
LastSeenAt = jetzt,
|
||||
});
|
||||
|
||||
return new LoginResponse(token, new AuthenticatedUser(benutzer.Id, benutzer.UserName, benutzer.IsAdministrator));
|
||||
}
|
||||
|
||||
/// <summary>Eine Antwort, die nicht verrät, welche Hälfte falsch war.</summary>
|
||||
private static IResult Abgelehnt() =>
|
||||
Results.Problem("Benutzername oder Passwort stimmt nicht.", statusCode: StatusCodes.Status401Unauthorized);
|
||||
|
||||
private static string Kürzen(string? wert, int höchstens)
|
||||
{
|
||||
var sauber = (wert ?? "").Trim();
|
||||
return sauber.Length <= höchstens ? sauber : sauber[..höchstens];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,33 @@
|
||||
namespace Halo.Api.Endpoints;
|
||||
|
||||
// Was über die Leitung geht. Bewusst eigene Typen und nicht die der Domäne:
|
||||
// sonst wandert jede Umbenennung im Datenmodell ungefragt in die Schnittstelle
|
||||
// und bricht Clients, die niemand mehr aktualisiert.
|
||||
|
||||
public sealed record SystemInfo(string Version, bool NeedsSetup);
|
||||
|
||||
public sealed record SetupRequest(string UserName, string Password);
|
||||
|
||||
public sealed record LoginRequest(string UserName, string Password, string DeviceName, string DeviceId);
|
||||
|
||||
public sealed record AuthenticatedUser(Guid Id, string UserName, bool IsAdministrator);
|
||||
|
||||
public sealed record LoginResponse(string Token, AuthenticatedUser User);
|
||||
|
||||
public sealed record CodeRequest(string DeviceName, string DeviceId);
|
||||
|
||||
/// <summary>Was der Fernseher nach dem Anfordern bekommt.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// Der <c>Handle</c> ist das Geheimnis und wird <b>nicht</b> angezeigt — der
|
||||
/// <c>Code</c> ist das, was auf dem Bildschirm steht.
|
||||
/// </remarks>
|
||||
public sealed record CodeResponse(string Code, string Handle, DateTimeOffset ExpiresAt);
|
||||
|
||||
public sealed record CodeState(string State, LoginResponse? Login);
|
||||
|
||||
public sealed record CreateUserRequest(string UserName, string Password, bool IsAdministrator);
|
||||
|
||||
public sealed record LibraryResponse(Guid Id, string Name, string Kind, string Path);
|
||||
|
||||
public sealed record CreateLibraryRequest(string Name, string Kind, string Path);
|
||||
@@ -0,0 +1,94 @@
|
||||
using Halo.Api.Auth;
|
||||
using Halo.Core.Libraries;
|
||||
using Halo.Core.Users;
|
||||
using Halo.Data;
|
||||
using Microsoft.EntityFrameworkCore;
|
||||
|
||||
namespace Halo.Api.Endpoints;
|
||||
|
||||
public static class ManagementEndpoints
|
||||
{
|
||||
public static void MapManagement(this IEndpointRouteBuilder app)
|
||||
{
|
||||
var benutzer = app.MapGroup("/api/v1/users").RequireAuthorization(HaloPolicies.Administrator);
|
||||
|
||||
benutzer.MapGet("/", async (HaloContext db) =>
|
||||
Results.Ok(await db.Users
|
||||
.OrderBy(u => u.UserName)
|
||||
.Select(u => new AuthenticatedUser(u.Id, u.UserName, u.IsAdministrator))
|
||||
.ToListAsync()));
|
||||
|
||||
benutzer.MapPost("/", async (CreateUserRequest anfrage, HaloContext db) =>
|
||||
{
|
||||
var name = anfrage.UserName.Trim();
|
||||
if (name.Length == 0 || anfrage.Password.Length < 8)
|
||||
return Results.ValidationProblem(new Dictionary<string, string[]>
|
||||
{
|
||||
["password"] = ["Benutzername darf nicht leer sein, das Passwort braucht mindestens 8 Zeichen."],
|
||||
});
|
||||
|
||||
if (await db.Users.AnyAsync(u => u.UserName == name))
|
||||
return Results.Problem($"„{name}“ gibt es schon.", statusCode: StatusCodes.Status409Conflict);
|
||||
|
||||
var neu = new User
|
||||
{
|
||||
UserName = name,
|
||||
PasswordHash = PasswordHasher.Hash(anfrage.Password),
|
||||
IsAdministrator = anfrage.IsAdministrator,
|
||||
};
|
||||
db.Users.Add(neu);
|
||||
await db.SaveChangesAsync();
|
||||
return Results.Created($"/api/v1/users/{neu.Id}",
|
||||
new AuthenticatedUser(neu.Id, neu.UserName, neu.IsAdministrator));
|
||||
});
|
||||
|
||||
var bibliotheken = app.MapGroup("/api/v1/libraries");
|
||||
|
||||
// Lesen darf jeder Angemeldete — ohne die Liste zeigt die App nichts an.
|
||||
bibliotheken.MapGet("/", async (HaloContext db) =>
|
||||
Results.Ok(await db.Libraries
|
||||
.OrderBy(l => l.Name)
|
||||
.Select(l => new LibraryResponse(l.Id, l.Name, l.Kind.ToString(), l.Path))
|
||||
.ToListAsync()))
|
||||
.RequireAuthorization();
|
||||
|
||||
bibliotheken.MapPost("/", async (CreateLibraryRequest anfrage, HaloContext db) =>
|
||||
{
|
||||
if (!Enum.TryParse<LibraryKind>(anfrage.Kind, ignoreCase: true, out var art))
|
||||
return Results.ValidationProblem(new Dictionary<string, string[]>
|
||||
{
|
||||
["kind"] = [$"Unbekannte Art „{anfrage.Kind}“. Möglich: Movies, Shows."],
|
||||
});
|
||||
|
||||
// **Jetzt prüfen, nicht beim ersten Scan.** Ein Tippfehler im Pfad
|
||||
// führte sonst zu einer Bibliothek, die dauerhaft leer bleibt, und
|
||||
// die Ursache stünde allenfalls im Protokoll.
|
||||
if (!Directory.Exists(anfrage.Path))
|
||||
return Results.ValidationProblem(new Dictionary<string, string[]>
|
||||
{
|
||||
["path"] = [$"„{anfrage.Path}“ gibt es im Container nicht. " +
|
||||
"Ist das Verzeichnis eingehängt? Gemeint ist der Pfad im Container, nicht der auf dem Wirt."],
|
||||
});
|
||||
|
||||
var neu = new Library { Name = anfrage.Name.Trim(), Kind = art, Path = anfrage.Path };
|
||||
db.Libraries.Add(neu);
|
||||
await db.SaveChangesAsync();
|
||||
return Results.Created($"/api/v1/libraries/{neu.Id}",
|
||||
new LibraryResponse(neu.Id, neu.Name, neu.Kind.ToString(), neu.Path));
|
||||
}).RequireAuthorization(HaloPolicies.Administrator);
|
||||
}
|
||||
}
|
||||
|
||||
public static class HaloPolicies
|
||||
{
|
||||
public const string Administrator = "administrator-only";
|
||||
}
|
||||
|
||||
public static class HaloRateLimits
|
||||
{
|
||||
/// <summary>Für alles, was ein Geheimnis prüft.</summary>
|
||||
public const string SignIn = "sign-in";
|
||||
|
||||
/// <summary>Für das Nachfragen des Fernsehers — darf häufig sein.</summary>
|
||||
public const string Polling = "polling";
|
||||
}
|
||||
@@ -0,0 +1,61 @@
|
||||
using Halo.Core.Users;
|
||||
using Halo.Data;
|
||||
using Microsoft.EntityFrameworkCore;
|
||||
|
||||
namespace Halo.Api.Endpoints;
|
||||
|
||||
public static class SystemEndpoints
|
||||
{
|
||||
/// <summary>Verhindert, dass zwei gleichzeitige Anfragen zwei Administratoren anlegen.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// Ein Prozess, ein Container — ein Semaphor reicht. Ohne ihn liegt
|
||||
/// zwischen „kein Benutzer vorhanden" und dem Anlegen ein Fenster, und
|
||||
/// genau in dieses Fenster passt eine zweite Anfrage.
|
||||
/// </remarks>
|
||||
private static readonly SemaphoreSlim EinrichtungsSchloss = new(1, 1);
|
||||
|
||||
public static void MapSystem(this IEndpointRouteBuilder app)
|
||||
{
|
||||
app.MapGet("/api/v1/system/info", async (HaloContext db) =>
|
||||
Results.Ok(new SystemInfo(
|
||||
Version: typeof(SystemEndpoints).Assembly.GetName().Version?.ToString(3) ?? "0.0.0",
|
||||
NeedsSetup: !await db.Users.AnyAsync())))
|
||||
.AllowAnonymous();
|
||||
|
||||
app.MapPost("/api/v1/system/setup", async (SetupRequest anfrage, HaloContext db) =>
|
||||
{
|
||||
if (string.IsNullOrWhiteSpace(anfrage.UserName) || anfrage.Password.Length < 8)
|
||||
return Results.ValidationProblem(new Dictionary<string, string[]>
|
||||
{
|
||||
["password"] = ["Benutzername darf nicht leer sein, das Passwort braucht mindestens 8 Zeichen."],
|
||||
});
|
||||
|
||||
await EinrichtungsSchloss.WaitAsync();
|
||||
try
|
||||
{
|
||||
// Noch einmal prüfen, innerhalb des Schlosses. Draussen wäre die
|
||||
// Antwort schon veraltet, wenn sie ankommt.
|
||||
if (await db.Users.AnyAsync())
|
||||
return Results.Problem(
|
||||
"Dieser Server ist bereits eingerichtet.", statusCode: StatusCodes.Status409Conflict);
|
||||
|
||||
var administrator = new User
|
||||
{
|
||||
UserName = anfrage.UserName.Trim(),
|
||||
PasswordHash = PasswordHasher.Hash(anfrage.Password),
|
||||
IsAdministrator = true,
|
||||
};
|
||||
db.Users.Add(administrator);
|
||||
await db.SaveChangesAsync();
|
||||
|
||||
return Results.Ok(new AuthenticatedUser(administrator.Id, administrator.UserName, true));
|
||||
}
|
||||
finally { EinrichtungsSchloss.Release(); }
|
||||
}).AllowAnonymous();
|
||||
|
||||
// Ohne Anmeldung, damit Docker und Reverse Proxies danach fragen können.
|
||||
// Verrät nichts ausser der Tatsache, dass etwas antwortet.
|
||||
app.MapGet("/health", () => Results.Ok(new { status = "ok" })).AllowAnonymous();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,21 @@
|
||||
<Project Sdk="Microsoft.NET.Sdk.Web">
|
||||
|
||||
<ItemGroup>
|
||||
<ProjectReference Include="..\Halo.Core\Halo.Core.csproj" />
|
||||
<ProjectReference Include="..\Halo.Data\Halo.Data.csproj" />
|
||||
</ItemGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.12">
|
||||
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
|
||||
<PrivateAssets>all</PrivateAssets>
|
||||
</PackageReference>
|
||||
</ItemGroup>
|
||||
|
||||
<PropertyGroup>
|
||||
<TargetFramework>net10.0</TargetFramework>
|
||||
<Nullable>enable</Nullable>
|
||||
<ImplicitUsings>enable</ImplicitUsings>
|
||||
</PropertyGroup>
|
||||
|
||||
</Project>
|
||||
@@ -0,0 +1,110 @@
|
||||
namespace Halo.Api;
|
||||
|
||||
/// <summary>Wo der Server seine Sachen ablegt.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
/// <b>Alles aus der Umgebung, nichts im Code.</b> Dies ist kein Server für
|
||||
/// einen Haushalt: wer ihn startet, hat ein anderes NAS, andere Platten und
|
||||
/// andere Gewohnheiten. Ein fester Pfad hier wäre eine Annahme über ein
|
||||
/// fremdes System.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// Die Voreinstellungen sind die für Entwicklung auf einem Arbeitsrechner —
|
||||
/// ein Unterverzeichnis neben dem Programm. Im Container setzt das Dockerfile
|
||||
/// <c>/config</c>, <c>/cache</c> und <c>/transcode</c>; das sind die Pfade,
|
||||
/// die in der Compose-Datei eingehängt werden.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// <b>Medienpfade stehen hier nicht.</b> Sie werden in der Oberfläche als
|
||||
/// Bibliotheken angelegt und liegen in der Datenbank — sonst müsste der
|
||||
/// Container neu starten, um eine Bibliothek hinzuzufügen.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public sealed class HaloPaths
|
||||
{
|
||||
public required string Data { get; init; }
|
||||
public required string Cache { get; init; }
|
||||
public required string Transcode { get; init; }
|
||||
|
||||
public string DatabaseFile => Path.Combine(Data, "halo.db");
|
||||
|
||||
public static HaloPaths FromEnvironment(string contentRoot)
|
||||
{
|
||||
string lies(string name, string voreinstellung) =>
|
||||
Environment.GetEnvironmentVariable(name) is { Length: > 0 } wert
|
||||
? wert
|
||||
: Path.Combine(contentRoot, voreinstellung);
|
||||
|
||||
return new HaloPaths
|
||||
{
|
||||
Data = lies("HALO_DATA", "data"),
|
||||
Cache = lies("HALO_CACHE", "cache"),
|
||||
Transcode = lies("HALO_TRANSCODE", "transcode"),
|
||||
};
|
||||
}
|
||||
|
||||
/// <summary>Legt an, was fehlt — und prüft, ob sich dort wirklich schreiben lässt.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
/// <b>Anlegen allein genügt nicht.</b> Ein vorhandenes Verzeichnis, in das
|
||||
/// der Benutzer nicht schreiben darf, lässt <c>CreateDirectory</c> ohne
|
||||
/// Murren durchgehen — und der Server stirbt zehn Zeilen später an
|
||||
/// „unable to open database file". Diese Meldung sagt niemandem, dass es
|
||||
/// um Dateirechte geht, geschweige denn um welches Verzeichnis.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// Es ist der häufigste Stolperstein beim ersten Start eines Containers,
|
||||
/// und deshalb wird hier tatsächlich eine Datei angelegt und wieder
|
||||
/// gelöscht, statt es anzunehmen.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public void EnsureExists()
|
||||
{
|
||||
foreach (var (name, pfad) in new[] { ("HALO_DATA", Data), ("HALO_CACHE", Cache), ("HALO_TRANSCODE", Transcode) })
|
||||
{
|
||||
try
|
||||
{
|
||||
Directory.CreateDirectory(pfad);
|
||||
|
||||
var probe = Path.Combine(pfad, $".halo-schreibprobe-{Environment.ProcessId}");
|
||||
File.WriteAllBytes(probe, []);
|
||||
File.Delete(probe);
|
||||
}
|
||||
catch (Exception fehler)
|
||||
{
|
||||
throw new InvalidOperationException(
|
||||
$"""
|
||||
{name} zeigt auf „{pfad}“, und dort lässt sich nicht schreiben.
|
||||
|
||||
Halo läuft als Benutzer {Kennung()}. Dieses Verzeichnis muss
|
||||
ihm gehören oder für ihn beschreibbar sein.
|
||||
|
||||
Im Container ist das fast immer die Einhängung: entweder gehört
|
||||
das Verzeichnis auf dem Wirt jemand anderem — dann hilft
|
||||
`chown -R <uid>:<gid> <verzeichnis>` —, oder in der
|
||||
Compose-Datei steht ein `user:`, der nicht dazu passt.
|
||||
|
||||
Ursprüngliche Meldung: {fehler.Message}
|
||||
""", fehler);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>Unter welcher Kennung der Prozess läuft — die eine Angabe, die beim Suchen hilft.</summary>
|
||||
private static string Kennung()
|
||||
{
|
||||
if (OperatingSystem.IsWindows()) return Environment.UserName;
|
||||
return $"uid={LibC.getuid()}, gid={LibC.getgid()}";
|
||||
}
|
||||
|
||||
private static partial class LibC
|
||||
{
|
||||
[System.Runtime.InteropServices.DllImport("libc", EntryPoint = "getuid")]
|
||||
public static extern uint getuid();
|
||||
|
||||
[System.Runtime.InteropServices.DllImport("libc", EntryPoint = "getgid")]
|
||||
public static extern uint getgid();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,84 @@
|
||||
using System.Threading.RateLimiting;
|
||||
using Halo.Api;
|
||||
using Halo.Api.Auth;
|
||||
using Halo.Api.Endpoints;
|
||||
using Halo.Data;
|
||||
using Microsoft.AspNetCore.Authentication;
|
||||
using Microsoft.AspNetCore.RateLimiting;
|
||||
using Microsoft.EntityFrameworkCore;
|
||||
|
||||
var builder = WebApplication.CreateBuilder(args);
|
||||
|
||||
var pfade = HaloPaths.FromEnvironment(builder.Environment.ContentRootPath);
|
||||
pfade.EnsureExists();
|
||||
builder.Services.AddSingleton(pfade);
|
||||
builder.Services.AddSingleton(TimeProvider.System);
|
||||
|
||||
builder.Services.AddDbContext<HaloContext>(o => o.UseSqlite($"Data Source={pfade.DatabaseFile}"));
|
||||
|
||||
builder.Services
|
||||
.AddAuthentication(TokenAuthenticationHandler.SchemeName)
|
||||
.AddScheme<AuthenticationSchemeOptions, TokenAuthenticationHandler>(
|
||||
TokenAuthenticationHandler.SchemeName, _ => { });
|
||||
|
||||
builder.Services.AddAuthorizationBuilder()
|
||||
// Jeder Endpunkt verlangt Anmeldung, sofern er sie nicht ausdrücklich
|
||||
// abbestellt. Andersherum — jeden einzeln absichern — ist der Entwurf, bei
|
||||
// dem irgendwann einer vergessen wird.
|
||||
.SetFallbackPolicy(new Microsoft.AspNetCore.Authorization.AuthorizationPolicyBuilder()
|
||||
.RequireAuthenticatedUser().Build())
|
||||
.AddPolicy(HaloPolicies.Administrator, p => p.RequireRole(HaloRoles.Administrator));
|
||||
|
||||
// Einstellbar, weil die richtige Zahl vom Aufbau abhängt: steht Halo hinter
|
||||
// einem Reverse Proxy, erscheinen **alle** Benutzer unter derselben Adresse
|
||||
// und teilen sich einen Eimer. Wer das nicht weiss, hält die eigene App für
|
||||
// kaputt, während in Wahrheit der Nachbar im selben Haus gerade angemeldet hat.
|
||||
//
|
||||
// NOCH OFFEN: `X-Forwarded-For` auswerten, damit die Aufteilung auch hinter
|
||||
// einem Proxy je Benutzer greift. Blind zu vertrauen wäre falsch — es braucht
|
||||
// eine Liste vertrauenswürdiger Gegenstellen.
|
||||
int grenze(string name, int voreinstellung) =>
|
||||
int.TryParse(Environment.GetEnvironmentVariable(name), out var wert) && wert > 0 ? wert : voreinstellung;
|
||||
|
||||
builder.Services.AddRateLimiter(o =>
|
||||
{
|
||||
o.RejectionStatusCode = StatusCodes.Status429TooManyRequests;
|
||||
var beimAnmelden = grenze("HALO_RATELIMIT_SIGNIN", 10);
|
||||
var beimNachfragen = grenze("HALO_RATELIMIT_POLLING", 120);
|
||||
|
||||
// Je Absender, nicht global: sonst sperrt ein einzelner Angreifer den
|
||||
// ganzen Haushalt aus, und die Abwehr wäre selbst der Ausfall.
|
||||
o.AddPolicy(HaloRateLimits.SignIn, anfrage => RateLimitPartition.GetFixedWindowLimiter(
|
||||
anfrage.Connection.RemoteIpAddress?.ToString() ?? "unbekannt",
|
||||
_ => new FixedWindowRateLimiterOptions { PermitLimit = beimAnmelden, Window = TimeSpan.FromMinutes(1) }));
|
||||
|
||||
o.AddPolicy(HaloRateLimits.Polling, anfrage => RateLimitPartition.GetFixedWindowLimiter(
|
||||
anfrage.Connection.RemoteIpAddress?.ToString() ?? "unbekannt",
|
||||
_ => new FixedWindowRateLimiterOptions { PermitLimit = beimNachfragen, Window = TimeSpan.FromMinutes(1) }));
|
||||
});
|
||||
|
||||
builder.Services.AddProblemDetails();
|
||||
|
||||
var app = builder.Build();
|
||||
|
||||
// Beim Start wandern, nicht über ein eigenes Kommando: wer den Container
|
||||
// hochfährt, soll nicht erst eine Migration von Hand anstossen müssen.
|
||||
using (var bereich = app.Services.CreateScope())
|
||||
{
|
||||
await bereich.ServiceProvider.GetRequiredService<HaloContext>().Database.MigrateAsync();
|
||||
}
|
||||
|
||||
app.UseExceptionHandler();
|
||||
app.UseStatusCodePages();
|
||||
app.UseRateLimiter();
|
||||
app.UseAuthentication();
|
||||
app.UseAuthorization();
|
||||
|
||||
app.MapSystem();
|
||||
app.MapAuth();
|
||||
app.MapManagement();
|
||||
|
||||
app.Run();
|
||||
|
||||
/// <summary>Damit die Tests den Server hochfahren können.</summary>
|
||||
public partial class Program;
|
||||
@@ -0,0 +1,23 @@
|
||||
{
|
||||
"$schema": "https://json.schemastore.org/launchsettings.json",
|
||||
"profiles": {
|
||||
"http": {
|
||||
"commandName": "Project",
|
||||
"dotnetRunMessages": true,
|
||||
"launchBrowser": true,
|
||||
"applicationUrl": "http://localhost:5153",
|
||||
"environmentVariables": {
|
||||
"ASPNETCORE_ENVIRONMENT": "Development"
|
||||
}
|
||||
},
|
||||
"https": {
|
||||
"commandName": "Project",
|
||||
"dotnetRunMessages": true,
|
||||
"launchBrowser": true,
|
||||
"applicationUrl": "https://localhost:7190;http://localhost:5153",
|
||||
"environmentVariables": {
|
||||
"ASPNETCORE_ENVIRONMENT": "Development"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,8 @@
|
||||
{
|
||||
"Logging": {
|
||||
"LogLevel": {
|
||||
"Default": "Information",
|
||||
"Microsoft.AspNetCore": "Warning"
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,9 @@
|
||||
{
|
||||
"Logging": {
|
||||
"LogLevel": {
|
||||
"Default": "Information",
|
||||
"Microsoft.AspNetCore": "Warning"
|
||||
}
|
||||
},
|
||||
"AllowedHosts": "*"
|
||||
}
|
||||
@@ -0,0 +1,58 @@
|
||||
using System.Security.Cryptography;
|
||||
|
||||
namespace Halo.Core.Auth;
|
||||
|
||||
/// <summary>Eine laufende Anmeldung per Code — für den Fernseher.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
/// Ein Passwort auf der Apple-TV-Fernbedienung einzutippen ist eine Zumutung,
|
||||
/// die man selbst jedes Mal spürt. Stattdessen: sechsstelliger Code auf dem
|
||||
/// Bildschirm, Bestätigung am Telefon.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// <b>Der Code allein holt nie ein Token ab.</b> Dafür gibt es den Abholschein,
|
||||
/// den nur das anfragende Gerät kennt und der hier nur als Fingerabdruck
|
||||
/// liegt. Ohne ihn könnte jemand sechsstellige Zahlen durchprobieren — eine
|
||||
/// Million Versuche sind nichts, und am Ende stünde ein fremdes Gerät in der
|
||||
/// Mediathek.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public sealed class AuthCode
|
||||
{
|
||||
/// <summary>Kurz genug zum Vorlesen, lang genug zum Nichterraten.</summary>
|
||||
public const int CodeLength = 6;
|
||||
|
||||
/// <summary>So lange, wie jemand braucht, um zum Telefon zu greifen.</summary>
|
||||
public static readonly TimeSpan Lifetime = TimeSpan.FromMinutes(5);
|
||||
|
||||
public Guid Id { get; init; } = Guid.CreateVersion7();
|
||||
public required string Code { get; init; }
|
||||
public required string HandleFingerprint { get; init; }
|
||||
public required string DeviceName { get; init; }
|
||||
public required string DeviceId { get; init; }
|
||||
public DateTimeOffset CreatedAt { get; init; } = DateTimeOffset.UtcNow;
|
||||
public required DateTimeOffset ExpiresAt { get; init; }
|
||||
|
||||
/// <summary>Wer bestätigt hat — <c>null</c>, solange niemand.</summary>
|
||||
public Guid? ApprovedByUserId { get; set; }
|
||||
|
||||
/// <summary>Wann das Token abgeholt wurde. Danach ist der Code verbraucht.</summary>
|
||||
public DateTimeOffset? ConsumedAt { get; set; }
|
||||
|
||||
public bool IsExpired(DateTimeOffset now) => now >= ExpiresAt;
|
||||
|
||||
/// <summary>Ob jetzt ein Token herausgegeben werden darf.</summary>
|
||||
public bool CanBeRedeemed(DateTimeOffset now) =>
|
||||
ApprovedByUserId is not null && ConsumedAt is null && !IsExpired(now);
|
||||
|
||||
/// <summary>Sechs Ziffern, gleichverteilt gezogen.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <see cref="RandomNumberGenerator"/> und nicht <see cref="Random"/>: der
|
||||
/// Code ist ein Zugang. Die obere Grenze ist ausschliesslich, führende
|
||||
/// Nullen bleiben erhalten.
|
||||
/// </remarks>
|
||||
public static string NewCode() =>
|
||||
RandomNumberGenerator.GetInt32(0, 1_000_000).ToString("D" + CodeLength);
|
||||
}
|
||||
@@ -0,0 +1,33 @@
|
||||
namespace Halo.Core.Auth;
|
||||
|
||||
/// <summary>Ein angemeldetes Gerät.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// Ein Eintrag je Gerät, nicht je Benutzer: so lässt sich ein verlorenes
|
||||
/// Telefon einzeln aussperren, ohne alle anderen abzumelden.
|
||||
/// </remarks>
|
||||
public sealed class DeviceToken
|
||||
{
|
||||
public Guid Id { get; init; } = Guid.CreateVersion7();
|
||||
public required Guid UserId { get; init; }
|
||||
|
||||
/// <summary>Siehe <see cref="Secrets.Fingerprint"/> — nie das Token selbst.</summary>
|
||||
public required string TokenFingerprint { get; init; }
|
||||
|
||||
/// <summary>Wie das Gerät sich nennt, für die Geräteliste.</summary>
|
||||
public required string DeviceName { get; init; }
|
||||
|
||||
/// <summary>Die vom Client vergebene Gerätekennung.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// Damit dieselbe App nach einer erneuten Anmeldung denselben Eintrag
|
||||
/// ablöst, statt die Liste mit Karteileichen zu füllen.
|
||||
/// </remarks>
|
||||
public required string DeviceId { get; init; }
|
||||
|
||||
public DateTimeOffset CreatedAt { get; init; } = DateTimeOffset.UtcNow;
|
||||
public DateTimeOffset LastSeenAt { get; set; } = DateTimeOffset.UtcNow;
|
||||
public DateTimeOffset? RevokedAt { get; set; }
|
||||
|
||||
public bool IsValid(DateTimeOffset now) => RevokedAt is null || RevokedAt > now;
|
||||
}
|
||||
@@ -0,0 +1,32 @@
|
||||
using System.Security.Cryptography;
|
||||
using System.Text;
|
||||
|
||||
namespace Halo.Core.Auth;
|
||||
|
||||
/// <summary>Erzeugt und verfingert Geheimnisse, die Clients vorzeigen.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <b>Abgelegt wird nur der Fingerabdruck, nie das Geheimnis.</b> Wer die
|
||||
/// Datenbank erbeutet, hat damit Hashes und keine Zugänge. Dass das überhaupt
|
||||
/// erwähnt werden muss: bei Medienservern liegen Token regelmässig im
|
||||
/// Klartext, und ein einziges Datenbankleck gibt dann jedem alles.
|
||||
///
|
||||
/// SHA-256 ohne Salz und ohne Streckung genügt hier — anders als bei
|
||||
/// Passwörtern. Diese Geheimnisse sind 256 Bit Zufall; sie zu erraten ist
|
||||
/// aussichtslos, ganz gleich wie schnell jemand hashen kann.
|
||||
/// </remarks>
|
||||
public static class Secrets
|
||||
{
|
||||
private const int Bytes = 32;
|
||||
|
||||
/// <summary>Ein neues Geheimnis, in URL-sicherem Base64.</summary>
|
||||
public static string Create() =>
|
||||
Base64UrlEncode(RandomNumberGenerator.GetBytes(Bytes));
|
||||
|
||||
/// <summary>Der Fingerabdruck, wie er in der Datenbank steht.</summary>
|
||||
public static string Fingerprint(string secret) =>
|
||||
Convert.ToHexStringLower(SHA256.HashData(Encoding.UTF8.GetBytes(secret)));
|
||||
|
||||
private static string Base64UrlEncode(byte[] roh) =>
|
||||
Convert.ToBase64String(roh).TrimEnd('=').Replace('+', '-').Replace('/', '_');
|
||||
}
|
||||
@@ -0,0 +1,13 @@
|
||||
<Project Sdk="Microsoft.NET.Sdk">
|
||||
|
||||
<PropertyGroup>
|
||||
<TargetFramework>net10.0</TargetFramework>
|
||||
<ImplicitUsings>enable</ImplicitUsings>
|
||||
<Nullable>enable</Nullable>
|
||||
</PropertyGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<PackageReference Include="Konscious.Security.Cryptography.Argon2" Version="1.3.1" />
|
||||
</ItemGroup>
|
||||
|
||||
</Project>
|
||||
@@ -0,0 +1,20 @@
|
||||
namespace Halo.Core.Libraries;
|
||||
|
||||
public enum LibraryKind { Movies, Shows }
|
||||
|
||||
/// <summary>Ein Verzeichnis mit Medien, wie der Betreiber es eingerichtet hat.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <b>In der Datenbank und nicht in der Umgebung.</b> Stünden Medienpfade in
|
||||
/// der Compose-Datei, müsste der Container neu starten, um eine Bibliothek
|
||||
/// hinzuzufügen — und ein Fremder, der Halo zum ersten Mal startet, hätte
|
||||
/// keine Datei, in der schon das Richtige steht.
|
||||
/// </remarks>
|
||||
public sealed class Library
|
||||
{
|
||||
public Guid Id { get; init; } = Guid.CreateVersion7();
|
||||
public required string Name { get; set; }
|
||||
public required LibraryKind Kind { get; set; }
|
||||
public required string Path { get; set; }
|
||||
public DateTimeOffset CreatedAt { get; init; } = DateTimeOffset.UtcNow;
|
||||
}
|
||||
@@ -0,0 +1,15 @@
|
||||
namespace Halo.Core;
|
||||
|
||||
/// <summary>Eine Einstellung des Servers, als Zeile in der Datenbank.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// Für alles, was der Betreiber in der Oberfläche setzt und was einen
|
||||
/// Neustart überleben muss — den TMDB-Schlüssel zum Beispiel. Was dagegen
|
||||
/// den Betrieb des Containers betrifft (Pfade, Port, Zeitzone), kommt aus der
|
||||
/// Umgebung und steht nicht hier.
|
||||
/// </remarks>
|
||||
public sealed class ServerSetting
|
||||
{
|
||||
public required string Key { get; init; }
|
||||
public required string Value { get; set; }
|
||||
}
|
||||
@@ -0,0 +1,116 @@
|
||||
using System.Security.Cryptography;
|
||||
using System.Text;
|
||||
using Konscious.Security.Cryptography;
|
||||
|
||||
namespace Halo.Core.Users;
|
||||
|
||||
/// <summary>Passwörter als Argon2id, im PHC-Format abgelegt.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
/// Argon2id ist speicherhart: ein Angreifer mit Grafikkarten gewinnt dadurch
|
||||
/// viel weniger, als er es bei PBKDF2 täte. Die Kennwerte folgen der
|
||||
/// OWASP-Empfehlung — 19 MiB, zwei Durchgänge, eine Spur.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// <b>Die Kennwerte stehen im Hash selbst</b>, nicht nur hier als Konstante.
|
||||
/// Werden sie später angehoben, lassen sich alte Passwörter weiterhin prüfen,
|
||||
/// statt alle Konten auf einen Schlag auszusperren. Genau daran scheitern
|
||||
/// solche Umstellungen sonst.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public static class PasswordHasher
|
||||
{
|
||||
private const int MemoryKiB = 19 * 1024;
|
||||
private const int Iterations = 2;
|
||||
private const int Parallelism = 1;
|
||||
private const int SaltBytes = 16;
|
||||
private const int HashBytes = 32;
|
||||
|
||||
public static string Hash(string password)
|
||||
{
|
||||
ArgumentException.ThrowIfNullOrEmpty(password);
|
||||
|
||||
var salt = RandomNumberGenerator.GetBytes(SaltBytes);
|
||||
var hash = Derive(password, salt, MemoryKiB, Iterations, Parallelism, HashBytes);
|
||||
|
||||
return $"$argon2id$v=19$m={MemoryKiB},t={Iterations},p={Parallelism}$" +
|
||||
$"{Convert.ToBase64String(salt).TrimEnd('=')}$" +
|
||||
$"{Convert.ToBase64String(hash).TrimEnd('=')}";
|
||||
}
|
||||
|
||||
/// <summary>Prüft ein Passwort gegen einen abgelegten Hash.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// Gibt bei unlesbarem Hash <c>false</c> zurück statt zu werfen: eine
|
||||
/// beschädigte Zeile in der Datenbank soll die Anmeldung ablehnen, nicht
|
||||
/// den Server umwerfen.
|
||||
/// </remarks>
|
||||
public static bool Verify(string password, string stored)
|
||||
{
|
||||
if (string.IsNullOrEmpty(password) || string.IsNullOrEmpty(stored)) return false;
|
||||
|
||||
var teile = stored.Split('$', StringSplitOptions.RemoveEmptyEntries);
|
||||
if (teile.Length != 5 || teile[0] != "argon2id") return false;
|
||||
|
||||
var kennwerte = teile[2].Split(',');
|
||||
if (kennwerte.Length != 3) return false;
|
||||
if (!TryLesen(kennwerte[0], "m=", out var speicher) ||
|
||||
!TryLesen(kennwerte[1], "t=", out var durchgänge) ||
|
||||
!TryLesen(kennwerte[2], "p=", out var spuren)) return false;
|
||||
|
||||
byte[] salt, erwartet;
|
||||
try
|
||||
{
|
||||
salt = Convert.FromBase64String(Auffüllen(teile[3]));
|
||||
erwartet = Convert.FromBase64String(Auffüllen(teile[4]));
|
||||
}
|
||||
catch (FormatException) { return false; }
|
||||
|
||||
if (erwartet.Length == 0) return false;
|
||||
|
||||
var gerechnet = Derive(password, salt, speicher, durchgänge, spuren, erwartet.Length);
|
||||
return CryptographicOperations.FixedTimeEquals(gerechnet, erwartet);
|
||||
}
|
||||
|
||||
/// <summary>Ob dieser Hash mit schwächeren Kennwerten entstand.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// Damit lässt sich beim nächsten erfolgreichen Anmelden still neu hashen.
|
||||
/// Ohne diese Frage bliebe ein Konto von 2026 für immer bei den Kennwerten
|
||||
/// von 2026, auch wenn die längst zu schwach wären.
|
||||
/// </remarks>
|
||||
public static bool NeedsRehash(string stored)
|
||||
{
|
||||
var teile = stored.Split('$', StringSplitOptions.RemoveEmptyEntries);
|
||||
if (teile.Length != 5 || teile[0] != "argon2id") return true;
|
||||
|
||||
var kennwerte = teile[2].Split(',');
|
||||
if (kennwerte.Length != 3) return true;
|
||||
return !TryLesen(kennwerte[0], "m=", out var speicher) || speicher < MemoryKiB
|
||||
|| !TryLesen(kennwerte[1], "t=", out var durchgänge) || durchgänge < Iterations;
|
||||
}
|
||||
|
||||
private static byte[] Derive(string password, byte[] salt, int speicher, int durchgänge, int spuren, int länge)
|
||||
{
|
||||
using var argon = new Argon2id(Encoding.UTF8.GetBytes(password))
|
||||
{
|
||||
Salt = salt,
|
||||
MemorySize = speicher,
|
||||
Iterations = durchgänge,
|
||||
DegreeOfParallelism = spuren,
|
||||
};
|
||||
return argon.GetBytes(länge);
|
||||
}
|
||||
|
||||
private static bool TryLesen(string stück, string vorsatz, out int wert)
|
||||
{
|
||||
wert = 0;
|
||||
return stück.StartsWith(vorsatz, StringComparison.Ordinal)
|
||||
&& int.TryParse(stück.AsSpan(vorsatz.Length), out wert)
|
||||
&& wert > 0;
|
||||
}
|
||||
|
||||
/// <summary>PHC lässt die Base64-Auffüllung weg; .NET besteht darauf.</summary>
|
||||
private static string Auffüllen(string roh) => roh.PadRight((roh.Length + 3) / 4 * 4, '=');
|
||||
}
|
||||
@@ -0,0 +1,23 @@
|
||||
namespace Halo.Core.Users;
|
||||
|
||||
/// <summary>Ein Benutzerkonto.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// Mehrbenutzer von Anfang an — auch wenn der erste Server nur einen hat.
|
||||
/// Fortschritt und Gesehen-Status je Benutzer nachträglich einzuziehen wäre
|
||||
/// ein Umbau am Datenmodell und an jeder Abfrage darauf, kein Zusatz.
|
||||
/// </remarks>
|
||||
public sealed class User
|
||||
{
|
||||
/// <summary>Zeitlich geordnet, damit der Index nicht zerfasert.</summary>
|
||||
public Guid Id { get; init; } = Guid.CreateVersion7();
|
||||
|
||||
public required string UserName { get; set; }
|
||||
|
||||
/// <summary>Im PHC-Format, siehe <see cref="PasswordHasher"/>.</summary>
|
||||
public required string PasswordHash { get; set; }
|
||||
|
||||
public bool IsAdministrator { get; set; }
|
||||
|
||||
public DateTimeOffset CreatedAt { get; init; } = DateTimeOffset.UtcNow;
|
||||
}
|
||||
@@ -0,0 +1,30 @@
|
||||
using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
|
||||
|
||||
namespace Halo.Data;
|
||||
|
||||
/// <summary>Zeitpunkte als Unix-Millisekunden statt als Text.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
/// <b>Weil SQLite keinen Zeittyp hat.</b> EF Core legt einen
|
||||
/// <c>DateTimeOffset</c> sonst als Text ab — mitsamt Zeitzonenversatz. Dann
|
||||
/// steht <c>…T12:00+02:00</c> neben <c>…T11:00Z</c>, und das ist derselbe
|
||||
/// Augenblick, sortiert sich als Text aber falsch herum. EF weiss das und
|
||||
/// weigert sich deshalb, einen Vergleich wie <c>ExpiresAt > jetzt</c>
|
||||
/// überhaupt zu übersetzen.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// Millisekunden seit 1970 sind ein absoluter Wert: ihre Ordnung stimmt immer,
|
||||
/// unabhängig davon, in welcher Zeitzone jemand sitzt. Der Preis ist, dass in
|
||||
/// der Datenbank Zahlen stehen statt lesbarer Zeiten — für Ablaufprüfungen,
|
||||
/// die hier zählen, ist das der richtige Tausch.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public sealed class DateTimeOffsetToUnixMilliseconds() : ValueConverter<DateTimeOffset, long>(
|
||||
zeitpunkt => zeitpunkt.ToUnixTimeMilliseconds(),
|
||||
zahl => DateTimeOffset.FromUnixTimeMilliseconds(zahl));
|
||||
|
||||
/// <inheritdoc cref="DateTimeOffsetToUnixMilliseconds"/>
|
||||
public sealed class NullableDateTimeOffsetToUnixMilliseconds() : ValueConverter<DateTimeOffset?, long?>(
|
||||
zeitpunkt => zeitpunkt == null ? null : zeitpunkt.Value.ToUnixTimeMilliseconds(),
|
||||
zahl => zahl == null ? null : DateTimeOffset.FromUnixTimeMilliseconds(zahl.Value));
|
||||
@@ -0,0 +1,21 @@
|
||||
<Project Sdk="Microsoft.NET.Sdk">
|
||||
|
||||
<ItemGroup>
|
||||
<ProjectReference Include="..\Halo.Core\Halo.Core.csproj" />
|
||||
</ItemGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.12">
|
||||
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
|
||||
<PrivateAssets>all</PrivateAssets>
|
||||
</PackageReference>
|
||||
<PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.12" />
|
||||
</ItemGroup>
|
||||
|
||||
<PropertyGroup>
|
||||
<TargetFramework>net10.0</TargetFramework>
|
||||
<ImplicitUsings>enable</ImplicitUsings>
|
||||
<Nullable>enable</Nullable>
|
||||
</PropertyGroup>
|
||||
|
||||
</Project>
|
||||
@@ -0,0 +1,94 @@
|
||||
using Halo.Core;
|
||||
using Halo.Core.Auth;
|
||||
using Halo.Core.Libraries;
|
||||
using Halo.Core.Users;
|
||||
using Microsoft.EntityFrameworkCore;
|
||||
|
||||
namespace Halo.Data;
|
||||
|
||||
/// <summary>Die Datenbank des Servers.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <b>SQLite, eine Datei neben der Konfiguration.</b> Kein zweiter Container,
|
||||
/// kein Passwort, Sicherung ist Kopieren — bei selbstgehosteter Software ist
|
||||
/// jede zusätzliche Einrichtungshürde eine messbare Abbruchquote.
|
||||
///
|
||||
/// Der Preis steht im Entwurfsdokument: Schreibzugriffe laufen nacheinander.
|
||||
/// Bei einem Haushalt ist das belanglos, bei 40 000 Titeln und laufendem Scan
|
||||
/// nicht — dann ist der Umstieg auf PostgreSQL fällig, und deshalb steht hier
|
||||
/// nirgends SQLite-eigenes SQL.
|
||||
/// </remarks>
|
||||
public sealed class HaloContext(DbContextOptions<HaloContext> options) : DbContext(options)
|
||||
{
|
||||
public DbSet<User> Users => Set<User>();
|
||||
public DbSet<DeviceToken> DeviceTokens => Set<DeviceToken>();
|
||||
public DbSet<AuthCode> AuthCodes => Set<AuthCode>();
|
||||
public DbSet<Library> Libraries => Set<Library>();
|
||||
public DbSet<ServerSetting> Settings => Set<ServerSetting>();
|
||||
|
||||
/// <summary>Gilt für jede Zeitangabe im Modell, ohne sie einzeln zu nennen.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// Hier und nicht je Eigenschaft: eine vergessene Eigenschaft wäre eine,
|
||||
/// deren Vergleich zur Laufzeit scheitert — und zwar erst dann, wenn sie
|
||||
/// zum ersten Mal in einer Abfrage auftaucht.
|
||||
/// </remarks>
|
||||
protected override void ConfigureConventions(ModelConfigurationBuilder builder)
|
||||
{
|
||||
builder.Properties<DateTimeOffset>().HaveConversion<DateTimeOffsetToUnixMilliseconds>();
|
||||
builder.Properties<DateTimeOffset?>().HaveConversion<NullableDateTimeOffsetToUnixMilliseconds>();
|
||||
}
|
||||
|
||||
protected override void OnModelCreating(ModelBuilder b)
|
||||
{
|
||||
b.Entity<User>(e =>
|
||||
{
|
||||
e.HasKey(x => x.Id);
|
||||
// Zwei Konten „Guido" und „guido" wären eine Falle, keine Funktion.
|
||||
e.HasIndex(x => x.UserName).IsUnique();
|
||||
e.Property(x => x.UserName).HasMaxLength(64).UseCollation("NOCASE");
|
||||
e.Property(x => x.PasswordHash).HasMaxLength(256);
|
||||
});
|
||||
|
||||
b.Entity<DeviceToken>(e =>
|
||||
{
|
||||
e.HasKey(x => x.Id);
|
||||
// Der Weg, den jede einzelne Anfrage geht — ohne Index wäre er ein
|
||||
// vollständiger Tabellendurchlauf je Aufruf.
|
||||
e.HasIndex(x => x.TokenFingerprint).IsUnique();
|
||||
e.HasIndex(x => x.UserId);
|
||||
e.Property(x => x.TokenFingerprint).HasMaxLength(64);
|
||||
e.Property(x => x.DeviceName).HasMaxLength(128);
|
||||
e.Property(x => x.DeviceId).HasMaxLength(128);
|
||||
e.HasOne<User>().WithMany().HasForeignKey(x => x.UserId).OnDelete(DeleteBehavior.Cascade);
|
||||
});
|
||||
|
||||
b.Entity<AuthCode>(e =>
|
||||
{
|
||||
e.HasKey(x => x.Id);
|
||||
e.HasIndex(x => x.Code);
|
||||
e.HasIndex(x => x.HandleFingerprint).IsUnique();
|
||||
e.Property(x => x.Code).HasMaxLength(16);
|
||||
e.Property(x => x.HandleFingerprint).HasMaxLength(64);
|
||||
e.Property(x => x.DeviceName).HasMaxLength(128);
|
||||
e.Property(x => x.DeviceId).HasMaxLength(128);
|
||||
});
|
||||
|
||||
b.Entity<Library>(e =>
|
||||
{
|
||||
e.HasKey(x => x.Id);
|
||||
e.Property(x => x.Name).HasMaxLength(128);
|
||||
e.Property(x => x.Path).HasMaxLength(1024);
|
||||
// Als Text und nicht als Zahl: wer in die Datenbank sieht, soll
|
||||
// „Movies" lesen und nicht „0" deuten müssen.
|
||||
e.Property(x => x.Kind).HasConversion<string>().HasMaxLength(32);
|
||||
});
|
||||
|
||||
b.Entity<ServerSetting>(e =>
|
||||
{
|
||||
e.HasKey(x => x.Key);
|
||||
e.Property(x => x.Key).HasMaxLength(128);
|
||||
e.Property(x => x.Value).HasMaxLength(4096);
|
||||
});
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,201 @@
|
||||
// <auto-generated />
|
||||
using System;
|
||||
using Halo.Data;
|
||||
using Microsoft.EntityFrameworkCore;
|
||||
using Microsoft.EntityFrameworkCore.Infrastructure;
|
||||
using Microsoft.EntityFrameworkCore.Migrations;
|
||||
using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
|
||||
|
||||
#nullable disable
|
||||
|
||||
namespace Halo.Data.Migrations
|
||||
{
|
||||
[DbContext(typeof(HaloContext))]
|
||||
[Migration("20261003095500_Initial")]
|
||||
partial class Initial
|
||||
{
|
||||
/// <inheritdoc />
|
||||
protected override void BuildTargetModel(ModelBuilder modelBuilder)
|
||||
{
|
||||
#pragma warning disable 612, 618
|
||||
modelBuilder.HasAnnotation("ProductVersion", "10.0.12");
|
||||
|
||||
modelBuilder.Entity("Halo.Core.Auth.AuthCode", b =>
|
||||
{
|
||||
b.Property<Guid>("Id")
|
||||
.ValueGeneratedOnAdd()
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<Guid?>("ApprovedByUserId")
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<string>("Code")
|
||||
.IsRequired()
|
||||
.HasMaxLength(16)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<long?>("ConsumedAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<long>("CreatedAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<string>("DeviceId")
|
||||
.IsRequired()
|
||||
.HasMaxLength(128)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<string>("DeviceName")
|
||||
.IsRequired()
|
||||
.HasMaxLength(128)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<long>("ExpiresAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<string>("HandleFingerprint")
|
||||
.IsRequired()
|
||||
.HasMaxLength(64)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.HasKey("Id");
|
||||
|
||||
b.HasIndex("Code");
|
||||
|
||||
b.HasIndex("HandleFingerprint")
|
||||
.IsUnique();
|
||||
|
||||
b.ToTable("AuthCodes");
|
||||
});
|
||||
|
||||
modelBuilder.Entity("Halo.Core.Auth.DeviceToken", b =>
|
||||
{
|
||||
b.Property<Guid>("Id")
|
||||
.ValueGeneratedOnAdd()
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<long>("CreatedAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<string>("DeviceId")
|
||||
.IsRequired()
|
||||
.HasMaxLength(128)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<string>("DeviceName")
|
||||
.IsRequired()
|
||||
.HasMaxLength(128)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<long>("LastSeenAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<long?>("RevokedAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<string>("TokenFingerprint")
|
||||
.IsRequired()
|
||||
.HasMaxLength(64)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<Guid>("UserId")
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.HasKey("Id");
|
||||
|
||||
b.HasIndex("TokenFingerprint")
|
||||
.IsUnique();
|
||||
|
||||
b.HasIndex("UserId");
|
||||
|
||||
b.ToTable("DeviceTokens");
|
||||
});
|
||||
|
||||
modelBuilder.Entity("Halo.Core.Libraries.Library", b =>
|
||||
{
|
||||
b.Property<Guid>("Id")
|
||||
.ValueGeneratedOnAdd()
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<long>("CreatedAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<string>("Kind")
|
||||
.IsRequired()
|
||||
.HasMaxLength(32)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<string>("Name")
|
||||
.IsRequired()
|
||||
.HasMaxLength(128)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<string>("Path")
|
||||
.IsRequired()
|
||||
.HasMaxLength(1024)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.HasKey("Id");
|
||||
|
||||
b.ToTable("Libraries");
|
||||
});
|
||||
|
||||
modelBuilder.Entity("Halo.Core.ServerSetting", b =>
|
||||
{
|
||||
b.Property<string>("Key")
|
||||
.HasMaxLength(128)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<string>("Value")
|
||||
.IsRequired()
|
||||
.HasMaxLength(4096)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.HasKey("Key");
|
||||
|
||||
b.ToTable("Settings");
|
||||
});
|
||||
|
||||
modelBuilder.Entity("Halo.Core.Users.User", b =>
|
||||
{
|
||||
b.Property<Guid>("Id")
|
||||
.ValueGeneratedOnAdd()
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<long>("CreatedAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<bool>("IsAdministrator")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<string>("PasswordHash")
|
||||
.IsRequired()
|
||||
.HasMaxLength(256)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<string>("UserName")
|
||||
.IsRequired()
|
||||
.HasMaxLength(64)
|
||||
.HasColumnType("TEXT")
|
||||
.UseCollation("NOCASE");
|
||||
|
||||
b.HasKey("Id");
|
||||
|
||||
b.HasIndex("UserName")
|
||||
.IsUnique();
|
||||
|
||||
b.ToTable("Users");
|
||||
});
|
||||
|
||||
modelBuilder.Entity("Halo.Core.Auth.DeviceToken", b =>
|
||||
{
|
||||
b.HasOne("Halo.Core.Users.User", null)
|
||||
.WithMany()
|
||||
.HasForeignKey("UserId")
|
||||
.OnDelete(DeleteBehavior.Cascade)
|
||||
.IsRequired();
|
||||
});
|
||||
#pragma warning restore 612, 618
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,147 @@
|
||||
using System;
|
||||
using Microsoft.EntityFrameworkCore.Migrations;
|
||||
|
||||
#nullable disable
|
||||
|
||||
namespace Halo.Data.Migrations
|
||||
{
|
||||
/// <inheritdoc />
|
||||
public partial class Initial : Migration
|
||||
{
|
||||
/// <inheritdoc />
|
||||
protected override void Up(MigrationBuilder migrationBuilder)
|
||||
{
|
||||
migrationBuilder.CreateTable(
|
||||
name: "AuthCodes",
|
||||
columns: table => new
|
||||
{
|
||||
Id = table.Column<Guid>(type: "TEXT", nullable: false),
|
||||
Code = table.Column<string>(type: "TEXT", maxLength: 16, nullable: false),
|
||||
HandleFingerprint = table.Column<string>(type: "TEXT", maxLength: 64, nullable: false),
|
||||
DeviceName = table.Column<string>(type: "TEXT", maxLength: 128, nullable: false),
|
||||
DeviceId = table.Column<string>(type: "TEXT", maxLength: 128, nullable: false),
|
||||
CreatedAt = table.Column<long>(type: "INTEGER", nullable: false),
|
||||
ExpiresAt = table.Column<long>(type: "INTEGER", nullable: false),
|
||||
ApprovedByUserId = table.Column<Guid>(type: "TEXT", nullable: true),
|
||||
ConsumedAt = table.Column<long>(type: "INTEGER", nullable: true)
|
||||
},
|
||||
constraints: table =>
|
||||
{
|
||||
table.PrimaryKey("PK_AuthCodes", x => x.Id);
|
||||
});
|
||||
|
||||
migrationBuilder.CreateTable(
|
||||
name: "Libraries",
|
||||
columns: table => new
|
||||
{
|
||||
Id = table.Column<Guid>(type: "TEXT", nullable: false),
|
||||
Name = table.Column<string>(type: "TEXT", maxLength: 128, nullable: false),
|
||||
Kind = table.Column<string>(type: "TEXT", maxLength: 32, nullable: false),
|
||||
Path = table.Column<string>(type: "TEXT", maxLength: 1024, nullable: false),
|
||||
CreatedAt = table.Column<long>(type: "INTEGER", nullable: false)
|
||||
},
|
||||
constraints: table =>
|
||||
{
|
||||
table.PrimaryKey("PK_Libraries", x => x.Id);
|
||||
});
|
||||
|
||||
migrationBuilder.CreateTable(
|
||||
name: "Settings",
|
||||
columns: table => new
|
||||
{
|
||||
Key = table.Column<string>(type: "TEXT", maxLength: 128, nullable: false),
|
||||
Value = table.Column<string>(type: "TEXT", maxLength: 4096, nullable: false)
|
||||
},
|
||||
constraints: table =>
|
||||
{
|
||||
table.PrimaryKey("PK_Settings", x => x.Key);
|
||||
});
|
||||
|
||||
migrationBuilder.CreateTable(
|
||||
name: "Users",
|
||||
columns: table => new
|
||||
{
|
||||
Id = table.Column<Guid>(type: "TEXT", nullable: false),
|
||||
UserName = table.Column<string>(type: "TEXT", maxLength: 64, nullable: false, collation: "NOCASE"),
|
||||
PasswordHash = table.Column<string>(type: "TEXT", maxLength: 256, nullable: false),
|
||||
IsAdministrator = table.Column<bool>(type: "INTEGER", nullable: false),
|
||||
CreatedAt = table.Column<long>(type: "INTEGER", nullable: false)
|
||||
},
|
||||
constraints: table =>
|
||||
{
|
||||
table.PrimaryKey("PK_Users", x => x.Id);
|
||||
});
|
||||
|
||||
migrationBuilder.CreateTable(
|
||||
name: "DeviceTokens",
|
||||
columns: table => new
|
||||
{
|
||||
Id = table.Column<Guid>(type: "TEXT", nullable: false),
|
||||
UserId = table.Column<Guid>(type: "TEXT", nullable: false),
|
||||
TokenFingerprint = table.Column<string>(type: "TEXT", maxLength: 64, nullable: false),
|
||||
DeviceName = table.Column<string>(type: "TEXT", maxLength: 128, nullable: false),
|
||||
DeviceId = table.Column<string>(type: "TEXT", maxLength: 128, nullable: false),
|
||||
CreatedAt = table.Column<long>(type: "INTEGER", nullable: false),
|
||||
LastSeenAt = table.Column<long>(type: "INTEGER", nullable: false),
|
||||
RevokedAt = table.Column<long>(type: "INTEGER", nullable: true)
|
||||
},
|
||||
constraints: table =>
|
||||
{
|
||||
table.PrimaryKey("PK_DeviceTokens", x => x.Id);
|
||||
table.ForeignKey(
|
||||
name: "FK_DeviceTokens_Users_UserId",
|
||||
column: x => x.UserId,
|
||||
principalTable: "Users",
|
||||
principalColumn: "Id",
|
||||
onDelete: ReferentialAction.Cascade);
|
||||
});
|
||||
|
||||
migrationBuilder.CreateIndex(
|
||||
name: "IX_AuthCodes_Code",
|
||||
table: "AuthCodes",
|
||||
column: "Code");
|
||||
|
||||
migrationBuilder.CreateIndex(
|
||||
name: "IX_AuthCodes_HandleFingerprint",
|
||||
table: "AuthCodes",
|
||||
column: "HandleFingerprint",
|
||||
unique: true);
|
||||
|
||||
migrationBuilder.CreateIndex(
|
||||
name: "IX_DeviceTokens_TokenFingerprint",
|
||||
table: "DeviceTokens",
|
||||
column: "TokenFingerprint",
|
||||
unique: true);
|
||||
|
||||
migrationBuilder.CreateIndex(
|
||||
name: "IX_DeviceTokens_UserId",
|
||||
table: "DeviceTokens",
|
||||
column: "UserId");
|
||||
|
||||
migrationBuilder.CreateIndex(
|
||||
name: "IX_Users_UserName",
|
||||
table: "Users",
|
||||
column: "UserName",
|
||||
unique: true);
|
||||
}
|
||||
|
||||
/// <inheritdoc />
|
||||
protected override void Down(MigrationBuilder migrationBuilder)
|
||||
{
|
||||
migrationBuilder.DropTable(
|
||||
name: "AuthCodes");
|
||||
|
||||
migrationBuilder.DropTable(
|
||||
name: "DeviceTokens");
|
||||
|
||||
migrationBuilder.DropTable(
|
||||
name: "Libraries");
|
||||
|
||||
migrationBuilder.DropTable(
|
||||
name: "Settings");
|
||||
|
||||
migrationBuilder.DropTable(
|
||||
name: "Users");
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,198 @@
|
||||
// <auto-generated />
|
||||
using System;
|
||||
using Halo.Data;
|
||||
using Microsoft.EntityFrameworkCore;
|
||||
using Microsoft.EntityFrameworkCore.Infrastructure;
|
||||
using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
|
||||
|
||||
#nullable disable
|
||||
|
||||
namespace Halo.Data.Migrations
|
||||
{
|
||||
[DbContext(typeof(HaloContext))]
|
||||
partial class HaloContextModelSnapshot : ModelSnapshot
|
||||
{
|
||||
protected override void BuildModel(ModelBuilder modelBuilder)
|
||||
{
|
||||
#pragma warning disable 612, 618
|
||||
modelBuilder.HasAnnotation("ProductVersion", "10.0.12");
|
||||
|
||||
modelBuilder.Entity("Halo.Core.Auth.AuthCode", b =>
|
||||
{
|
||||
b.Property<Guid>("Id")
|
||||
.ValueGeneratedOnAdd()
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<Guid?>("ApprovedByUserId")
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<string>("Code")
|
||||
.IsRequired()
|
||||
.HasMaxLength(16)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<long?>("ConsumedAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<long>("CreatedAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<string>("DeviceId")
|
||||
.IsRequired()
|
||||
.HasMaxLength(128)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<string>("DeviceName")
|
||||
.IsRequired()
|
||||
.HasMaxLength(128)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<long>("ExpiresAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<string>("HandleFingerprint")
|
||||
.IsRequired()
|
||||
.HasMaxLength(64)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.HasKey("Id");
|
||||
|
||||
b.HasIndex("Code");
|
||||
|
||||
b.HasIndex("HandleFingerprint")
|
||||
.IsUnique();
|
||||
|
||||
b.ToTable("AuthCodes");
|
||||
});
|
||||
|
||||
modelBuilder.Entity("Halo.Core.Auth.DeviceToken", b =>
|
||||
{
|
||||
b.Property<Guid>("Id")
|
||||
.ValueGeneratedOnAdd()
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<long>("CreatedAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<string>("DeviceId")
|
||||
.IsRequired()
|
||||
.HasMaxLength(128)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<string>("DeviceName")
|
||||
.IsRequired()
|
||||
.HasMaxLength(128)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<long>("LastSeenAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<long?>("RevokedAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<string>("TokenFingerprint")
|
||||
.IsRequired()
|
||||
.HasMaxLength(64)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<Guid>("UserId")
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.HasKey("Id");
|
||||
|
||||
b.HasIndex("TokenFingerprint")
|
||||
.IsUnique();
|
||||
|
||||
b.HasIndex("UserId");
|
||||
|
||||
b.ToTable("DeviceTokens");
|
||||
});
|
||||
|
||||
modelBuilder.Entity("Halo.Core.Libraries.Library", b =>
|
||||
{
|
||||
b.Property<Guid>("Id")
|
||||
.ValueGeneratedOnAdd()
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<long>("CreatedAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<string>("Kind")
|
||||
.IsRequired()
|
||||
.HasMaxLength(32)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<string>("Name")
|
||||
.IsRequired()
|
||||
.HasMaxLength(128)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<string>("Path")
|
||||
.IsRequired()
|
||||
.HasMaxLength(1024)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.HasKey("Id");
|
||||
|
||||
b.ToTable("Libraries");
|
||||
});
|
||||
|
||||
modelBuilder.Entity("Halo.Core.ServerSetting", b =>
|
||||
{
|
||||
b.Property<string>("Key")
|
||||
.HasMaxLength(128)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<string>("Value")
|
||||
.IsRequired()
|
||||
.HasMaxLength(4096)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.HasKey("Key");
|
||||
|
||||
b.ToTable("Settings");
|
||||
});
|
||||
|
||||
modelBuilder.Entity("Halo.Core.Users.User", b =>
|
||||
{
|
||||
b.Property<Guid>("Id")
|
||||
.ValueGeneratedOnAdd()
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<long>("CreatedAt")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<bool>("IsAdministrator")
|
||||
.HasColumnType("INTEGER");
|
||||
|
||||
b.Property<string>("PasswordHash")
|
||||
.IsRequired()
|
||||
.HasMaxLength(256)
|
||||
.HasColumnType("TEXT");
|
||||
|
||||
b.Property<string>("UserName")
|
||||
.IsRequired()
|
||||
.HasMaxLength(64)
|
||||
.HasColumnType("TEXT")
|
||||
.UseCollation("NOCASE");
|
||||
|
||||
b.HasKey("Id");
|
||||
|
||||
b.HasIndex("UserName")
|
||||
.IsUnique();
|
||||
|
||||
b.ToTable("Users");
|
||||
});
|
||||
|
||||
modelBuilder.Entity("Halo.Core.Auth.DeviceToken", b =>
|
||||
{
|
||||
b.HasOne("Halo.Core.Users.User", null)
|
||||
.WithMany()
|
||||
.HasForeignKey("UserId")
|
||||
.OnDelete(DeleteBehavior.Cascade)
|
||||
.IsRequired();
|
||||
});
|
||||
#pragma warning restore 612, 618
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,137 @@
|
||||
using System.Net;
|
||||
using System.Net.Http.Json;
|
||||
using Halo.Api.Endpoints;
|
||||
|
||||
namespace Halo.Api.Tests;
|
||||
|
||||
/// <summary>Anmelden am Fernseher, ohne ein Passwort zu tippen.</summary>
|
||||
public class CodeSignInTests
|
||||
{
|
||||
private static Task<HttpResponseMessage> CodeAnfordern(HaloServer server) =>
|
||||
server.Client.PostAsJsonAsync("/api/v1/auth/code", new CodeRequest("Wohnzimmer", "tv-1"));
|
||||
|
||||
[Test]
|
||||
public async Task Der_ganze_Weg_vom_Bildschirm_zum_Token()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var telefon = await server.SetUpAndSignIn();
|
||||
|
||||
// 1. Der Fernseher fordert an und zeigt den Code.
|
||||
var angefordert = await (await CodeAnfordern(server)).Content.ReadFromJsonAsync<CodeResponse>();
|
||||
Assert.That(angefordert!.Code, Does.Match("^[0-9]{6}$"));
|
||||
|
||||
// 2. Noch hat niemand bestätigt.
|
||||
var wartend = await server.Client.GetFromJsonAsync<CodeState>($"/api/v1/auth/code/{angefordert.Handle}");
|
||||
Assert.That(wartend!.State, Is.EqualTo("pending"));
|
||||
Assert.That(wartend.Login, Is.Null);
|
||||
|
||||
// 3. Am Telefon bestätigen.
|
||||
var bestätigt = await server.AlsAngemeldeter(telefon.Token)
|
||||
.PostAsync($"/api/v1/auth/code/{angefordert.Code}", null);
|
||||
bestätigt.EnsureSuccessStatusCode();
|
||||
|
||||
// 4. Der Fernseher holt sein Token ab.
|
||||
var fertig = await server.Client.GetFromJsonAsync<CodeState>($"/api/v1/auth/code/{angefordert.Handle}");
|
||||
Assert.That(fertig!.State, Is.EqualTo("approved"));
|
||||
Assert.That(fertig.Login!.Token, Is.Not.Empty);
|
||||
|
||||
// Und es gilt auch wirklich.
|
||||
var ich = await server.AlsAngemeldeter(fertig.Login.Token)
|
||||
.GetFromJsonAsync<AuthenticatedUser>("/api/v1/auth/me");
|
||||
Assert.That(ich!.UserName, Is.EqualTo("guido"));
|
||||
}
|
||||
|
||||
/// <summary>Der Code allein darf niemals ein Token herausgeben.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <b>Die wichtigste Prüfung dieser Datei.</b> Gäbe der Server auf einen
|
||||
/// erratenen Abholschein hin Token heraus, wären sechsstellige Codes ein
|
||||
/// Türschloss mit einer Million Schlüsseln — in Minuten durchprobiert, und
|
||||
/// am Ende stünde ein fremdes Gerät in der Mediathek.
|
||||
/// </remarks>
|
||||
[Test]
|
||||
public async Task Ein_fremder_Abholschein_bekommt_nichts()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var telefon = await server.SetUpAndSignIn();
|
||||
|
||||
var echt = await (await CodeAnfordern(server)).Content.ReadFromJsonAsync<CodeResponse>();
|
||||
await server.AlsAngemeldeter(telefon.Token).PostAsync($"/api/v1/auth/code/{echt!.Code}", null);
|
||||
|
||||
// Der Code ist bestätigt — aber der Abholschein stimmt nicht.
|
||||
var erraten = await server.Client.GetFromJsonAsync<CodeState>("/api/v1/auth/code/ausgedacht");
|
||||
|
||||
Assert.That(erraten!.State, Is.EqualTo("expired"));
|
||||
Assert.That(erraten.Login, Is.Null);
|
||||
}
|
||||
|
||||
/// <summary>Auch der Code selbst taugt nicht als Abholschein.</summary>
|
||||
[Test]
|
||||
public async Task Der_Code_ist_kein_Abholschein()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var telefon = await server.SetUpAndSignIn();
|
||||
|
||||
var echt = await (await CodeAnfordern(server)).Content.ReadFromJsonAsync<CodeResponse>();
|
||||
await server.AlsAngemeldeter(telefon.Token).PostAsync($"/api/v1/auth/code/{echt!.Code}", null);
|
||||
|
||||
var mitCode = await server.Client.GetFromJsonAsync<CodeState>($"/api/v1/auth/code/{echt.Code}");
|
||||
Assert.That(mitCode!.Login, Is.Null);
|
||||
}
|
||||
|
||||
[Test]
|
||||
public async Task Ein_abgeholtes_Token_gibt_es_kein_zweites_Mal()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var telefon = await server.SetUpAndSignIn();
|
||||
|
||||
var angefordert = await (await CodeAnfordern(server)).Content.ReadFromJsonAsync<CodeResponse>();
|
||||
await server.AlsAngemeldeter(telefon.Token).PostAsync($"/api/v1/auth/code/{angefordert!.Code}", null);
|
||||
|
||||
var erstesMal = await server.Client.GetFromJsonAsync<CodeState>($"/api/v1/auth/code/{angefordert.Handle}");
|
||||
var zweitesMal = await server.Client.GetFromJsonAsync<CodeState>($"/api/v1/auth/code/{angefordert.Handle}");
|
||||
|
||||
Assert.That(erstesMal!.State, Is.EqualTo("approved"));
|
||||
Assert.That(zweitesMal!.State, Is.EqualTo("expired"));
|
||||
Assert.That(zweitesMal.Login, Is.Null);
|
||||
}
|
||||
|
||||
/// <summary>Bestätigen darf nur, wer angemeldet ist.</summary>
|
||||
[Test]
|
||||
public async Task Ein_Unangemeldeter_kann_nichts_bestaetigen()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
await server.SetUpAndSignIn();
|
||||
var angefordert = await (await CodeAnfordern(server)).Content.ReadFromJsonAsync<CodeResponse>();
|
||||
|
||||
var versuch = await server.Client.PostAsync($"/api/v1/auth/code/{angefordert!.Code}", null);
|
||||
Assert.That(versuch.StatusCode, Is.EqualTo(HttpStatusCode.Unauthorized));
|
||||
|
||||
var danach = await server.Client.GetFromJsonAsync<CodeState>($"/api/v1/auth/code/{angefordert.Handle}");
|
||||
Assert.That(danach!.State, Is.EqualTo("pending"));
|
||||
}
|
||||
|
||||
[Test]
|
||||
public async Task Ein_erfundener_Code_laesst_sich_nicht_bestaetigen()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var telefon = await server.SetUpAndSignIn();
|
||||
|
||||
var versuch = await server.AlsAngemeldeter(telefon.Token).PostAsync("/api/v1/auth/code/000000", null);
|
||||
Assert.That(versuch.StatusCode, Is.EqualTo(HttpStatusCode.NotFound));
|
||||
}
|
||||
|
||||
/// <summary>Am Telefon soll stehen, was man da hereinlässt.</summary>
|
||||
[Test]
|
||||
public async Task Die_Bestaetigung_nennt_das_Geraet()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var telefon = await server.SetUpAndSignIn();
|
||||
var angefordert = await (await CodeAnfordern(server)).Content.ReadFromJsonAsync<CodeResponse>();
|
||||
|
||||
var antwort = await server.AlsAngemeldeter(telefon.Token)
|
||||
.PostAsync($"/api/v1/auth/code/{angefordert!.Code}", null);
|
||||
|
||||
Assert.That(await antwort.Content.ReadAsStringAsync(), Does.Contain("Wohnzimmer"));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,30 @@
|
||||
<Project Sdk="Microsoft.NET.Sdk">
|
||||
|
||||
<PropertyGroup>
|
||||
<TargetFramework>net10.0</TargetFramework>
|
||||
<LangVersion>latest</LangVersion>
|
||||
<ImplicitUsings>enable</ImplicitUsings>
|
||||
<Nullable>enable</Nullable>
|
||||
<IsPackable>false</IsPackable>
|
||||
</PropertyGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<PackageReference Include="coverlet.collector" Version="6.0.4" />
|
||||
<PackageReference Include="Microsoft.AspNetCore.Mvc.Testing" Version="10.0.12" />
|
||||
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.14.0" />
|
||||
<PackageReference Include="NUnit" Version="4.3.2" />
|
||||
<PackageReference Include="NUnit.Analyzers" Version="4.7.0" />
|
||||
<PackageReference Include="NUnit3TestAdapter" Version="5.0.0" />
|
||||
</ItemGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<Using Include="NUnit.Framework" />
|
||||
</ItemGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<ProjectReference Include="..\..\src\Halo.Api\Halo.Api.csproj" />
|
||||
<ProjectReference Include="..\..\src\Halo.Data\Halo.Data.csproj" />
|
||||
<ProjectReference Include="..\..\src\Halo.Core\Halo.Core.csproj" />
|
||||
</ItemGroup>
|
||||
|
||||
</Project>
|
||||
@@ -0,0 +1,96 @@
|
||||
namespace Halo.Api.Tests;
|
||||
|
||||
/// <summary>Was beim allerersten Start passiert, bevor irgendetwas anderes greift.</summary>
|
||||
public class HaloPathsTests
|
||||
{
|
||||
private string _wurzel = "";
|
||||
|
||||
[SetUp]
|
||||
public void Anlegen() =>
|
||||
_wurzel = Directory.CreateDirectory(
|
||||
Path.Combine(Path.GetTempPath(), "halo-pfade-" + Guid.CreateVersion7().ToString("N"))).FullName;
|
||||
|
||||
[TearDown]
|
||||
public void Aufraeumen()
|
||||
{
|
||||
// Zurücksetzen, sonst lässt sich das gesperrte Verzeichnis nicht löschen.
|
||||
foreach (var d in Directory.EnumerateDirectories(_wurzel, "*", SearchOption.AllDirectories))
|
||||
File.SetUnixFileMode(d, UnixFileMode.UserRead | UnixFileMode.UserWrite | UnixFileMode.UserExecute);
|
||||
try { Directory.Delete(_wurzel, recursive: true); } catch (IOException) { }
|
||||
}
|
||||
|
||||
private HaloPaths Pfade(string? daten = null) => new()
|
||||
{
|
||||
Data = daten ?? Path.Combine(_wurzel, "config"),
|
||||
Cache = Path.Combine(_wurzel, "cache"),
|
||||
Transcode = Path.Combine(_wurzel, "transcode"),
|
||||
};
|
||||
|
||||
[Test]
|
||||
public void Fehlende_Verzeichnisse_werden_angelegt()
|
||||
{
|
||||
var pfade = Pfade();
|
||||
pfade.EnsureExists();
|
||||
|
||||
Assert.That(Directory.Exists(pfade.Data), Is.True);
|
||||
Assert.That(Directory.Exists(pfade.Cache), Is.True);
|
||||
Assert.That(Directory.Exists(pfade.Transcode), Is.True);
|
||||
}
|
||||
|
||||
[Test]
|
||||
public void Ein_zweiter_Start_stoert_sich_nicht_am_ersten()
|
||||
{
|
||||
var pfade = Pfade();
|
||||
pfade.EnsureExists();
|
||||
Assert.DoesNotThrow(() => pfade.EnsureExists());
|
||||
}
|
||||
|
||||
/// <summary>Der häufigste Stolperstein beim ersten Containerstart.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <b>Hier wird die Diagnose geprüft, nicht die Funktion.</b> Ein
|
||||
/// vorhandenes, aber gesperrtes Verzeichnis lässt
|
||||
/// <c>Directory.CreateDirectory</c> durchgehen; ohne eigene Schreibprobe
|
||||
/// stirbt der Server erst später an „unable to open database file" — einer
|
||||
/// Meldung, die weder das Verzeichnis nennt noch verrät, dass es um
|
||||
/// Dateirechte geht.
|
||||
/// </remarks>
|
||||
[Test]
|
||||
public void Ein_gesperrtes_Verzeichnis_faellt_beim_Start_auf_und_nennt_den_Grund()
|
||||
{
|
||||
if (OperatingSystem.IsWindows()) Assert.Ignore("Dateirechte verhalten sich dort anders.");
|
||||
|
||||
var gesperrt = Directory.CreateDirectory(Path.Combine(_wurzel, "gesperrt")).FullName;
|
||||
File.SetUnixFileMode(gesperrt, UnixFileMode.UserRead | UnixFileMode.UserExecute);
|
||||
|
||||
var fehler = Assert.Throws<InvalidOperationException>(() => Pfade(daten: gesperrt).EnsureExists());
|
||||
|
||||
Assert.That(fehler!.Message, Does.Contain("HALO_DATA"), "Welche Einstellung gemeint ist");
|
||||
Assert.That(fehler.Message, Does.Contain(gesperrt), "Welches Verzeichnis");
|
||||
Assert.That(fehler.Message, Does.Contain("uid="), "Als wer der Server läuft");
|
||||
Assert.That(fehler.Message, Does.Contain("chown"), "Was zu tun ist");
|
||||
}
|
||||
|
||||
[Test]
|
||||
public void Ohne_Umgebungsvariablen_liegt_alles_neben_dem_Programm()
|
||||
{
|
||||
foreach (var name in new[] { "HALO_DATA", "HALO_CACHE", "HALO_TRANSCODE" })
|
||||
Environment.SetEnvironmentVariable(name, null);
|
||||
|
||||
var pfade = HaloPaths.FromEnvironment(_wurzel);
|
||||
|
||||
Assert.That(pfade.Data, Is.EqualTo(Path.Combine(_wurzel, "data")));
|
||||
Assert.That(pfade.DatabaseFile, Does.EndWith("halo.db"));
|
||||
}
|
||||
|
||||
[Test]
|
||||
public void Die_Umgebung_sticht_die_Voreinstellung()
|
||||
{
|
||||
Environment.SetEnvironmentVariable("HALO_DATA", "/woanders");
|
||||
try
|
||||
{
|
||||
Assert.That(HaloPaths.FromEnvironment(_wurzel).Data, Is.EqualTo("/woanders"));
|
||||
}
|
||||
finally { Environment.SetEnvironmentVariable("HALO_DATA", null); }
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,67 @@
|
||||
using System.Net.Http.Headers;
|
||||
using System.Net.Http.Json;
|
||||
using Halo.Api.Endpoints;
|
||||
using Microsoft.AspNetCore.Mvc.Testing;
|
||||
|
||||
namespace Halo.Api.Tests;
|
||||
|
||||
/// <summary>Ein frisch gestarteter Server mit leerer Datenbank.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// <b>Eine echte SQLite-Datei, kein Ersatz im Arbeitsspeicher.</b> Damit läuft
|
||||
/// auch das durch, worauf es beim ersten Start ankommt: Verzeichnisse anlegen,
|
||||
/// Migration wandern lassen, Einrichtung anbieten. Genau diese Kette sieht ein
|
||||
/// Fremder als Erstes — und genau sie würde ein Ersatzspeicher überspringen.
|
||||
/// </remarks>
|
||||
public sealed class HaloServer : IDisposable
|
||||
{
|
||||
private readonly WebApplicationFactory<Program> _fabrik;
|
||||
private readonly string _verzeichnis;
|
||||
|
||||
public HttpClient Client { get; }
|
||||
|
||||
public HaloServer()
|
||||
{
|
||||
_verzeichnis = Path.Combine(Path.GetTempPath(), "halo-test-" + Guid.CreateVersion7().ToString("N"));
|
||||
Environment.SetEnvironmentVariable("HALO_DATA", Path.Combine(_verzeichnis, "config"));
|
||||
Environment.SetEnvironmentVariable("HALO_CACHE", Path.Combine(_verzeichnis, "cache"));
|
||||
Environment.SetEnvironmentVariable("HALO_TRANSCODE", Path.Combine(_verzeichnis, "transcode"));
|
||||
// Die Zugriffsgrenze zählt je Adresse, und im Test kommt alles von
|
||||
// derselben. Ohne das Hochsetzen prüfte man hier die Grenze statt der
|
||||
// Anmeldung.
|
||||
Environment.SetEnvironmentVariable("HALO_RATELIMIT_SIGNIN", "10000");
|
||||
|
||||
_fabrik = new WebApplicationFactory<Program>();
|
||||
Client = _fabrik.CreateClient();
|
||||
}
|
||||
|
||||
/// <summary>Richtet ein und meldet den Administrator an.</summary>
|
||||
public async Task<LoginResponse> SetUpAndSignIn(string name = "guido", string passwort = "ein-langes-passwort")
|
||||
{
|
||||
var einrichten = await Client.PostAsJsonAsync("/api/v1/system/setup", new SetupRequest(name, passwort));
|
||||
einrichten.EnsureSuccessStatusCode();
|
||||
return await SignIn(name, passwort);
|
||||
}
|
||||
|
||||
public async Task<LoginResponse> SignIn(string name, string passwort, string gerät = "iPhone", string kennung = "geraet-1")
|
||||
{
|
||||
var antwort = await Client.PostAsJsonAsync("/api/v1/auth/login",
|
||||
new LoginRequest(name, passwort, gerät, kennung));
|
||||
antwort.EnsureSuccessStatusCode();
|
||||
return (await antwort.Content.ReadFromJsonAsync<LoginResponse>())!;
|
||||
}
|
||||
|
||||
/// <summary>Ein eigener Client, der ein Token vorzeigt.</summary>
|
||||
public HttpClient AlsAngemeldeter(string token)
|
||||
{
|
||||
var client = _fabrik.CreateClient();
|
||||
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
|
||||
return client;
|
||||
}
|
||||
|
||||
public void Dispose()
|
||||
{
|
||||
_fabrik.Dispose();
|
||||
try { Directory.Delete(_verzeichnis, recursive: true); } catch (IOException) { /* Aufräumen ist Kür */ }
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,100 @@
|
||||
using System.Net;
|
||||
using System.Net.Http.Json;
|
||||
using Halo.Api.Endpoints;
|
||||
|
||||
namespace Halo.Api.Tests;
|
||||
|
||||
public class ManagementTests
|
||||
{
|
||||
[Test]
|
||||
public async Task Ein_Administrator_legt_Benutzer_an()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var admin = await server.SetUpAndSignIn();
|
||||
var client = server.AlsAngemeldeter(admin.Token);
|
||||
|
||||
var angelegt = await client.PostAsJsonAsync("/api/v1/users",
|
||||
new CreateUserRequest("mitbewohner", "auch-ein-langes-passwort", false));
|
||||
Assert.That(angelegt.StatusCode, Is.EqualTo(HttpStatusCode.Created));
|
||||
|
||||
var alle = await client.GetFromJsonAsync<List<AuthenticatedUser>>("/api/v1/users");
|
||||
Assert.That(alle!.Select(u => u.UserName), Is.EquivalentTo(new[] { "guido", "mitbewohner" }));
|
||||
}
|
||||
|
||||
/// <summary>Wer kein Administrator ist, verwaltet auch nichts.</summary>
|
||||
[Test]
|
||||
public async Task Ein_gewoehnlicher_Benutzer_darf_keine_Benutzer_anlegen()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var admin = await server.SetUpAndSignIn();
|
||||
await server.AlsAngemeldeter(admin.Token).PostAsJsonAsync("/api/v1/users",
|
||||
new CreateUserRequest("mitbewohner", "auch-ein-langes-passwort", false));
|
||||
|
||||
var gast = await server.SignIn("mitbewohner", "auch-ein-langes-passwort", "iPad", "geraet-9");
|
||||
var versuch = await server.AlsAngemeldeter(gast.Token).PostAsJsonAsync("/api/v1/users",
|
||||
new CreateUserRequest("noch-einer", "noch-ein-langes-passwort", true));
|
||||
|
||||
Assert.That(versuch.StatusCode, Is.EqualTo(HttpStatusCode.Forbidden));
|
||||
}
|
||||
|
||||
[Test]
|
||||
public async Task Derselbe_Benutzername_zweimal_wird_abgelehnt()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var admin = await server.SetUpAndSignIn();
|
||||
var client = server.AlsAngemeldeter(admin.Token);
|
||||
|
||||
var nochmal = await client.PostAsJsonAsync("/api/v1/users",
|
||||
new CreateUserRequest("guido", "wieder-ein-langes-passwort", false));
|
||||
|
||||
Assert.That(nochmal.StatusCode, Is.EqualTo(HttpStatusCode.Conflict));
|
||||
}
|
||||
|
||||
/// <summary>Ein Tippfehler im Pfad fällt sofort auf, nicht erst beim Scan.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// Die häufigste Verwechslung beim Einrichten im Container: der Pfad auf
|
||||
/// dem Wirt statt der im Container. Ohne diese Prüfung bliebe die
|
||||
/// Bibliothek dauerhaft leer, und der Grund stünde allenfalls im Protokoll.
|
||||
/// </remarks>
|
||||
[Test]
|
||||
public async Task Eine_Bibliothek_auf_einem_Pfad_den_es_nicht_gibt_wird_abgelehnt()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var admin = await server.SetUpAndSignIn();
|
||||
|
||||
var versuch = await server.AlsAngemeldeter(admin.Token).PostAsJsonAsync("/api/v1/libraries",
|
||||
new CreateLibraryRequest("Filme", "Movies", "/gibt/es/nicht"));
|
||||
|
||||
Assert.That(versuch.StatusCode, Is.EqualTo(HttpStatusCode.BadRequest));
|
||||
Assert.That(await versuch.Content.ReadAsStringAsync(), Does.Contain("eingeh"));
|
||||
}
|
||||
|
||||
[Test]
|
||||
public async Task Eine_Bibliothek_auf_einem_vorhandenen_Pfad_wird_angelegt()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var admin = await server.SetUpAndSignIn();
|
||||
var client = server.AlsAngemeldeter(admin.Token);
|
||||
var pfad = Path.GetTempPath();
|
||||
|
||||
var angelegt = await client.PostAsJsonAsync("/api/v1/libraries",
|
||||
new CreateLibraryRequest("Filme", "movies", pfad));
|
||||
Assert.That(angelegt.StatusCode, Is.EqualTo(HttpStatusCode.Created));
|
||||
|
||||
var alle = await client.GetFromJsonAsync<List<LibraryResponse>>("/api/v1/libraries");
|
||||
Assert.That(alle!.Single().Kind, Is.EqualTo("Movies"));
|
||||
}
|
||||
|
||||
[Test]
|
||||
public async Task Eine_unbekannte_Art_wird_abgelehnt()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var admin = await server.SetUpAndSignIn();
|
||||
|
||||
var versuch = await server.AlsAngemeldeter(admin.Token).PostAsJsonAsync("/api/v1/libraries",
|
||||
new CreateLibraryRequest("Musik", "Music", Path.GetTempPath()));
|
||||
|
||||
Assert.That(versuch.StatusCode, Is.EqualTo(HttpStatusCode.BadRequest));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,71 @@
|
||||
using System.Net;
|
||||
using System.Net.Http.Json;
|
||||
using Halo.Api.Endpoints;
|
||||
|
||||
namespace Halo.Api.Tests;
|
||||
|
||||
public class SetupTests
|
||||
{
|
||||
[Test]
|
||||
public async Task Ein_frischer_Server_verlangt_Einrichtung()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var info = await server.Client.GetFromJsonAsync<SystemInfo>("/api/v1/system/info");
|
||||
Assert.That(info!.NeedsSetup, Is.True);
|
||||
}
|
||||
|
||||
[Test]
|
||||
public async Task Die_Einrichtung_legt_einen_Administrator_an()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var antwort = await server.Client.PostAsJsonAsync("/api/v1/system/setup",
|
||||
new SetupRequest("guido", "ein-langes-passwort"));
|
||||
|
||||
Assert.That(antwort.StatusCode, Is.EqualTo(HttpStatusCode.OK));
|
||||
var benutzer = await antwort.Content.ReadFromJsonAsync<AuthenticatedUser>();
|
||||
Assert.That(benutzer!.UserName, Is.EqualTo("guido"));
|
||||
Assert.That(benutzer.IsAdministrator, Is.True);
|
||||
|
||||
var info = await server.Client.GetFromJsonAsync<SystemInfo>("/api/v1/system/info");
|
||||
Assert.That(info!.NeedsSetup, Is.False);
|
||||
}
|
||||
|
||||
/// <summary>Sonst stünde ein laufender Server dem ersten Fremden offen.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// Der Endpunkt muss ohne Anmeldung erreichbar sein — beim ersten Start
|
||||
/// gibt es ja noch niemanden, der sich anmelden könnte. Genau deshalb muss
|
||||
/// er sich danach selbst verschliessen.
|
||||
/// </remarks>
|
||||
[Test]
|
||||
public async Task Ein_zweites_Mal_Einrichten_wird_abgelehnt()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
await server.SetUpAndSignIn();
|
||||
|
||||
var zweiterVersuch = await server.Client.PostAsJsonAsync("/api/v1/system/setup",
|
||||
new SetupRequest("eindringling", "auch-ein-langes-passwort"));
|
||||
|
||||
Assert.That(zweiterVersuch.StatusCode, Is.EqualTo(HttpStatusCode.Conflict));
|
||||
}
|
||||
|
||||
[Test]
|
||||
public async Task Ein_zu_kurzes_Passwort_wird_abgelehnt()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var antwort = await server.Client.PostAsJsonAsync("/api/v1/system/setup",
|
||||
new SetupRequest("guido", "kurz"));
|
||||
|
||||
Assert.That(antwort.StatusCode, Is.EqualTo(HttpStatusCode.BadRequest));
|
||||
var info = await server.Client.GetFromJsonAsync<SystemInfo>("/api/v1/system/info");
|
||||
Assert.That(info!.NeedsSetup, Is.True, "Ein abgelehnter Versuch darf nichts angelegt haben");
|
||||
}
|
||||
|
||||
[Test]
|
||||
public async Task Die_Gesundheitsfrage_braucht_keine_Anmeldung()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var antwort = await server.Client.GetAsync("/health");
|
||||
Assert.That(antwort.StatusCode, Is.EqualTo(HttpStatusCode.OK));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,137 @@
|
||||
using System.Net;
|
||||
using System.Net.Http.Headers;
|
||||
using System.Net.Http.Json;
|
||||
using Halo.Api.Endpoints;
|
||||
|
||||
namespace Halo.Api.Tests;
|
||||
|
||||
public class SignInTests
|
||||
{
|
||||
[Test]
|
||||
public async Task Mit_richtigem_Passwort_gibt_es_ein_Token()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var anmeldung = await server.SetUpAndSignIn();
|
||||
|
||||
Assert.That(anmeldung.Token, Is.Not.Empty);
|
||||
Assert.That(anmeldung.User.UserName, Is.EqualTo("guido"));
|
||||
}
|
||||
|
||||
[Test]
|
||||
public async Task Mit_falschem_Passwort_gibt_es_keines()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
await server.SetUpAndSignIn();
|
||||
|
||||
var antwort = await server.Client.PostAsJsonAsync("/api/v1/auth/login",
|
||||
new LoginRequest("guido", "falsch-aber-lang", "iPhone", "geraet-1"));
|
||||
|
||||
Assert.That(antwort.StatusCode, Is.EqualTo(HttpStatusCode.Unauthorized));
|
||||
}
|
||||
|
||||
/// <summary>Unbekannter Name und falsches Passwort sind nicht zu unterscheiden.</summary>
|
||||
[Test]
|
||||
public async Task Ein_unbekannter_Name_antwortet_wie_ein_falsches_Passwort()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
await server.SetUpAndSignIn();
|
||||
|
||||
var unbekannt = await server.Client.PostAsJsonAsync("/api/v1/auth/login",
|
||||
new LoginRequest("gibtesnicht", "irgendein-passwort", "iPhone", "geraet-1"));
|
||||
var falsch = await server.Client.PostAsJsonAsync("/api/v1/auth/login",
|
||||
new LoginRequest("guido", "irgendein-passwort", "iPhone", "geraet-1"));
|
||||
|
||||
Assert.That(unbekannt.StatusCode, Is.EqualTo(falsch.StatusCode));
|
||||
|
||||
// Nur die Begründung vergleichen, nicht den ganzen Körper: darin steht
|
||||
// je Anfrage eine neue Ablaufkennung, die nichts über das Konto sagt.
|
||||
static async Task<string?> Begründung(HttpResponseMessage antwort) =>
|
||||
(await antwort.Content.ReadFromJsonAsync<System.Text.Json.JsonDocument>())!
|
||||
.RootElement.GetProperty("detail").GetString();
|
||||
|
||||
Assert.That(await Begründung(unbekannt), Is.EqualTo(await Begründung(falsch)));
|
||||
}
|
||||
|
||||
[Test]
|
||||
public async Task Mit_Token_beantwortet_der_Server_wer_man_ist()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var anmeldung = await server.SetUpAndSignIn();
|
||||
|
||||
var ich = await server.AlsAngemeldeter(anmeldung.Token)
|
||||
.GetFromJsonAsync<AuthenticatedUser>("/api/v1/auth/me");
|
||||
|
||||
Assert.That(ich!.Id, Is.EqualTo(anmeldung.User.Id));
|
||||
Assert.That(ich.IsAdministrator, Is.True);
|
||||
}
|
||||
|
||||
[Test]
|
||||
public async Task Ohne_Token_antwortet_er_nicht()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
await server.SetUpAndSignIn();
|
||||
|
||||
var antwort = await server.Client.GetAsync("/api/v1/auth/me");
|
||||
Assert.That(antwort.StatusCode, Is.EqualTo(HttpStatusCode.Unauthorized));
|
||||
}
|
||||
|
||||
[Test]
|
||||
public async Task Ein_erfundenes_Token_gilt_nicht()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
await server.SetUpAndSignIn();
|
||||
|
||||
var antwort = await server.AlsAngemeldeter("ausgedacht-aber-lang-genug").GetAsync("/api/v1/auth/me");
|
||||
Assert.That(antwort.StatusCode, Is.EqualTo(HttpStatusCode.Unauthorized));
|
||||
}
|
||||
|
||||
/// <summary>Nach dem Abmelden gilt das Token sofort nicht mehr.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// Der Grund, warum hier keine JWT stehen: ein signiertes Token gälte bis
|
||||
/// zum Ablauf weiter, und für ein verlorenes Telefon ist das der falsche
|
||||
/// Satz.
|
||||
/// </remarks>
|
||||
[Test]
|
||||
public async Task Abmelden_entwertet_das_Token_augenblicklich()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var anmeldung = await server.SetUpAndSignIn();
|
||||
var client = server.AlsAngemeldeter(anmeldung.Token);
|
||||
|
||||
(await client.PostAsync("/api/v1/auth/logout", null)).EnsureSuccessStatusCode();
|
||||
|
||||
var danach = await client.GetAsync("/api/v1/auth/me");
|
||||
Assert.That(danach.StatusCode, Is.EqualTo(HttpStatusCode.Unauthorized));
|
||||
}
|
||||
|
||||
/// <summary>Dasselbe Gerät ersetzt seinen Eintrag, statt einen zweiten anzulegen.</summary>
|
||||
[Test]
|
||||
public async Task Eine_erneute_Anmeldung_desselben_Geraets_entwertet_das_alte_Token()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var erste = await server.SetUpAndSignIn();
|
||||
var zweite = await server.SignIn("guido", "ein-langes-passwort", "iPhone", "geraet-1");
|
||||
|
||||
Assert.That(zweite.Token, Is.Not.EqualTo(erste.Token));
|
||||
var mitAltem = await server.AlsAngemeldeter(erste.Token).GetAsync("/api/v1/auth/me");
|
||||
Assert.That(mitAltem.StatusCode, Is.EqualTo(HttpStatusCode.Unauthorized));
|
||||
var mitNeuem = await server.AlsAngemeldeter(zweite.Token).GetAsync("/api/v1/auth/me");
|
||||
Assert.That(mitNeuem.StatusCode, Is.EqualTo(HttpStatusCode.OK));
|
||||
}
|
||||
|
||||
/// <summary>Ein zweites Gerät meldet das erste nicht ab.</summary>
|
||||
[Test]
|
||||
public async Task Ein_anderes_Geraet_laesst_das_erste_in_Ruhe()
|
||||
{
|
||||
using var server = new HaloServer();
|
||||
var telefon = await server.SetUpAndSignIn();
|
||||
var fernseher = await server.SignIn("guido", "ein-langes-passwort", "Apple TV", "geraet-2");
|
||||
|
||||
foreach (var token in new[] { telefon.Token, fernseher.Token })
|
||||
{
|
||||
var antwort = await server.AlsAngemeldeter(token).GetAsync("/api/v1/auth/me");
|
||||
Assert.That(antwort.StatusCode, Is.EqualTo(HttpStatusCode.OK));
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,118 @@
|
||||
using Halo.Core.Auth;
|
||||
|
||||
namespace Halo.Core.Tests;
|
||||
|
||||
public class SecretsTests
|
||||
{
|
||||
[Test]
|
||||
public void Zwei_Geheimnisse_sind_nie_gleich()
|
||||
{
|
||||
var gesehen = new HashSet<string>();
|
||||
for (var i = 0; i < 200; i++) Assert.That(gesehen.Add(Secrets.Create()), Is.True);
|
||||
}
|
||||
|
||||
[Test]
|
||||
public void Das_Geheimnis_ist_URL_sicher()
|
||||
{
|
||||
for (var i = 0; i < 50; i++)
|
||||
{
|
||||
var s = Secrets.Create();
|
||||
Assert.That(s, Does.Not.Contain("+").And.Not.Contain("/").And.Not.Contain("="));
|
||||
}
|
||||
}
|
||||
|
||||
[Test]
|
||||
public void Der_Fingerabdruck_ist_gleichbleibend_und_unterscheidet()
|
||||
{
|
||||
var a = Secrets.Create();
|
||||
var b = Secrets.Create();
|
||||
// Zweimal gerechnet, nicht zweimal derselbe Ausdruck: geprüft wird,
|
||||
// dass die Funktion bei gleicher Eingabe gleich antwortet.
|
||||
var ersterLauf = Secrets.Fingerprint(a);
|
||||
var zweiterLauf = Secrets.Fingerprint(a);
|
||||
Assert.That(zweiterLauf, Is.EqualTo(ersterLauf));
|
||||
Assert.That(Secrets.Fingerprint(b), Is.Not.EqualTo(ersterLauf));
|
||||
Assert.That(ersterLauf, Has.Length.EqualTo(64));
|
||||
}
|
||||
|
||||
/// <summary>Der Fingerabdruck darf das Geheimnis nicht enthalten.</summary>
|
||||
[Test]
|
||||
public void Der_Fingerabdruck_verraet_das_Geheimnis_nicht()
|
||||
{
|
||||
var s = Secrets.Create();
|
||||
Assert.That(Secrets.Fingerprint(s), Does.Not.Contain(s));
|
||||
}
|
||||
}
|
||||
|
||||
public class AuthCodeTests
|
||||
{
|
||||
private static readonly DateTimeOffset Jetzt = new(2026, 10, 3, 12, 0, 0, TimeSpan.Zero);
|
||||
|
||||
private static AuthCode Angelegt(DateTimeOffset? läuftAb = null) => new()
|
||||
{
|
||||
Code = AuthCode.NewCode(),
|
||||
HandleFingerprint = Secrets.Fingerprint(Secrets.Create()),
|
||||
DeviceName = "Wohnzimmer",
|
||||
DeviceId = "tv-1",
|
||||
CreatedAt = Jetzt,
|
||||
ExpiresAt = läuftAb ?? Jetzt + AuthCode.Lifetime,
|
||||
};
|
||||
|
||||
[Test]
|
||||
public void Der_Code_hat_immer_sechs_Ziffern()
|
||||
{
|
||||
for (var i = 0; i < 500; i++)
|
||||
{
|
||||
var code = AuthCode.NewCode();
|
||||
Assert.That(code, Has.Length.EqualTo(6));
|
||||
Assert.That(code, Does.Match("^[0-9]{6}$"));
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>Führende Nullen dürfen nicht wegfallen — „000123" ist ein gültiger Code.</summary>
|
||||
[Test]
|
||||
public void Fuehrende_Nullen_bleiben_erhalten()
|
||||
{
|
||||
var mitNull = Enumerable.Range(0, 20_000).Select(_ => AuthCode.NewCode()).Any(c => c[0] == '0');
|
||||
Assert.That(mitNull, Is.True, "In 20 000 Ziehungen kam kein Code mit führender Null vor");
|
||||
}
|
||||
|
||||
[Test]
|
||||
public void Ohne_Bestaetigung_gibt_es_kein_Token()
|
||||
{
|
||||
Assert.That(Angelegt().CanBeRedeemed(Jetzt), Is.False);
|
||||
}
|
||||
|
||||
[Test]
|
||||
public void Nach_Bestaetigung_gibt_es_ein_Token()
|
||||
{
|
||||
var code = Angelegt();
|
||||
code.ApprovedByUserId = Guid.CreateVersion7();
|
||||
Assert.That(code.CanBeRedeemed(Jetzt), Is.True);
|
||||
}
|
||||
|
||||
/// <summary>Einmal abgeholt ist abgeholt.</summary>
|
||||
[Test]
|
||||
public void Ein_verbrauchter_Code_gibt_kein_zweites_Token()
|
||||
{
|
||||
var code = Angelegt();
|
||||
code.ApprovedByUserId = Guid.CreateVersion7();
|
||||
code.ConsumedAt = Jetzt;
|
||||
Assert.That(code.CanBeRedeemed(Jetzt), Is.False);
|
||||
}
|
||||
|
||||
[Test]
|
||||
public void Ein_abgelaufener_Code_gibt_kein_Token_auch_wenn_bestaetigt()
|
||||
{
|
||||
var code = Angelegt(läuftAb: Jetzt);
|
||||
code.ApprovedByUserId = Guid.CreateVersion7();
|
||||
Assert.That(code.IsExpired(Jetzt), Is.True);
|
||||
Assert.That(code.CanBeRedeemed(Jetzt), Is.False);
|
||||
}
|
||||
|
||||
[Test]
|
||||
public void Die_Gueltigkeit_ist_kurz()
|
||||
{
|
||||
Assert.That(AuthCode.Lifetime, Is.LessThanOrEqualTo(TimeSpan.FromMinutes(10)));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,27 @@
|
||||
<Project Sdk="Microsoft.NET.Sdk">
|
||||
|
||||
<PropertyGroup>
|
||||
<TargetFramework>net10.0</TargetFramework>
|
||||
<LangVersion>latest</LangVersion>
|
||||
<ImplicitUsings>enable</ImplicitUsings>
|
||||
<Nullable>enable</Nullable>
|
||||
<IsPackable>false</IsPackable>
|
||||
</PropertyGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<PackageReference Include="coverlet.collector" Version="6.0.4" />
|
||||
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.14.0" />
|
||||
<PackageReference Include="NUnit" Version="4.3.2" />
|
||||
<PackageReference Include="NUnit.Analyzers" Version="4.7.0" />
|
||||
<PackageReference Include="NUnit3TestAdapter" Version="5.0.0" />
|
||||
</ItemGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<Using Include="NUnit.Framework" />
|
||||
</ItemGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<ProjectReference Include="..\..\src\Halo.Core\Halo.Core.csproj" />
|
||||
</ItemGroup>
|
||||
|
||||
</Project>
|
||||
@@ -0,0 +1,72 @@
|
||||
using Halo.Core.Users;
|
||||
|
||||
namespace Halo.Core.Tests;
|
||||
|
||||
public class PasswordHasherTests
|
||||
{
|
||||
[Test]
|
||||
public void Richtiges_Passwort_wird_angenommen()
|
||||
{
|
||||
var hash = PasswordHasher.Hash("geheim-und-lang");
|
||||
Assert.That(PasswordHasher.Verify("geheim-und-lang", hash), Is.True);
|
||||
}
|
||||
|
||||
[Test]
|
||||
public void Falsches_Passwort_wird_abgelehnt()
|
||||
{
|
||||
var hash = PasswordHasher.Hash("geheim-und-lang");
|
||||
Assert.That(PasswordHasher.Verify("geheim-und-kurz", hash), Is.False);
|
||||
}
|
||||
|
||||
/// <summary>Gleiches Passwort, zwei Hashes — sonst wäre das Salz wirkungslos.</summary>
|
||||
///
|
||||
/// <remarks>
|
||||
/// Ohne diese Eigenschaft verrät die Datenbank, welche Konten dasselbe
|
||||
/// Passwort benutzen, und eine einmal gebaute Tabelle knackt alle auf
|
||||
/// einen Schlag.
|
||||
/// </remarks>
|
||||
[Test]
|
||||
public void Zweimal_dasselbe_Passwort_ergibt_zwei_verschiedene_Hashes()
|
||||
{
|
||||
var a = PasswordHasher.Hash("dasselbe");
|
||||
var b = PasswordHasher.Hash("dasselbe");
|
||||
Assert.That(a, Is.Not.EqualTo(b));
|
||||
Assert.That(PasswordHasher.Verify("dasselbe", a), Is.True);
|
||||
Assert.That(PasswordHasher.Verify("dasselbe", b), Is.True);
|
||||
}
|
||||
|
||||
[Test]
|
||||
public void Der_Hash_nennt_seine_Kennwerte()
|
||||
{
|
||||
var hash = PasswordHasher.Hash("egal");
|
||||
Assert.That(hash, Does.StartWith("$argon2id$v=19$m=19456,t=2,p=1$"));
|
||||
}
|
||||
|
||||
/// <summary>Eine beschädigte Zeile lehnt ab, statt den Server umzuwerfen.</summary>
|
||||
[TestCase("")]
|
||||
[TestCase("kein-hash")]
|
||||
[TestCase("$argon2id$v=19$m=19456,t=2,p=1$nur-vier-teile")]
|
||||
[TestCase("$bcrypt$v=19$m=19456,t=2,p=1$c2FsenNhbHo$aGFzaA")]
|
||||
[TestCase("$argon2id$v=19$m=x,t=2,p=1$c2FsenNhbHo$aGFzaA")]
|
||||
[TestCase("$argon2id$v=19$m=19456,t=2,p=1$!!!kein-base64!!!$aGFzaA")]
|
||||
public void Unlesbarer_Hash_wirft_nicht_sondern_lehnt_ab(string kaputt)
|
||||
{
|
||||
Assert.That(PasswordHasher.Verify("egal", kaputt), Is.False);
|
||||
}
|
||||
|
||||
[Test]
|
||||
public void Leeres_Passwort_wird_abgelehnt_statt_gehasht()
|
||||
{
|
||||
Assert.Throws<ArgumentException>(() => PasswordHasher.Hash(""));
|
||||
Assert.That(PasswordHasher.Verify("", PasswordHasher.Hash("echt")), Is.False);
|
||||
}
|
||||
|
||||
/// <summary>Alte, schwächere Hashes sollen beim nächsten Anmelden auffallen.</summary>
|
||||
[Test]
|
||||
public void Schwaechere_Kennwerte_verlangen_ein_Neuhashen()
|
||||
{
|
||||
Assert.That(PasswordHasher.NeedsRehash("$argon2id$v=19$m=4096,t=1,p=1$c2FsenNhbHo$aGFzaA"), Is.True);
|
||||
Assert.That(PasswordHasher.NeedsRehash("$2a$10$irgendwas"), Is.True);
|
||||
Assert.That(PasswordHasher.NeedsRehash(PasswordHasher.Hash("aktuell")), Is.False);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user