Files
Flaro/server/tests/Halo.Metadata.Tests/ZugangTests.cs
T
ScarriffleandClaude Opus 5 79b6001f86 Metadaten ohne Einrichtung — mit Lese-Token statt API-Schlüssel
Halo bringt einen TMDB-Zugang mit. Wer den Server startet, bekommt Titel,
Beschreibungen und Plakate, ohne irgendwo ein Konto anzulegen. Am echten
Dienst nachgewiesen: „Der Untergang" (2004) mit deutscher Beschreibung,
„Blade Runner 2049" (2017), Plakate als JPEG aus Halos eigener Ablage.

**Warum überhaupt die Frage stand.** Jellyfin liefert ebenfalls einen
Schlüssel mit — fest im Quellcode, offen im Repository, Konstante `ApiKey` in
`TmdbUtils.cs`. Ein Abkommen mit TMDB dazu liess sich nicht belegen: deren
Bedingungen erwähnen das Teilen von Schlüsseln mit keinem Wort, und die
einzige Äusserung eines Moderators zu genau dieser Frage im TMDB-Forum ging
nicht darauf ein, sondern wies nur darauf hin, dass Missbrauch zur Sperrung
führt. Geduldet also, nicht gesegnet.

Deshalb **mit Ausweg**: wer einen eigenen Zugang hinterlegt, benutzt den. Würde
der mitgelieferte je gesperrt, steht damit nicht jede Installation still.

**Ein Lese-Token, kein API-Schlüssel.** TMDBs eigene Dokumentation bestätigt,
dass er auch an den v3-Endpunkten gilt. Zwei Gründe, und beide zählen bei
einem Zugang, der öffentlich im Repo steht: er kann nur lesen, und er geht als
`Authorization`-Kopfzeile hinaus statt als `?api_key=` in der Adresse — und
eine Adresse steht in jedem Zugriffsprotokoll und jedem Reverse Proxy. Der
ältere Schlüssel wird weiterhin angenommen; er kann nur in die Adresse.

**Der Hinweis auf TMDB ist Bedingung.** Logo und ein fester Satz, so verlangt
es deren Lizenz. `system/info` liefert beides ohne Anmeldung, damit ein Client
es auch auf dem Anmeldebildschirm zeigen kann. Das fehlte bisher.

---

**Zwei Funde, beide nur durch einen echten Lauf sichtbar:**

*„Dark" wurde zu „Dark Shadows" von 1966.* TMDB sortiert nach Beliebtheit, und
ohne Jahresangabe führt das in die Irre. Jetzt sticht ein Treffer mit genau
diesem Namen den beliebteren — danach: „Dark" (2017), deutsche Beschreibung,
Folgentitel „Geheimnisse" und „Lügen". Nur bei Gleichheit, nicht bei
Ähnlichkeit: eine eigene Bewertung wäre TMDBs Rangfolge nachgebaut, mit
weniger Daten.

*Die Tests griffen plötzlich übers Netz zu.* Sobald ein Schlüssel mitgeliefert
wird, fragt jeder Scan wirklich bei TMDB nach — und prompt hiess „Der
Untergang" im Test „Downfall", weil die Voreinstellung Englisch ist. Genau
das, was ein Testwerk nicht tun darf: am WLAN hängen und an fremden Daten.
Der Anbieter ist jetzt für alle Tests abgeschaltet, ausser ein Test schiebt
ausdrücklich einen eigenen nach.

238 Tests grün, keiner davon geht ins Netz.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-10-03 17:52:48 +02:00

126 lines
4.7 KiB
C#

using Microsoft.Extensions.Logging.Abstractions;
namespace Halo.Metadata.Tests;
/// <summary>Womit sich Halo bei TMDB ausweist.</summary>
public class ZugangTests
{
private const string LeseToken = "eyJhbGciOiJIUzI1NiJ9.beispiel.unterschrift";
private const string AelterSchluessel = "0123456789abcdef0123456789abcdef";
private static (TmdbClient Client, Attrappe Attrappe) Mit(string zugang)
{
var attrappe = Attrappe.MitJson("""{"results":[{"id":1,"title":"Egal"}]}""");
return (new TmdbClient(
new HttpClient(attrappe) { BaseAddress = new Uri(TmdbClient.BaseAddress) },
new FesteEinstellungen(new TmdbSettings(zugang, "de-DE")),
NullLogger<TmdbClient>.Instance), attrappe);
}
/// <summary>Ein Lese-Token gehört in die Kopfzeile, nicht in die Adresse.</summary>
///
/// <remarks>
/// <b>Eine Adresse steht in jedem Zugriffsprotokoll.</b> In jedem Reverse
/// Proxy, in jeder Fehlermeldung, die eine URL zitiert. Eine Kopfzeile tut
/// das nicht — und bei einem Schlüssel, der in einem offenen Projekt
/// mitgeliefert wird, zählt jede Stelle, an der er nicht auftaucht.
/// </remarks>
[Test]
public async Task Der_Lese_Token_geht_als_Bearer_und_nicht_in_die_Adresse()
{
var (client, attrappe) = Mit(LeseToken);
await client.FindMovieAsync("Egal", null);
Assert.That(attrappe.Kopfzeilen.Single(), Is.EqualTo($"Bearer {LeseToken}"));
Assert.That(attrappe.Aufrufe.Single(), Does.Not.Contain("api_key"));
Assert.That(attrappe.Aufrufe.Single(), Does.Not.Contain(LeseToken));
}
/// <summary>Der ältere Schlüssel kann nur in die Adresse — also tut er das.</summary>
[Test]
public async Task Der_aeltere_Schluessel_geht_weiterhin_als_Abfrageteil()
{
var (client, attrappe) = Mit(AelterSchluessel);
await client.FindMovieAsync("Egal", null);
Assert.That(attrappe.Kopfzeilen.Single(), Is.Null);
Assert.That(attrappe.Aufrufe.Single(), Does.Contain($"api_key={AelterSchluessel}"));
}
[Test]
public async Task Auch_bei_Folgen_wird_der_Bearer_mitgeschickt()
{
var (client, attrappe) = Mit(LeseToken);
await client.FindEpisodeAsync(70523, 1, 1);
Assert.That(attrappe.Kopfzeilen.Single(), Does.StartWith("Bearer "));
Assert.That(attrappe.Aufrufe.Single(), Does.Not.Contain("api_key"));
}
}
/// <summary>Welcher Schlüssel gilt, wenn mehrere in Frage kommen.</summary>
public class SchluesselwahlTests
{
[Test]
public void Ein_eigener_Schluessel_sticht_den_mitgelieferten()
{
var gewählt = TmdbSettings.Resolve("mein-eigener", "de-DE");
Assert.That(gewählt.ApiKey, Is.EqualTo("mein-eigener"));
Assert.That(gewählt.UsingProjectKey, Is.False);
}
[Test]
public void Ohne_eigenen_greift_der_mitgelieferte()
{
var gewählt = TmdbSettings.Resolve(null, null);
if (TmdbSettings.ProjectApiKey.Length == 0)
{
Assert.That(gewählt.ApiKey, Is.Null, "Ohne mitgelieferten Schlüssel bleibt es dabei");
Assert.That(gewählt.UsingProjectKey, Is.False);
return;
}
Assert.That(gewählt.ApiKey, Is.EqualTo(TmdbSettings.ProjectApiKey));
Assert.That(gewählt.UsingProjectKey, Is.True);
}
[TestCase("")]
[TestCase(" ")]
public void Ein_leerer_eigener_Schluessel_zaehlt_als_keiner(string leer)
{
Assert.That(TmdbSettings.Resolve(leer, null).UsingProjectKey,
Is.EqualTo(TmdbSettings.ProjectApiKey.Length > 0));
}
[Test]
public void Leerraum_um_den_Schluessel_wird_abgeschnitten()
{
Assert.That(TmdbSettings.Resolve(" meiner ", " de-DE ").ApiKey, Is.EqualTo("meiner"));
Assert.That(TmdbSettings.Resolve("meiner", " de-DE ").Language, Is.EqualTo("de-DE"));
}
[Test]
public void Ohne_Sprachangabe_gilt_Englisch()
{
Assert.That(TmdbSettings.Resolve("meiner", null).Language, Is.EqualTo("en-US"));
}
/// <summary>Der mitgelieferte Schlüssel darf nur lesen dürfen.</summary>
///
/// <remarks>
/// Er steht öffentlich im Quellcode. Ein Lese-Token kann nichts ändern —
/// ein älterer API-Schlüssel schon. Diese Prüfung hält fest, dass hier
/// keiner der falschen Art hineingerät.
/// </remarks>
[Test]
public void Der_mitgelieferte_Schluessel_ist_ein_Lese_Token()
{
if (TmdbSettings.ProjectApiKey.Length == 0) Assert.Pass("Kein Schlüssel mitgeliefert.");
Assert.That(TmdbSettings.ProjectApiKey, Does.StartWith("eyJ"),
"Erwartet wird ein API Read Access Token, kein älterer API-Schlüssel");
}
}