Scarriffle/Flaro
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Halo-Server, Stufe 1: Benutzer, Anmeldung, Einrichtung

Browse Source 
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
2026-10-03 12:13:47 +02:00
co-authored by Claude Opus 5
parent 4b9a1e7b67
commit 156c740330
46 changed files with 3830 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
server/src/Halo.Api/Auth/TokenAuthentication.cs
+79
View File
@@ -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 &lt;token&gt;</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";
}
server/src/Halo.Api/Endpoints/AuthEndpoints.cs
+190
View File
@@ -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];
}
}
server/src/Halo.Api/Endpoints/Contracts.cs
+33
View File
@@ -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);
server/src/Halo.Api/Endpoints/ManagementEndpoints.cs
+94
View File
@@ -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";
}
server/src/Halo.Api/Endpoints/SystemEndpoints.cs
+61
View File
@@ -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();
}
}
server/src/Halo.Api/Halo.Api.csproj
+21
View File
@@ -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>
server/src/Halo.Api/HaloPaths.cs
+110
View File
@@ -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();
}
}
server/src/Halo.Api/Program.cs
+84
View File
@@ -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;
server/src/Halo.Api/Properties/launchSettings.json
+23
View File
@@ -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"
}
}
}
}
server/src/Halo.Api/appsettings.Development.json
+8
View File
@@ -0,0 +1,8 @@
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
}
}
server/src/Halo.Api/appsettings.json
+9
View File
@@ -0,0 +1,9 @@
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
},
"AllowedHosts": "*"
}
server/src/Halo.Core/Auth/AuthCode.cs
+58
View File
@@ -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);
}
server/src/Halo.Core/Auth/DeviceToken.cs
+33
View File
@@ -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;
}
server/src/Halo.Core/Auth/Secrets.cs
+32
View File
@@ -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('/', '_');
}
server/src/Halo.Core/Halo.Core.csproj
+13
View File
@@ -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>
server/src/Halo.Core/Libraries/Library.cs
+20
View File
@@ -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;
}
server/src/Halo.Core/Settings.cs
+15
View File
@@ -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; }
}
server/src/Halo.Core/Users/PasswordHasher.cs
+116
View File
@@ -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, '=');
}
server/src/Halo.Core/Users/User.cs
+23
View File
@@ -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;
}
server/src/Halo.Data/Converters.cs
+30
View File
@@ -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 &gt; 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));
server/src/Halo.Data/Halo.Data.csproj
+21
View File
@@ -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>
server/src/Halo.Data/HaloContext.cs
+94
View File
@@ -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);
});
}
}
server/src/Halo.Data/Migrations/20261003095500_Initial.Designer.cs
Generated
+201
View File
@@ -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
}
}
}
server/src/Halo.Data/Migrations/20261003095500_Initial.cs
+147
View File
@@ -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");
}
}
}
server/src/Halo.Data/Migrations/HaloContextModelSnapshot.cs
+198
View File
@@ -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
}
}
}