feat(releases): Zugangsschutz ueber Lizenzschluessel

/releases/ wurde bisher offen ausgeliefert, damit ausgelieferte Anwendungen
ohne Zugangsdaten nach Updates suchen koennen. Das bedeutete aber auch, dass
jeder im Internet die vollstaendigen Pakete herunterladen konnte - mitsamt
allem, was versehentlich darin liegt. Genau so lag ein echter API-Schluessel
in einer mitgelieferten appsettings.json oeffentlich abrufbar.

Zugang haengt jetzt am Lizenzschluessel: Wer eine gueltige Lizenz fuer ein
Produkt hat, kommt an dessen Updates. Die Anwendung kennt ihren Schluessel
ohnehin und versorgt sich damit selbst - es muss nichts verteilt werden.

Server
- ReleaseGuard erzeugt je Produktverzeichnis .htaccess und .htpasswd.
  Bewusst getrennt: eine gemeinsame Datei wuerde bedeuten, dass eine Lizenz
  fuer Produkt A auch Produkt B oeffnet. license_licenses.product_id bindet
  jeden Schluessel ohnehin an genau ein Projekt.
- Eingetragen werden aktive, nicht abgelaufene Lizenzen (Benutzername =
  Passwort = Schluessel; Basic Auth braucht zwei Felder, es gibt aber nur ein
  Geheimnis) sowie alle Installationskonten - bei einer Erstinstallation gibt
  es noch keinen Schluessel, mit dem sich das Paket holen liesse.
- Deren Hash wird unveraendert aus dc_users uebernommen: password_hash()
  erzeugt bcrypt im Format $2y$, genau das versteht Apache. Ein
  Klartextpasswort wird nirgends gebraucht. Argon2-Hashes werden erkannt und
  uebersprungen statt eine unbrauchbare Datei zu erzeugen.
- Lizenzschluessel werden mit Kosten 8 gehasht statt 12: 29 Zeichen
  maschineller Zufall sind kein Menschenpasswort, Apache prueft aber bei
  *jeder* Anfrage neu.
- Geschrieben wird ueber eine temporaere Datei mit rename() - ein Abbruch
  wuerde sonst eine halbe Zugangsdatei hinterlassen und in dem Moment die
  halbe Kundschaft aussperren.
- Neu erzeugt bei jeder Lizenz- und Kontoaenderung. Abgelaufene Lizenzen
  loesen anders als ein Widerruf nichts aus; dafuer gleicht cli/tick.php nach
  und erzeugt spaetestens alle sechs Stunden neu.
- Statusanzeige und Schaltflaeche im WebUI unter UpdateService.

Client
- ReleaseCredentials: Lizenzschluessel oder Installationskonto als Basic Auth.
- UpdateClient und Agent senden sie fuer latest.json und package.tar.gz.
- UpdateCheckResult.Unauthorized trennt "Lizenz traegt nicht mehr" von einem
  Netzwerkfehler. Ohne diese Unterscheidung sucht man an der falschen Stelle.
- LaunchUpdateAgent reicht licenseKey als --license-key durch.
- Der Installer benutzt die beim Anmelden eingegebenen Zugangsdaten auch fuer
  den Paketabruf; das Setup-Token taugt dafuer nicht, weil Apache prueft und
  nicht die Anwendung.

Sonstiges
- deploy.py klammert artifacts/ aus. Ohne das landeten die gebauten
  Installer-Binaries zusaetzlich unter /artifacts/ im Webroot.

ACHTUNG Reihenfolge: Der Schutz sperrt jede Anwendung aus, die noch mit dem
alten SDK gebaut ist. Erst ausliefern, dann scharfschalten - siehe
UPGRADE.md §16.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Deploymentcenter Bot
2026-08-13 11:21:49 +02:00
co-authored by Claude Opus 5
parent 7f41372e5f
commit ceb977187e
11 changed files with 1035 additions and 7 deletions
@@ -0,0 +1,93 @@
using System;
using System.Net.Http;
using System.Text;
namespace Deploymentcenter.Client
{
/// <summary>
/// Zugangsdaten fuer die Release-Ablage.
///
/// Die Verzeichnisse unter /releases/ liegen hinter HTTP-Basic-Auth. Wer
/// herunterladen darf, entscheidet der Lizenzschluessel: Eine Anwendung
/// mit gueltiger Lizenz versorgt sich damit selbst weiter, ohne dass
/// zusaetzliche Geheimnisse verteilt werden muessten. Zuvor war die Ablage
/// offen - und damit auch fuer jeden im Internet herunterladbar.
///
/// Bei einer Erstinstallation gibt es noch keinen Schluessel; dort treten
/// die Zugangsdaten des Installationskontos an seine Stelle.
/// </summary>
public sealed class ReleaseCredentials
{
private ReleaseCredentials(string user, string password)
{
User = user;
Password = password;
}
public string User { get; }
public string Password { get; }
/// <summary>
/// Zugang ueber den Lizenzschluessel.
///
/// Benutzername und Passwort sind beide der Schluessel: Basic Auth
/// verlangt zwei Felder, es gibt aber nur ein Geheimnis, und
/// Benutzernamen muessen innerhalb einer .htpasswd eindeutig sein.
/// </summary>
public static ReleaseCredentials? FromLicenseKey(string? licenseKey)
{
string key = (licenseKey ?? string.Empty).Trim();
return key.Length == 0 ? null : new ReleaseCredentials(key, key);
}
/// <summary>Zugang ueber ein Installationskonto.</summary>
public static ReleaseCredentials? FromUser(string? user, string? password)
{
string u = (user ?? string.Empty).Trim();
string p = password ?? string.Empty;
return u.Length == 0 ? null : new ReleaseCredentials(u, p);
}
/// <summary>Wert fuer den Authorization-Header.</summary>
public string ToHeaderValue()
{
string raw = User + ":" + Password;
return "Basic " + Convert.ToBase64String(Encoding.UTF8.GetBytes(raw));
}
/// <summary>
/// Haengt den Header an eine Anfrage. Ohne Zugangsdaten passiert
/// nichts - eine noch ungeschuetzte Ablage bleibt damit erreichbar.
/// </summary>
public static void Apply(HttpRequestMessage request, ReleaseCredentials? credentials)
{
if (credentials == null || request == null)
return;
// Nicht doppelt setzen, falls der Aufrufer schon etwas mitgibt.
if (request.Headers.Contains("Authorization"))
return;
request.Headers.TryAddWithoutValidation("Authorization", credentials.ToHeaderValue());
}
/// <summary>
/// Erklaerung fuer den Menschen davor, wenn der Server 401 antwortet.
/// Ohne diesen Hinweis sieht ein abgelaufener Vertrag aus wie ein
/// Netzwerkfehler, und man sucht an der falschen Stelle.
/// </summary>
public static string DescribeUnauthorized(ReleaseCredentials? credentials)
{
if (credentials == null)
{
return "Die Release-Ablage verlangt Zugangsdaten, es wurden aber keine mitgegeben. "
+ "Erwartet wird der Lizenzschluessel dieser Installation.";
}
return "Die Release-Ablage hat die Zugangsdaten abgelehnt. Moegliche Gruende: die Lizenz "
+ "ist abgelaufen, wurde widerrufen oder gehoert zu einem anderen Produkt.";
}
}
}