Files
Flaro/server/tests/Halo.Api.Tests/CodeSignInTests.cs
T
ScarriffleandClaude Opus 5 156c740330 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>
2026-10-03 12:13:47 +02:00

138 lines
5.9 KiB
C#

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"));
}
}