S7: Zugangsdaten in Konfigurationsdateien verschluesseln

OpenRouter-Schluessel, Datenbank-Verbindungszeichenfolgen samt Passwort,
Mail-Zugangsdaten und das Telegram-2FA-Passwort lagen im Klartext in
AgentSettings.json und InstanceSettings.json. Wer die Dateien lesen konnte — ein
Backup, eine Dateifreigabe, ein versehentlicher Commit — hatte alle Zugaenge.

SecretProtector nutzt DPAPI im Benutzerkontext: Die Werte lassen sich nur vom
selben Windows-Benutzer auf demselben Rechner lesen. Das schuetzt gegen
Weitergabe der Datei, nicht gegen einen Angreifer, der bereits als dieser
Benutzer laeuft — fuer einen lokal laufenden Dienst die angemessene Stufe.

Verschluesselte Werte tragen ein Praefix. Dadurch bleibt Klartext aus bestehenden
Konfigurationen lesbar und wird beim naechsten Speichern automatisch uebernommen;
vorhandene Installationen laufen ohne Zutun weiter.

Ein Wert, der sich nicht entschluesseln laesst — etwa nach Benutzer- oder
Rechnerwechsel — wird gemeldet statt stillschweigend als Klartext
durchgereicht. Sonst ginge ein unbrauchbarer Schluessel an die API und der
Fehler waere schwer zuzuordnen.

ConfigSecrets entscheidet anhand der Feldnamen, welche Werte betroffen sind. Das
ist noetig, weil die Tool-Konfiguration ein freies Woerterbuch ist. Beim Speichern
werden die Werte nur fuer den Schreibvorgang verschluesselt und danach wieder
entschluesselt, damit die laufende Instanz weiterarbeiten kann.

309 Tests gruen (161 Core, 148 Tools).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

src/ClawdDotNet.Core/ClawdDotNet.Core.csproj

@@ -13,6 +13,7 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.Data.Sqlite" Version="10.0.8" />
+    <PackageReference Include="System.Security.Cryptography.ProtectedData" Version="10.0.0" />
     <PackageReference Include="Microsoft.Extensions.Logging" Version="10.0.8" />
     <PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.8" />
   </ItemGroup>

src/ClawdDotNet.Core/Config/ConfigLoader.cs

@@ -21,6 +21,9 @@ public static class ConfigLoader
             ?? throw new InvalidOperationException($"Config file is empty or invalid: {filePath}");
 
         Migrate(config);
+        // Verschlüsselte Zugangsdaten für die Laufzeit lesbar machen. Klartext aus
+        // älteren Konfigurationen bleibt unverändert und wird beim Speichern übernommen.
+        Security.ConfigSecrets.Unprotect(config);
         Validate(config, filePath);
         return config;
     }

src/ClawdDotNet.Core/Security/ConfigSecrets.cs

@@ -0,0 +1,86 @@
+using System.Text.Json;
+using ClawdDotNet.Core.Config;
+
+namespace ClawdDotNet.Core.Security;
+
+/// <summary>
+/// Weiß, welche Felder einer Konfiguration Zugangsdaten enthalten, und wendet den
+/// <see cref="SecretProtector"/> darauf an.
+///
+/// Beide Richtungen sind gefahrlos mehrfach anwendbar: Schützen überspringt bereits
+/// geschützte Werte, Entschlüsseln gibt Klartext unverändert zurück. Dadurch werden
+/// bestehende Konfigurationen beim ersten Speichern automatisch übernommen.
+/// </summary>
+public static class ConfigSecrets
+{
+    /// <summary>
+    /// Schlüsselnamen in Tool-Konfigurationen, deren Werte als Zugangsdaten gelten.
+    /// Die Tool-Konfiguration ist ein freies Wörterbuch — deshalb wird hier nach
+    /// Namen entschieden.
+    /// </summary>
+    private static readonly HashSet<string> SecretKeys = new(StringComparer.OrdinalIgnoreCase)
+    {
+        "password", "password2fa", "passwort",
+        "apikey", "api_key", "xapikey", "openrouterapikey", "apihash", "apisecret",
+        "token", "accesstoken", "bottoken", "authtoken",
+        "secret", "clientsecret",
+        "connectionstring"
+    };
+
+    public static bool IsSecretKey(string key) => SecretKeys.Contains(key);
+
+    // ─── Instanz ───
+
+    public static void Protect(InstanceConfig config) => Apply(config, SecretProtector.Protect);
+
+    public static void Unprotect(InstanceConfig config) => Apply(config, SecretProtector.Unprotect);
+
+    private static void Apply(InstanceConfig config, Func<string?, string?> transform)
+    {
+        config.OpenRouterApiKey = transform(config.OpenRouterApiKey) ?? "";
+
+        if (config.TelegramClient is { } telegram)
+        {
+            telegram.ApiHash = transform(telegram.ApiHash) ?? "";
+            telegram.Password2FA = transform(telegram.Password2FA);
+        }
+
+        foreach (var agent in config.Agents)
+            Apply(agent, transform);
+    }
+
+    // ─── Agent ───
+
+    public static void Protect(AgentConfig agent) => Apply(agent, SecretProtector.Protect);
+
+    public static void Unprotect(AgentConfig agent) => Apply(agent, SecretProtector.Unprotect);
+
+    private static void Apply(AgentConfig agent, Func<string?, string?> transform)
+    {
+        foreach (var tool in agent.Tools.Values)
+        {
+            foreach (var key in tool.Keys.ToList())
+            {
+                if (!IsSecretKey(key))
+                    continue;
+
+                if (ReadString(tool[key]) is not { } current || current.Length == 0)
+                    continue;
+
+                tool[key] = transform(current);
+            }
+        }
+    }
+
+    /// <summary>
+    /// Liest einen Zeichenkettenwert. Nach dem Deserialisieren stecken die Werte als
+    /// JsonElement im Wörterbuch, nach einer Bearbeitung als einfache Zeichenkette.
+    /// </summary>
+    private static string? ReadString(object? value) => value switch
+    {
+        null => null,
+        string s => s,
+        JsonElement { ValueKind: JsonValueKind.String } je => je.GetString(),
+        _ => null
+    };
+}

src/ClawdDotNet.Core/Security/SecretProtector.cs

@@ -0,0 +1,98 @@
+using System.Runtime.Versioning;
+using System.Security.Cryptography;
+using System.Text;
+
+namespace ClawdDotNet.Core.Security;
+
+/// <summary>
+/// Verschlüsselt Zugangsdaten in Konfigurationsdateien.
+///
+/// Hintergrund (S7): OpenRouter-Schlüssel, Datenbank-Verbindungszeichenfolgen samt
+/// Passwort, Mail-Zugangsdaten und das Telegram-2FA-Passwort lagen im Klartext in
+/// AgentSettings.json und InstanceConfig.json. Wer die Dateien lesen konnte — ein
+/// Backup, eine Dateifreigabe, ein versehentlicher Commit — hatte alle Zugänge.
+///
+/// Verwendet wird DPAPI im Benutzerkontext: Die Daten lassen sich nur von demselben
+/// Windows-Benutzer auf demselben Rechner entschlüsseln. Das schützt gegen Weitergabe
+/// der Datei, nicht gegen einen Angreifer, der bereits als dieser Benutzer läuft —
+/// für einen lokal laufenden Dienst ist das die angemessene Stufe.
+///
+/// Verschlüsselte Werte tragen ein Präfix, damit Klartext aus älteren Konfigurationen
+/// weiterhin gelesen und beim nächsten Speichern automatisch übernommen wird.
+/// </summary>
+public static class SecretProtector
+{
+    private const string Prefix = "enc:v1:";
+
+    /// <summary>Zusätzlicher Kontext, damit ein Wert nicht in anderem Zusammenhang wiederverwendbar ist.</summary>
+    private static readonly byte[] Entropy = Encoding.UTF8.GetBytes("ClawdDotNet.Secrets.v1");
+
+    public static bool IsProtected(string? value)
+        => value?.StartsWith(Prefix, StringComparison.Ordinal) == true;
+
+    /// <summary>
+    /// Verschlüsselt einen Wert. Bereits verschlüsselte und leere Werte bleiben unverändert,
+    /// damit die Funktion gefahrlos mehrfach angewendet werden kann.
+    /// </summary>
+    public static string? Protect(string? plainText)
+    {
+        if (string.IsNullOrEmpty(plainText) || IsProtected(plainText))
+            return plainText;
+
+        if (!OperatingSystem.IsWindows())
+            return plainText;
+
+        try
+        {
+            var encrypted = ProtectWindows(Encoding.UTF8.GetBytes(plainText));
+            return Prefix + Convert.ToBase64String(encrypted);
+        }
+        catch (CryptographicException)
+        {
+            // Lieber unverschlüsselt weiterarbeiten als die Konfiguration verlieren.
+            return plainText;
+        }
+    }
+
+    /// <summary>
+    /// Entschlüsselt einen Wert. Klartext aus älteren Konfigurationen wird unverändert
+    /// zurückgegeben — so bleiben bestehende Installationen lauffähig.
+    /// </summary>
+    public static string? Unprotect(string? value)
+    {
+        if (string.IsNullOrEmpty(value) || !IsProtected(value))
+            return value;
+
+        if (!OperatingSystem.IsWindows())
+            return value;
+
+        var payload = value[Prefix.Length..];
+
+        try
+        {
+            var decrypted = UnprotectWindows(Convert.FromBase64String(payload));
+            return Encoding.UTF8.GetString(decrypted);
+        }
+        catch (Exception ex) when (ex is CryptographicException or FormatException)
+        {
+            // Etwa nach Benutzerwechsel oder Rechnerwechsel: Der Wert ist hier nicht
+            // lesbar. Ihn als Klartext auszugeben wäre falsch — dann würde ein
+            // unbrauchbarer Schlüssel an die API gehen.
+            throw new SecretProtectionException(
+                "Ein verschlüsselter Wert konnte nicht gelesen werden. Das passiert, wenn die " +
+                "Konfiguration von einem anderen Windows-Benutzer oder Rechner stammt. " +
+                "Bitte den betroffenen Wert in den Einstellungen neu eintragen.", ex);
+        }
+    }
+
+    [SupportedOSPlatform("windows")]
+    private static byte[] ProtectWindows(byte[] data)
+        => ProtectedData.Protect(data, Entropy, DataProtectionScope.CurrentUser);
+
+    [SupportedOSPlatform("windows")]
+    private static byte[] UnprotectWindows(byte[] data)
+        => ProtectedData.Unprotect(data, Entropy, DataProtectionScope.CurrentUser);
+}
+
+public sealed class SecretProtectionException(string message, Exception inner)
+    : Exception(message, inner);